도구스개발

ISO 4217 통화코드 조회

통화명이나 알파벳코드·숫자코드로 ISO 4217 통화코드와 소수점 자릿수(minor unit)를 조회합니다.

알파벳코드·숫자코드·영문 이름 아무 걸로나 찾을 수 있습니다.

KRW Won

numeric

410

소수점 자릿수

0자리

결제 API 최소 단위(amount)1,000
등록된 통화155개
많은 결제 API(스트라이프 등)는 금액을 소수점 없는 최소 단위 정수로 받습니다. 소수점 2자리 통화(USD 등)는 100을 곱하고, 원화·엔화처럼 0자리인 통화는 그대로, 바레인·쿠웨이트 디나르처럼 3자리인 통화는 1000을 곱합니다. 이 자릿수를 통화마다 다르게 두지 않고 일괄로 곱하면 100배·1000배씩 틀리는 사고가 납니다.

사용 방법

  1. 1통화명(영문)이나 코드를 입력합니다.
  2. 2알파벳코드·숫자코드·소수점 자릿수가 함께 나옵니다.
  3. 3금액을 넣으면 결제 API가 쓰는 최소 단위 정수로 바뀝니다.

자주 묻는 질문

결제 API는 금액을 소수점 없는 정수(최소 단위)로 주고받는 경우가 많습니다. 대부분 통화는 2자리(1달러=100센트)라 100을 곱하면 되지만, 원화·엔화·베트남 동은 0자리라 그대로 쓰고, 바레인·쿠웨이트·요르단 디나르는 3자리라 1000을 곱해야 합니다. 이 자릿수를 통화별로 다르게 처리하지 않으면 결제 금액이 100배·1000배씩 틀어집니다.

EDI(전자문서교환) 표준이나 일부 금융 시스템에서 알파벳코드 대신 3자리 숫자로 통화를 표시할 때 씁니다. 원화는 410, 미국 달러는 840입니다.

있습니다. 부탄은 자국 눌트럼과 인도 루피를 함께 쓰고, 엘살바도르·파나마는 미국 달러를 자국 통화와 나란히 법정통화로 씁니다. 이런 경우는 통화 하나마다 별도 행으로 나눠 담았습니다.

실제 쓰이는 통화 대부분을 담았지만 ISO 4217에는 이 밖에도 특수 목적 코드(금·은 같은 귀금속, IMF 특별인출권 XDR 등)가 더 있습니다. 이 도구는 나라별로 유통되는 통화 위주로 정리했습니다.

알아두면 좋은 점

  • 코드·소수점 자릿수는 ISO 4217 데이터를 담은 공개 저장소(datasets/country-codes)에서 2026-09-09 받아 KRW=0·USD=2·BHD=3 등 잘 알려진 값과 대조해 확인했습니다.
  • 통화는 화폐개혁·신설국가 등으로 이따금 바뀝니다(예: 짐바브웨 ZWL→ZWG 2024년, 베네수엘라 VES→VED 병행). 이 표는 갱신일 기준입니다.

함께 보면 좋은 도구

마지막 검증: 2026년 9월 9일 · 결과는 참고용 추정치입니다.