화면 표시와 API 전송 값
화면 표시
API 값
설명용 가상 금액입니다. 원·엔은 정수, 달러·유로는 소수 둘째 자리까지 사용합니다. 통화별 원금액은 서로 환산되지 않습니다.
비교 데이터 표
| 비교 항목 | 화면 표시 | API 값 |
|---|---|---|
| 원 | 10,000원 | amount 10000 · currency KRW |
| 달러 | 10.25달러 | amount 10.25 · currency USD |
| 엔 | 1,000엔 | amount 1000 · currency JPY |
| 유로 | 8.50유로 | amount 8.50 · currency EUR |
통화 없이 금액을 해석하지 않기
100이라는 숫자는 통화에 따라 의미가 다릅니다. 입력, 저장, 조회, 합계 계산 전 과정에서 통화를 함께 유지해야 합니다. 서로 다른 통화의 합계를 표시하려면 환율 출처와 적용 시점을 포함한 별도의 환산 정책이 필요합니다.
현재 GUARDIAN 입력 규칙
거래 금액은 양수 숫자이며 지원 통화는 원·달러·엔·유로입니다. 원과 엔은 정수 금액, 달러와 유로는 소수 둘째 자리까지의 값을 사용합니다. 구체적인 최대 값과 필수 필드는 요청 필드에서 확인합니다.
표시와 전송을 분리하는 예시
화면에서는 10,000원처럼 쉼표와 단위를 보여 주지만 API의 amount는 10000입니다. 사용자가 버튼으로 금액을 더하더라도 실제 숫자 값을 변경하고 표시용 문자열은 마지막에 포맷합니다. 문자열 10,000을 숫자로 변환하는 과정에서 10으로 잘못 잘리지 않도록 검사하세요.
계산 오차와 설정 변경
소수 계산은 부동소수점 오차를 고려해야 합니다. 합계를 계산하는 계층에서는 통화의 소수 단위를 일관되게 적용하고 검증된 금액 처리 방식을 사용합니다. 사이트 기본 표시 통화를 바꾸는 것은 기존 거래의 통화나 금액을 환산하는 작업과 다릅니다. 변경 전후에 과거 거래가 원 통화로 유지되는지도 확인하세요.
가상 검증 사례
가상의 화면 표시 10,000원은 amount 10000과 currency KRW로 전송합니다. 10.25달러와 10,000원을 환율 정책 없이 10010.25로 합산하지 않습니다.
이 사례는 실측 성능이나 실제 고객 자료가 아닙니다. 제품의 적용 범위는 GUARDIAN 공개 API 계약를 기준으로 확인합니다.
| 표시 예시 | amount | currency |
|---|---|---|
| 10,000원 | 10000 | KRW |
| 10.25달러 | 10.25 | USD |
주장과 근거
- GUARDIAN API 금액은 표시용 쉼표 없이 양수 숫자로 전송합니다. 원·엔은 정수, 달러·유로는 소수 둘째 자리까지 사용하며, 기본 표시 통화를 바꿔도 기존 거래의 통화가 환산되는 것은 아닙니다. [GUARDIAN 공개 API 계약]
- 가상의 화면 표시 10,000원은 amount 10000과 currency KRW로 전송합니다. 10.25달러와 10,000원을 환율 정책 없이 10010.25로 합산하지 않습니다. (가상 예시) [이 문서의 가상 검증 사례]
출처 목록
- GUARDIAN 공개 API 계약 · GUARDIAN FDS · 확인
- 이 문서의 가상 검증 사례 · GUARDIAN FDS · 설명용 사례 · 확인