---
title: "지원 통화"
description: "Tokenz Checkout이 지원하는 통화와 통화별 금액 형식을 알아봅니다."
source: "https://docs.tokenz.one/ko-KR/v1/checkout/currency"
api_version: "v1"
locale: "ko-KR"
version_status: "legacy"
docs_stage: "prod"
---

# 지원 통화

Tokenz Checkout이 지원하는 통화와 통화별 금액 형식을 알아봅니다.

## 지원 통화 목록

Checkout은 아시아·태평양, 유럽, 북미, 중동, 중남미, 아프리카 및 남아시아의 통화를 지원합니다. 전체 지원 통화 목록은 다음과 같습니다.

### 아시아·태평양 통화

- **AUD** - 호주 달러 ($)
- **CNY** - 중국 위안 (¥)
- **HKD** - 홍콩 달러 ($)
- **IDR**\* - 인도네시아 루피아 (Rp)
- **JPY** - 일본 엔 (¥)
- **KRW** - 대한민국 원 (₩)
- **MYR** - 말레이시아 링깃 (RM)
- **PHP** - 필리핀 페소 (₱)
- **SGD** - 싱가포르 달러 ($)
- **THB** - 태국 바트 (฿)
- **TWD**\* - 신타이완 달러 (NT$)

### 유럽 통화

- **BGN** - 불가리아 레프 (лв)
- **CHF** - 스위스 프랑 (Fr.)
- **CZK** - 체코 코루나 (Kč)
- **DKK** - 덴마크 크로네 (kr)
- **EUR** - 유로 (€)
- **GBP** - 영국 파운드 (£)
- **HUF** - 헝가리 포린트 (Ft)
- **NOK** - 노르웨이 크로네 (kr)
- **PLN** - 폴란드 즈워티 (zł)
- **RON** - 루마니아 레우 (lei)
- **SEK** - 스웨덴 크로나 (kr)

### 북미 통화

- **CAD** - 캐나다 달러 ($)
- **USD** - 미국 달러 ($)

### 중동 통화

- **AED** - 아랍에미리트 디르함 (د.إ)
- **BHD** - 바레인 디나르 (.د.ب)
- **KWD** - 쿠웨이트 디나르 (د.ك)
- **OMR** - 오만 리알 (﷼)
- **QAR** - 카타르 리얄 (ر.ق)
- **SAR** - 사우디아라비아 리얄 (﷼)

### 중남미 통화

- **BRL** - 브라질 헤알 (R$)
- **CLP** - 칠레 페소 ($)
- **COP** - 콜롬비아 페소 ($)
- **MXN** - 멕시코 페소 (Mex$)
- **PEN** - 페루 솔 (S/)

### 아프리카 통화

- **GHS** - 가나 세디 (GH₵)
- **KES** - 케냐 실링 (KSh)
- **MAD** - 모로코 디르함 (DH)

### 남아시아 통화

- **BDT** - 방글라데시 타카 (৳)
- **LKR** - 스리랑카 루피 (௹)
- **PKR** - 파키스탄 루피 (Rs)

### 기타 통화

- **NZD** - 뉴질랜드 달러 ($)
- **TZS** - 탄자니아 실링 (TSh)
- **UGX** - 우간다 실링 (USh)
- **VND** - 베트남 동 (₫)

\* Tokenz는 IDR, TWD를 소수점 없는 통화로 처리합니다. 이는 해당 통화에 소수점 두 자리를 규정하는 ISO 4217과 다릅니다. JPY, KRW, CLP는 Tokenz와 ISO 4217 모두에서 소수점 없는 통화입니다.

## 통화의 최소 단위

Tokenz API에서 금액을 지정할 때는 **대부분의 통화에서 기본 단위 대신 최소 보조 단위**(예: 센트, 파이사)를 사용해야 합니다. 올바른 단위를 사용하면 가격 오류를 방지하고 정확하게 결제를 처리할 수 있습니다.

### 최소 단위 사용 방법

대부분의 통화는 기본 단위 하나를 100개의 보조 단위로 나누는 십진 체계를 사용합니다.

- 1 USD = 100센트
- 1 EUR = 100센트
- 1 GBP = 100펜스

