Chuyển đến nội dung chính

​
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
Hiểu những lý do lỗi này là rất quan trọ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.
Failure CodeLỗi Người DùngMô Tả
AUTHENTICATION_FAILURECóQuá trình xác thực đã thất bại trong giao dịch
AUTHENTICATION_REQUIREDCóCần xác thực bổ sung để hoàn tất giao dịch
AUTHENTICATION_TIMEOUTCóQuá trình xác thực đã hết thời gian
CARD_DECLINEDKhôngThẻ bị từ chối bởi ngân hàng phát hành
CARD_NOT_ACTIVATEDCóThẻ chưa được chủ thẻ kích hoạt
CARD_VELOCITY_EXCEEDEDCóQuá nhiều giao dịch được thực hiện trong khoảng thời gian ngắn
CUSTOMER_CANCELLEDCóKhách hàng đã hủy giao dịch
DO_NOT_HONORKhôngNgân hàng phát hành đã từ chối giao dịch
EXPIRED_CARDCóThẻ đã hết hạn
FRAUDULENTCóGiao dịch bị đánh dấu là có khả năng gian lận
GENERIC_DECLINEKhôngGiao dịch bị từ chối vì lý do không xác định
INCORRECT_CVCCóMã CVC cung cấp không chính xác
INCORRECT_NUMBERCóSố thẻ đã nhập sai
INSUFFICIENT_FUNDSCóTài khoản không đủ tiền để hoàn tất giao dịch
INVALID_ACCOUNTCóThông tin tài khoản cung cấp không hợp lệ
INVALID_AMOUNTCóSố tiền giao dịch không hợp lệ
INVALID_CARD_NUMBERCóĐịnh dạng số thẻ không hợp lệ
INVALID_CARD_OWNERCóThông tin chủ thẻ không hợp lệ
INVALID_CVCCóĐịnh dạng CVC không hợp lệ
INVALID_EXPIRY_YEARCóNăm hết hạn thẻ không hợp lệ
INVALID_PINCóMã PIN cung cấp không chính xác
INVALID_REQUESTCóYêu cầu giao dịch chứa dữ liệu không hợp lệ
INVALID_UPI_IDCóUPI ID cung cấp không hợp lệ
LIMIT_EXCEEDEDCóGiao dịch vượt quá giới hạn thẻ hoặc tài khoản
LIVE_MODE_TEST_CARDCóĐã sử dụng thẻ thử nghiệm trong chế độ trực tiếp
LOST_CARDCóThẻ đã được báo mất
MANDATE_INVALIDCóGiấy phép thanh toán không hợp lệ
MANDATE_REQUIREDCóGiao dịch này yêu cầu giấy phép
MANDATE_REQUIRED_SYSTEMKhôngHệ thống yêu cầu giấy phép cho loại giao dịch này
NETWORK_ERRORKhôngĐã xảy ra lỗi mạng trong quá trình giao dịch
NETWORK_TIMEOUTKhôngYêu cầu mạng đã hết thời gian chờ
ORDER_CREATION_FAILEDKhôngKhông thể tạo đơn hàng cho giao dịch
PAYMENT_METHOD_PROVIDER_DECLINEDCóNhà cung cấp phương thức thanh toán đã từ chối giao dịch
PAYMENT_METHOD_UNSUPPORTEDCóPhương thức thanh toán không được hỗ trợ cho giao dịch này
PICKUP_CARDCóThẻ đã được báo bị đánh cắp và cần được thu hồi
PROCESSING_ERRORKhôngĐã xảy ra lỗi trong quá trình xử lý giao dịch
PROVIDER_UNSUPPORTEDKhôngNhà cung cấp thanh toán không hỗ trợ loại giao dịch này
REENTER_TRANSACTIONCóCần nhập lại giao dịch
REVOCATION_OF_AUTHORIZATIONCóỦy quyền cho giao dịch đã bị thu hồi
STOLEN_CARDCóThẻ đã được báo bị đánh cắp
TRANSACTION_NOT_ALLOWEDCóGiao dịch không được phép cho thẻ hoặc tài khoản này
TRANSACTION_NOT_APPROVEDCóGiao dịch không được phê duyệt
TRY_AGAIN_LATERKhôngNên thử lại giao dịch sau
UNKNOWN_ERRORKhôngĐã xảy ra 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 khách hàng giải quyết 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 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.

​
Hỗ Trợ

Để được hỗ trợ thêm về các lỗi giao dịch hoặc vấn đề tích hợp, vui lòng liên hệ với đội ngũ hỗ trợ của chúng tôi tại support@dodopayments.com.