개요
Dodo Payments API는 결제 시도가 실패한 이유를 이해하는 데 도움이 되는 자세한 거래 실패 사유를 제공합니다. 이러한 실패 사유는 다양한 결제 방법과 제공업체에 걸쳐 표준화되어 있어 애플리케이션에서 일관된 오류 처리를 구현하기가 더 쉽습니다. 각 거래 실패 응답에는 다음이 포함됩니다:- 특정 실패 사유 코드
- 사람이 읽을 수 있는 오류 메시지
- 가능한 경우 실패에 대한 추가 컨텍스트
- 오류가 사용자에 의해 수정 가능한지 또는 시스템 개입이 필요한지 여부
- 고객에게 명확한 피드백 제공
- 적절한 재시도 로직 구현
- 다양한 실패 시나리오를 우아하게 처리
- 신뢰할 수 있는 결제 처리 시스템 유지
거래 실패 사유
다음 표는 가능한 모든 거래 실패 사유, 그 의미 및 사용자 수정 가능 오류 여부를 나열합니다.| 실패 코드 | 사용자 오류 | 설명 |
|---|---|---|
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 경우, 거부는 고객이 해결할 수 없는 시스템 수준의 문제나 은행 제한으로 인한 것입니다.