일반적인 데이터 유형 및 응답
이러한 필드는 계정 정보 및 포인트 뱅크 API의 여러 작업에 사용됩니다.
금액
거래의 영향을 받는 로열티 리워드를 나타내는 변수입니다.
| 필드 | 설명 | 샘플 값 | 필수 여부 |
|---|---|---|---|
value | 포인트, 마일 또는 기타 프로그램 통화 단위로 지급되는 로열티 리워드 금액 | 100.00 | 예 |
currency | CAD, USD, 포인트, 마일 등 사용이 이루어진 통화 | USD | 예 |
DeclineReason
거래가 거부되는 이유입니다. 고객에게 표시할 사용자 지정 메시지도 추가할 수 있습니다.
| reasonCode | 설명 | HTTP 상태 코드 |
|---|---|---|
ACCOUNT_INELIGIBLE | 계정이 현재 사용 요청에 적합하지 않음 | 200 |
ACCOUNT_NOT_FOUND | 사용을 위한 계정을 찾을 수 없음 | 200 |
COULD_NOT_FIND_THE_ORIGINAL_TRANSACTION | 원래 거래를 찾을 수 없음 | 200 |
DUPLICATE_TRANSACTION | 이전에 사용 요청을 받았음 | 200 |
INSUFFICIENT_BALANCE | 사용자 계정의 잔액이 부족함 | 200 |
INVALID_AMOUNT | 사용 금액이 유효하지 않음 | 200 |
INVALID_PROMO_ID | 사용 프로모션 ID가 유효하지 않음 | 200 |
오류
로깅 및 조사에 도움이 되는 오류 관련 정보를 제공합니다.
오류 응답
| 필드 | 설명 |
|---|---|
status | 장애 상태 |
requestId | 고유 요청 식별자 |
errorCode | 오류 코드. 값은 오류 코드 표를 참조해 주세요. |
errorMessage | 사용자 지정 오류 메시지 |
additionalInfoMap | 키 값 쌍의 목록 |
오류 코드
| 오류 코드 | HTTP 상태 코드 |
|---|---|
ACCOUNT_NOT_FOUND | 4xx |
AUTH_FAILED | 4xx |
BAD_REQUEST | 4xx |
INTERNAL_CONFIGURATION_ISSUE | 5xx |
INVALID_ACCOUNT | 4xx |
INVALID_CREDENTIALS | 4xx |
REQUEST_IN_PROGRESS | 5xx |
RESOURCE_NOT_FOUND | 4xx |
TIMEOUT_ERROR | 5xx |
TIMEOUT_ERROR_CODE | 5xx |
UNKNOWN_ERROR_CODE | 5xx |