이러한 통화를 API에서 사용할 때는 금액에 100을 곱해야 합니다. 예를 들어 $10.99를 청구하려면 `1099`(10.99 × 100)를 전송합니다.

### 소수점 없는 통화

일부 통화는 소수점을 사용하지 않으며 이미 최소 단위로 표시됩니다. 이를 **소수점 없는 통화**라고 합니다. 이러한 통화는 곱셈 없이 금액을 그대로 지정합니다.

- **CLP** - 칠레 페소
- **IDR** - 인도네시아 루피아
- **JPY** - 일본 엔
- **KRW** - 대한민국 원
- **TWD** - 신타이완 달러
- **UGX** - 우간다 실링
- **VND** - 베트남 동

**참고:** Tokenz API에서 IDR과 TWD는 소수점 없는 통화이지만, ISO 4217에서는 소수점 두 자리를 사용합니다. 아래 참조 표에서 별표(`*`)로 표시됩니다.

### 소수점 세 자리 통화

일부 통화는 일반적인 두 자리 대신 소수점 세 자리를 사용합니다. 이러한 통화는 1000을 곱해야 합니다.

- **BHD** - 바레인 디나르
- **KWD** - 쿠웨이트 디나르
- **OMR** - 오만 리알

예를 들어 10.500 BHD를 청구하려면 `10500`(10.500 × 1000)을 전송합니다.

그 외 모든 지원 통화는 보조 단위를 사용하며 100을 곱해야 합니다.

### 통화별 최소 단위 전체 참조

| 통화 | 코드 | 보조 단위 | 변환 | 예시 |
| --- | --- | --- | --- | --- |
| 아랍에미리트 디르함 | AED | 필스 | ×100 | د.إ10.00 = 1000 |
| 호주 달러 | AUD | 센트 | ×100 | $10.00 = 1000 |
| 방글라데시 타카 | BDT | 파이사 | ×100 | ৳10.00 = 1000 |
| 불가리아 레프 | BGN | 스토틴카 | ×100 | лв10.00 = 1000 |
| 바레인 디나르 | BHD | 필스 | ×1000 | .د.ب10.000 = 10000 |
| 브라질 헤알 | BRL | 센타보 | ×100 | R$10.00 = 1000 |
| 캐나다 달러 | CAD | 센트 | ×100 | $10.00 = 1000 |
| 스위스 프랑 | CHF | 라펜/상팀 | ×100 | Fr.10.00 = 1000 |
| 칠레 페소 | CLP | - | ×1 | $1000 = 1000 |
| 중국 위안 | CNY | 펀 | ×100 | ¥10.00 = 1000 |
| 콜롬비아 페소 | COP | 센타보 | ×100 | $10.00 = 1000 |
| 체코 코루나 | CZK | 할레르 | ×100 | Kč10.00 = 1000 |
| 덴마크 크로네 | DKK | 외레 | ×100 | kr10.00 = 1000 |
| 유로 | EUR | 센트 | ×100 | €10.00 = 1000 |
| 영국 파운드 | GBP | 펜스 | ×100 | £10.00 = 1000 |
| 가나 세디 | GHS | 페세와 | ×100 | GH₵10.00 = 1000 |
| 홍콩 달러 | HKD | 센트 | ×100 | $10.00 = 1000 |
| 헝가리 포린트 | HUF | 필레르 | ×100 | Ft10.00 = 1000 |
| 인도네시아 루피아 | IDR* | - | ×1 | Rp1000 = 1000 |
| 일본 엔 | JPY | - | ×1 | ¥1000 = 1000 |
| 케냐 실링 | KES | 센트 | ×100 | KSh10.00 = 1000 |
| 대한민국 원 | KRW | - | ×1 | ₩1000 = 1000 |
| 쿠웨이트 디나르 | KWD | 필스 | ×1000 | د.ك10.000 = 10000 |
| 스리랑카 루피 | LKR | 센트 | ×100 | ௹10.00 = 1000 |
| 모로코 디르함 | MAD | 상팀 | ×100 | DH10.00 = 1000 |
| 멕시코 페소 | MXN | 센타보 | ×100 | Mex$10.00 = 1000 |
| 말레이시아 링깃 | MYR | 센 | ×100 | RM10.00 = 1000 |
| 노르웨이 크로네 | NOK | 외레 | ×100 | kr10.00 = 1000 |
| 뉴질랜드 달러 | NZD | 센트 | ×100 | $10.00 = 1000 |
| 오만 리알 | OMR | 바이사 | ×1000 | ﷼10.000 = 10000 |
| 페루 솔 | PEN | 센티모 | ×100 | S/10.00 = 1000 |
| 필리핀 페소 | PHP | 센타보 | ×100 | ₱10.00 = 1000 |
| 파키스탄 루피 | PKR | 파이사 | ×100 | Rs10.00 = 1000 |
| 폴란드 즈워티 | PLN | 그로시 | ×100 | zł10.00 = 1000 |
| 카타르 리얄 | QAR | 디르함 | ×100 | ر.ق10.00 = 1000 |
| 루마니아 레우 | RON | 바니 | ×100 | lei10.00 = 1000 |
| 사우디아라비아 리얄 | SAR | 할랄라 | ×100 | ﷼10.00 = 1000 |
| 스웨덴 크로나 | SEK | 외레 | ×100 | kr10.00 = 1000 |
| 싱가포르 달러 | SGD | 센트 | ×100 | $10.00 = 1000 |
| 태국 바트 | THB | 사탕 | ×100 | ฿10.00 = 1000 |
| 신타이완 달러 | TWD* | - | ×1 | NT$1000 = 1000 |
| 탄자니아 실링 | TZS | 센트 | ×100 | TSh10.00 = 1000 |
| 우간다 실링 | UGX | - | ×1 | USh1000 = 1000 |
| 미국 달러 | USD | 센트 | ×100 | $10.00 = 1000 |
| 베트남 동 | VND | - | ×1 | ₫1000 = 1000 |

