Tổng Quan
Dodo Payments API cung cấp các lý do lỗi giao dịch chi tiết để giúp bạn hiểu tại sao một nỗ lực thanh toán không thành công. Những lý do lỗi này được chuẩn hóa trên các phương thức và nhà cung cấp thanh toán khác nhau, giúp dễ dàng triển khai xử lý lỗi nhất quán trong ứng dụng của bạn. Mỗi phản hồi lỗi giao dịch bao gồm:- Một mã lý do lỗi cụ thể
- Một thông điệp lỗi dễ hiểu
- Thông tin bổ sung về lỗi khi có sẵn
- Liệu lỗi có thể được người dùng sửa chữa hay cần can thiệp từ hệ thống
- Cung cấp phản hồi rõ ràng cho khách hàng của bạn
- Triển khai logic thử lại phù hợp
- Xử lý các kịch bản lỗi khác nhau một cách duyên dáng
- Duy trì một hệ thống xử lý thanh toán đáng tin cậy
Lý Do Lỗi Giao Dịch
Bảng sau liệt kê tất cả các lý do lỗi giao dịch có thể xảy ra, ý nghĩa của chúng và liệu chúng có phải là lỗi có thể sửa chữa bởi người dùng hay không.| Mã Lỗi | Lỗi Người Dùng | Mô Tả |
|---|---|---|
AUTHENTICATION_FAILURE | Có | Quá trình xác thực đã thất bại trong giao dịch |
AUTHENTICATION_REQUIRED | Có | Cần xác thực bổ sung để hoàn tất giao dịch |
AUTHENTICATION_TIMEOUT | Có | Quá trình xác thực đã hết thời gian |
CARD_DECLINED | Không | Thẻ đã bị từ chối bởi ngân hàng phát hành |
CARD_NOT_ACTIVATED | Có | Thẻ chưa được kích hoạt bởi chủ thẻ |
CARD_VELOCITY_EXCEEDED | Có | Quá nhiều giao dịch đã được thực hiện trong một khoảng thời gian ngắn |
CUSTOMER_CANCELLED | Có | Khách hàng đã hủy giao dịch |
DO_NOT_HONOR | Không | Ngân hàng phát hành đã từ chối giao dịch |
EXPIRED_CARD | Có | Thẻ đã hết hạn |
FRAUDULENT | Có | Giao dịch đã bị đánh dấu là có khả năng gian lận |
GENERIC_DECLINE | Không | Giao dịch đã bị từ chối vì lý do không xác định |
INCORRECT_CVC | Có | Mã CVC được cung cấp không chính xác |
INCORRECT_NUMBER | Có | Số thẻ đã được nhập không chính xác |
INSUFFICIENT_FUNDS | Có | Tài khoản không đủ tiền để hoàn tất giao dịch |
INVALID_ACCOUNT | Có | Thông tin tài khoản được cung cấp không hợp lệ |
INVALID_AMOUNT | Có | Số tiền giao dịch không hợp lệ |
INVALID_CARD_NUMBER | Có | Định dạng số thẻ không hợp lệ |
INVALID_CARD_OWNER | Có | Thông tin chủ thẻ không hợp lệ |
INVALID_CVC | Có | Định dạng CVC không hợp lệ |
INVALID_EXPIRY_YEAR | Có | Năm hết hạn thẻ không hợp lệ |
INVALID_PIN | Có | Mã PIN được cung cấp không chính xác |
INVALID_REQUEST | Có | Yêu cầu giao dịch chứa dữ liệu không hợp lệ |
INVALID_UPI_ID | Có | ID UPI được cung cấp không hợp lệ |
LIMIT_EXCEEDED | Có | Giao dịch vượt quá giới hạn thẻ hoặc tài khoản |
LIVE_MODE_TEST_CARD | Có | Một thẻ thử nghiệm đã được sử dụng trong chế độ trực tiếp |
LOST_CARD | Có | Thẻ đã được báo cáo là bị mất |
MANDATE_INVALID | Có | Mệnh lệnh thanh toán không hợp lệ |
MANDATE_REQUIRED | Có | Một mệnh lệnh là cần thiết cho giao dịch này |
MANDATE_REQUIRED_SYSTEM | Không | Hệ thống yêu cầu một mệnh lệnh cho loại giao dịch này |
NETWORK_ERROR | Không | Một lỗi mạng đã xảy ra trong quá trình giao dịch |
NETWORK_TIMEOUT | Không | Yêu cầu mạng đã hết thời gian |
ORDER_CREATION_FAILED | Không | Không thể tạo đơn hàng cho giao dịch |
PAYMENT_METHOD_PROVIDER_DECLINED | Có | Nhà cung cấp phương thức thanh toán đã từ chối giao dịch |
PAYMENT_METHOD_UNSUPPORTED | Có | Phương thức thanh toán không được hỗ trợ cho giao dịch này |
PICKUP_CARD | Có | Thẻ đã được báo cáo là bị đánh cắp và cần được thu hồi |
PROCESSING_ERROR | Không | Đã xảy ra lỗi trong quá trình xử lý giao dịch |
PROVIDER_UNSUPPORTED | Không | Nhà cung cấp thanh toán không hỗ trợ loại giao dịch này |
REENTER_TRANSACTION | Có | Giao dịch cần được nhập lại |
REVOCATION_OF_AUTHORIZATION | Có | Quyền xác thực cho giao dịch đã bị thu hồi |
STOLEN_CARD | Có | Thẻ đã được báo cáo là bị đánh cắp |
TRANSACTION_NOT_ALLOWED | Có | Giao dịch không được phép cho thẻ hoặc tài khoản này |
TRANSACTION_NOT_APPROVED | Có | Giao dịch không được phê duyệt |
TRY_AGAIN_LATER | Không | Giao dịch nên được thử lại sau |
UNKNOWN_ERROR | Không | Đã xảy ra một lỗi không xác định |
Lỗi Người Dùng cho biết liệu việc từ chối thanh toán có thể được giải quyết bởi khách hàng hay không. Khi
true, khách hàng có thể thực hiện hành động để khắc phục vấn đề (ví dụ: nhập đúng thông tin thẻ). Khi false, việc từ chối là do các vấn đề cấp hệ thống hoặc hạn chế của ngân hàng mà khách hàng không thể giải quyết.