지원 통화

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

지원 통화 목록

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

통화 찾기

지역

전체 45개 중 45개 통화

아시아·태평양 통화

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을 곱해야 합니다.

통화별 최소 단위 전체 참조

×1소수점 없음 · 금액 그대로 사용

×100소수점 두 자리 · 100을 곱함

×1000소수점 세 자리 · 1,000을 곱함

통화 찾기

전체 45개 중 45개 통화

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

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
  }
}

주요 참고 사항

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