\* Tokenz는 IDR, TWD를 소수점 없는 통화로 처리합니다. 이는 해당 통화에 소수점 두 자리를 규정하는 ISO 4217과 다릅니다. JPY, KRW, CLP는 Tokenz와 ISO 4217 모두에서 소수점 없는 통화입니다.

### API 형식의 일관성

**중요:** API 요청과 응답은 동일한 최소 단위 형식을 사용합니다. API 응답에서 받는 금액에도 같은 규칙이 적용됩니다.

- **소수점 없는 통화**(CLP, IDR, JPY, KRW, TWD, UGX, VND)는 기본 단위로 반환됩니다.
- **소수점 세 자리 통화**(BHD, KWD, OMR)는 1000을 곱한 값으로 반환됩니다.
- **그 외 모든 통화**는 최소 보조 단위(100을 곱한 값)로 반환됩니다.

따라서 응답 값을 변환하지 않고 후속 API 호출에 그대로 사용할 수 있습니다.

### API 예제

다음 예제는 요청과 응답에서 통화별 금액을 올바르게 지정하는 방법을 보여 줍니다.

소수점 두 자리 통화(USD) - 센트 단위 금액

```json
{
  "price": {
    "currency": "USD",
    "amount": 2499
  }
}
```

소수점 없는 통화(JPY) - 금액 그대로 사용

```json
{
  "price": {
    "currency": "JPY",
    "amount": 5000
  }
}
```

소수점 두 자리 통화(EUR) - 센트 단위 금액

```json
{
  "price": {
    "currency": "EUR",
    "amount": 15050
  }
}
```

소수점 없는 통화(KRW) - 금액 그대로 사용

```json
{
  "price": {
    "currency": "KRW",
    "amount": 50000
  }
}
```

### 주요 참고 사항

1. 잘못된 금액을 청구하지 않도록 결제 처리 전에 **통화 형식을 항상 확인**하세요.
2. **소수점 없는 통화**에는 100을 곱하면 안 됩니다.
3. **소수점 두 자리 통화**는 반드시 최소 보조 단위로 변환해야 합니다.
4. 사용자에게 금액을 표시할 때는 최소 단위에서 표시 형식으로 다시 변환하세요.
5. 일부 결제 수단에는 통화에 따라 다른 최소·최대 결제 금액이 적용될 수 있습니다.