개요
Dodo Payments API는 결제 시도가 실패한 이유를 이해하는 데 도움이 되는 자세한 거래 실패 사유를 제공합니다. 이러한 실패 사유는 다양한 결제 방법과 제공업체에 걸쳐 표준화되어 있어 애플리케이션에서 일관된 오류 처리를 구현하기가 더 쉽습니다. 각 거래 실패 응답에는 다음이 포함됩니다:- 특정 실패 사유 코드
- 사람이 읽을 수 있는 오류 메시지
- 가능한 경우 실패에 대한 추가 컨텍스트
- 오류가 사용자에 의해 수정 가능한지 또는 시스템 개입이 필요한지 여부
- 고객에게 명확한 피드백 제공
- 적절한 재시도 로직 구현
- 다양한 실패 시나리오를 우아하게 처리
- 신뢰할 수 있는 결제 처리 시스템 유지
거래 실패 사유
다음 표는 가능한 모든 거래 실패 사유, 그 의미 및 사용자 수정 가능 오류 여부를 나열합니다.| Failure Code | User Error | Description |
|---|---|---|
AUTHENTICATION_FAILURE | 예 | 거래 중 인증 프로세스에 실패했습니다 |
AUTHENTICATION_REQUIRED | 예 | 거래를 완료하려면 추가 인증이 필요합니다 |
AUTHENTICATION_TIMEOUT | 예 | 인증 프로세스 시간이 초과되었습니다 |
CARD_DECLINED | 아니요 | 카드 발급 은행에서 거래를 거절했습니다 |
CARD_NOT_ACTIVATED | 예 | 카드 소유자가 카드를 활성화하지 않았습니다 |
CARD_VELOCITY_EXCEEDED | 예 | 짧은 시간에 너무 많은 거래 시도가 있었습니다 |
CUSTOMER_CANCELLED | 예 | 고객이 거래를 취소했습니다 |
DO_NOT_HONOR | 아니요 | 발급 은행이 거래를 거절했습니다 |
EXPIRED_CARD | 예 | 카드가 만료되었습니다 |
FRAUDULENT | 예 | 거래가 잠재적 사기 행위로 표시되었습니다 |
GENERIC_DECLINE | 아니요 | 명시되지 않은 이유로 거래가 거절되었습니다 |
INCORRECT_CVC | 예 | 제공된 CVC 코드가 올바르지 않습니다 |
INCORRECT_NUMBER | 예 | 카드 번호가 잘못 입력되었습니다 |
INSUFFICIENT_FUNDS | 예 | 거래를 완료할 수 있도록 계정에 잔액이 부족합니다 |
INVALID_ACCOUNT | 예 | 제공된 계정 정보가 유효하지 않습니다 |
INVALID_AMOUNT | 예 | 거래 금액이 유효하지 않습니다 |
INVALID_CARD_NUMBER | 예 | 카드 번호 형식이 유효하지 않습니다 |
INVALID_CARD_OWNER | 예 | 카드 소유자 정보가 유효하지 않습니다 |
INVALID_CVC | 예 | CVC 형식이 유효하지 않습니다 |
INVALID_EXPIRY_YEAR | 예 | 카드 만료 연도가 유효하지 않습니다 |
INVALID_PIN | 예 | 제공된 PIN이 올바르지 않습니다 |
INVALID_REQUEST | 예 | 거래 요청에 유효하지 않은 데이터가 포함되어 있습니다 |
INVALID_UPI_ID | 예 | 제공된 UPI ID가 유효하지 않습니다 |
LIMIT_EXCEEDED | 예 | 거래가 카드 또는 계정 한도를 초과했습니다 |
LIVE_MODE_TEST_CARD | 예 | 라이브 모드에서 테스트 카드를 사용했습니다 |
LOST_CARD | 예 | 카드를 분실 신고했습니다 |
MANDATE_INVALID | 예 | 결제 위임이 유효하지 않습니다 |
MANDATE_REQUIRED | 예 | 이 거래에는 위임이 필요합니다 |
MANDATE_REQUIRED_SYSTEM | 아니요 | 시스템에서 이 거래 유형에 위임을 요구합니다 |
NETWORK_ERROR | 아니요 | 거래 중 네트워크 오류가 발생했습니다 |
NETWORK_TIMEOUT | 아니요 | 네트워크 요청 시간이 초과되었습니다 |
ORDER_CREATION_FAILED | 아니요 | 거래 주문을 생성하지 못했습니다 |
PAYMENT_METHOD_PROVIDER_DECLINED | 예 | 결제 수단 제공자가 거래를 거절했습니다 |
PAYMENT_METHOD_UNSUPPORTED | 예 | 이 거래에 대해 해당 결제 수단이 지원되지 않습니다 |
PICKUP_CARD | 예 | 도난 신고된 카드이며 회수가 필요합니다 |
PROCESSING_ERROR | 아니요 | 거래 처리 중 오류가 발생했습니다 |
PROVIDER_UNSUPPORTED | 아니요 | 결제 제공자가 이 거래 유형을 지원하지 않습니다 |
REENTER_TRANSACTION | 예 | 거래를 다시 입력해야 합니다 |
REVOCATION_OF_AUTHORIZATION | 예 | 거래 승인이 취소되었습니다 |
STOLEN_CARD | 예 | 카드를 도난 신고했습니다 |
TRANSACTION_NOT_ALLOWED | 예 | 이 카드 또는 계정에는 거래가 허용되지 않습니다 |
TRANSACTION_NOT_APPROVED | 예 | 거래가 승인되지 않았습니다 |
TRY_AGAIN_LATER | 아니요 | 거래를 나중에 다시 시도해야 합니다 |
UNKNOWN_ERROR | 아니요 | 알 수 없는 오류가 발생했습니다 |
사용자 오류는 결제 거절을 고객이 해결할 수 있는지를 나타냅니다.
true일 경우 고객이 문제를 해결하기 위한 조치를 취할 수 있습니다(예: 올바른 카드 정보를 입력). false일 경우 고객이 해결할 수 없는 시스템 수준 문제 또는 은행 제약으로 인한 거절입니다.