Mã trạng thái
Tổng quan
Phản hồi từ các API của chúng tôi thường bao gồm các trường sau:
| Trường | Kiểu dữ liệu | Mô tả |
|---|---|---|
| return_code | int | Trạng thái chung |
| return_message | String | Mô tả mã trạng thái |
| sub_return_code | int | Chi tiết mã trạng thái |
| sub_return_message | String | Mô tả chi tiết của mã trạng thái |
return_code có thể có các giá trị sau:
| No | Giá trị | Mô tả ngắn |
|---|---|---|
| 1 | 1 | SUCCESS |
| 2 | 2 | FAIL |
| 3 | 3 | PROCESSING |
Nếu return_code là 2 (THẤT BẠI), bạn nên kiểm tra sub_return_code để biết chi tiết về điều gì đã xảy ra.
Chi tiết
Trong phần này, chúng tôi sẽ hướng dẫn bạn cách hiểu sub_return_code.
Create Order
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -68 | DUPLICATE_APPS_TRANS_ID | Giá trị app_trans_id của đơn hàng bị trùng | Khởi tạo đơn hàng không thành công. Merchant cần truy vấn trạng thái của đơn hàng này, hoặc khởi tạo lại đơn hàng với giá trị app_trans_id khác. |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo đơn hàng không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại đơn hàng với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo đơn hàng không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực đối chiếu với các thông tin được cung cấp từ Zalopay và khởi tạo lại đơn hàng với thông tin xác thực hợp lệ. |
| 4 | -429 | LIMIT_REQUEST_REACH | Yêu cầu bị từ chối vì vượt quá quá tần suất cho phép | Khởi tạo đơn hàng không thành công. Merchant cần khởi tạo lại đơn hàng sau một khoảng thời gian. |
| 5 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo đơn hàng không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 6 | -999 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo đơn hàng không thành công. Merchant cần khởi tạo lại đơn hàng sau khi bảo trì đã hoàn tất. |
Query Order's Status
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -54 | TIME_INVALID | Đơn hàng đã hết hạn thanh toán | Merchant tạo lại đơn hàng khác |
| 2 | -63 | ZPW_BALANCE_NOT_ENOUGH | Đơn hàng thanh toán thất bại do tài khoản người dùng không đủ tiền | Trong trường hợp đơn hàng còn hạn thanh toán, người dùng có thể nạp thêm tiền vào tài khoản và thực hiện thanh toán lại đơn hàng |
| 3 | -92 | APPTRANSID_INVALID | Giá trị app_trans_id trong yêu cầu truy vấn không đúng định dạng | Merchant kiểm tra và thử lại với yêu cầu truy vấn với giá trị app_trans_id hợp lệ |
| 4 | -101 | ORDER_NOT_EXIST | Giá trị app_trans_id không tồn tại | Merchant kiểm tra và thử lại yêu cầu truy vấn với giá trị app_trans_id khác |
| 5 | -217 | BANK_ERROR | Lỗi từ hệ thống Ngân hàng phát hành thẻ | Merchant cần liên hệ Zalopay để biết thêm chi tiết |
| 6 | -332, -333 | PROMOTION_ERROR | Đơn hàng thanh toán thất bại do thể lệ chương trình khuyến mã | Merchant cần liên hệ Zalopay để biết thêm chi tiết |
| 7 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu câu truy vấn với giá trị các tham số hợp lệ. |
| 8 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực đối chiếu với các thông tin được cung cấp từ Zalopay và khởi tạo lại yêu cầu truy vấn với thông tin xác thực hợp lệ. |
| 9 | -429 | LIMIT_REQUEST_REACH | Yêu cầu bị từ chối vì vượt quá quá tần suất cho phép | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần tạo lại yêu cầu truy vấn sau một khoảng thời gian. |
| 10 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu truy vấn không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 11 | -999 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần khởi tạo lại yêu cầu truy vấn sau khi bảo trì đã hoàn tất. |
| 12 | -1330, -1331, -1332, -1333 | EXCEED_MAX_FUND_OUT_PER_DAY | Đơn hàng thanh toán thất bại do tài khoản người dùng vượt quá hạn mức giao dịch trong một ngày | Người dùng có thể thanh toán vào các ngày kế tiếp. |
| 13 | -1340, -1341, -1342, -1343 | EXCEED_MAX_FUND_OUT_PER_MONTH | Đơn hàng thất bại do tài khoản người dùng vượt quá hạn mức giao dịch trong một tháng | Người dùng có thể thanh toán vào các tháng kế tiếp. |
Refund Order
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | 0 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết |
| 2 | -13 | ORDER_REFUND_EXPIRED | Vuợt quá thời hạn cho phép của việc khởi tạo yêu cầu hoàn tiền | Merchant kiểm tra và khởi tạo lại yêu cầu hoàn tiền với giá trị tham số timestamp hợp lệ (không quá 15 phút với thời điểm khởi tạo yêu cầu) |
| 3 | -101 | ORDER_NOT_FOUND | Giá trị zp_trans_id không tồn tại | Merchant kiểm tra và khởi tạo lại yêu cầu hoàn tiền với giá trị zp_trans_id khác. |
| 4 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu câu hoàn tiền với giá trị các tham số hợp lệ. |
| 5 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực đối chiếu với các thông tin được cung cấp từ Zalopay và khởi tạo lại yêu cầu hoàn tiền với thông tin xác thực hợp lệ. |
| 6 | -429 | LIMIT_REQUEST_REACH | Yêu cầu bị từ chối vì vượt quá quá tần suất cho phép | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant cần tạo lại yêu cầu hoàn tiền sau một khoảng thời gian. |
| 7 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 8 | -999 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu hoàn tiền không thành công. Merchant cần khởi tạo lại yêu cầu hoàn tiền sau khi bảo trì đã hoàn tất. |
| 9 | -32 | NOT_SUPPORT_PARTIAL_REFUND | Giao dịch không hỗ trợ hoàn tiền một phần | Hoàn tiền từng phần cho thanh toán qua ví điện tử (trừ ZaloPay), mã lỗi phụ này liên quan đến API hoàn tiền và truy vấn hoàn tiền |
Query Refund Order's Status
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -2 | REFUND_TYPE_INVALID | Đơn hàng không được phép hoàn tiền | Hoàn tiền không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 2 | -13 | REFUND_EXPIRE_TIME | Đơn hàng vượt quá thời hạn cho phép hoàn tiền | Hoàn tiền không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -14 | REFUND_AMOUNT_INVALID | Số tiền yêu cầu hoàn không hợp lệ | Hoàn tiền không thành công. Merchant cần kiểm tra và khởi tạo lại yêu cầu hoàn tiền với số tiền hợp lệ. |
| 4 | -16 | INSERT_REFUND_LOG_AR_FAIL | Hoàn tiền đang được xử lý | Hoàn tiền đang xử lý. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 5 | -32 | NOT_SUPPORT_PARTIAL_REFUND | Giao dịch không hỗ trợ hoàn tiền một phần | Hoàn tiền từng phần cho thanh toán qua ví điện tử (trừ ZaloPay), mã lỗi phụ này liên quan đến API hoàn tiền và truy vấn hoàn tiền |
| 6 | -101 | M_REFUND_ID_NOT_FOUND | Giá trị m_refund_id không tồn tại | Merchant kiểm tra và thử lại yêu cầu truy vấn hoàn tiền với giá trị m_refund_id khác. |
| 7 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu câu tuy vấn với giá trị các tham số hợp lệ. |
| 8 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực đối chiếu với các thông tin được cung cấp từ Zalopay và khởi tạo lại yêu cầu truy vấn với thông tin xác thực hợp lệ. |
| 9 | -429 | LIMIT_REQUEST_REACH | Yêu cầu bị từ chối vì vượt quá quá tần suất cho phép | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần khởi tạo lại yêu cầu truy vấn sau một khoảng thời gian |
| 10 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu truy vấn không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết |
| 11 | -999 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần khởi tạo lại yêu cầu truy vấn sau khi bảo trì đã hoàn tất. |
| 12 | -1 | REFUND_PENDING | Hoàn tiền chờ phê duyệt | Yêu cầu hoàn tiền đang chở phê duyệt. Merchant liên hệ Zalopay để biết thêm chi tiết |
Create Binding (Ví)
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -68 | DUPLICATE_APPS_TRANS_ID | Giá trị app_trans_id của liên kết bị trùng | Khởi tạo liên kết không thành công. Merchant cần truy vấn trạng thái của liên kết này, hoặc khởi tạo lại liên kết với giá trị app_trans_id khác |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại liên kết với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo liên kết không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực đối chiếu với các thông tin được cung cấp từ Zalopay và khởi tạo lại liên kết với thông tin xác thực hợp lệ. |
| 4 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 5 | -1801 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo liên kết không thành công. Merchant cần khởi tạo lại liên kết sau khi bảo trì đã hoàn tất. |
Query Payment Token (Ví)
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -101 | APP_TRANS_ID_NOT_FOUND | Giá trị app_trans_id không tồn tại | Merchant kiểm tra và khởi tạo lại yêu cầu truy vấn với giá trị app_trans_id khác. |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu cầu truy vấn với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực và đối chiếu với các thông tin được cung cấp từ Zalopay, thực hiện khởi tạo lại yêu cầu truy vấn với thông tin xác thực hợp lệ |
| 4 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu truy vấn không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết |
| 5 | -1801 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu truy vấn không thành công. Merchant cần khởi tạo lại yêu cầu sau khi bảo trì đã hoàn tất. |
Query Balance (Ví)
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -101 | TOKEN_NOT_EXITS | Giá trị pay_token không tồn tại | Merchant kiểm tra và khởi tạo lại yêu cầu truy vấn số dư với giá trị pay_token khác |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu truy vấn số dư không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và tạo lại yêu cầu truy vấn với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu truy vấn số dư không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực và đối chiếu với các thông tin được cung cấp từ Zalopay, và khởi tạo lại yêu cầu truy vấn với thông tin xác thực hợp lệ |
| 4 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu truy vấn số dư không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 5 | -1002 | AGREEMENT NOT VALID | Người dùng hủy liên kết | Merchant cần thông báo với người dùng. |
| 6 | -1007 | AGREEMENT_EXPIRED | Liên kết của người dùng hết hạn | Merchant cần thông báo với người dùng. |
| 7 | -1009 | USER_HAS_BEEN_LOCKED | Tài khoản của người dùng bị khóa | Merchant cần thông báo với người dùng. |
| 8 | -1011 | PERMISSION_DENIED | Liên kết của người dùng không hợp lệ với thông tin của merchant | Merchant cần kiểm tra lại pay_token có hợp lệ với app_id và khởi tạo lại yêu cầu truy vấn số dư với thông tin app_id hợp lệ của merchant. |
| 9 | -1800 | USER EXCEED KYC LIMIT | Tài khoản người dùng vượt hạn mức theo định danh | Merchant cần thông báo với người dùng. |
| 10 | -1801 | SYSTEM IS MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu truy vấn số dư không thành công. Merchant cần khởi tạo lại yêu cầu truy vấn số dư sau khi bảo trì đã hoàn tất. |
Pay By Token (Ví)
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -101 | TOKEN_NOT_EXITS | Giá trị pay_token không tồn tại | Merchant kiểm tra và khởi tạo lại yêu cầu thanh toán với giá trị pay_token khác |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu thanh toán không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu cầu thanh toán với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu thanh toán không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực và đối chiếu với các thông tin được cung cấp từ Zalopay, và khởi tạo lại yêu cầu thanh toán với thông tin xác thực hợp lệ. |
| 4 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu thanh toán không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 5 | -1002 | AGREEMENT NOT VALID | Người dùng hủy liên kết | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 6 | -1007 | ARGREEMENT_EXPIRED | Liên kết của người dùng hết hạn | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 7 | -1009 | USER_HAS_BEEN_LOCKED | Tài khoản của người dùng bị khóa | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 8 | -1010 | USER_CANNOT_PAY | Người dùng không được phép thanh toán | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 9 | -1011 | PERMISSION_DENIED | Liên kết của người dùng không hợp lệ với thông tin của merchant | Merchant cần kiểm tra lại pay_token có hợp lệ với app_id và khởi tạo lại yêu cầu thanh toán với thông tin app_id hợp lệ của merchant. |
| 10 | -1013 | PAYMENT_AMOUNT_EXCEED_LIMIT | Tài khoản người dùng vượt hạn mức thanh toán cho phép theo ngày, tháng | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 11 | -1019 | USER_EXCEED_MERCHANT_LIMIT_BINDING | Tài khoản người dùng vượt hạn mức số lần liên kết | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 12 | -1800 | USER EXCEED KYC LIMIT | Tài khoản người dùng vượt hạn mức theo định danh | Merchant cần thông báo với người dùng và không thực hiện yêu cầu thanh toán cho token này |
| 13 | -1801 | SYSTEM IS MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu thanh toán không thành công. Merchant cần khởi tạo lại yêu cầu thanh toán sau khi bảo trì đã hoàn tất. |
Un Binding (Ví)
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -101 | BINDING_NOT_EXITS | Giá trị binding_id không tồn tại | Merchant kiểm tra và khởi tạo lại yêu cầu hủy liên kết với giá trị binding_id khác |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu hủy liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu cầu hủy liên kết với giá trị các tham số hợp lệ. |
| 3 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu hủy thanh toán không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực và đối chiếu với các thông tin được cung cấp từ Zalopay, và khởi tạo lại yêu cầu hủy thanh toán với thông tin xác thực hợp lệ. |
| 4 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu hủy liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết |
| 5 | -1011 | PERMISSION_DENIED | Liên kết của người dùng không hợp lệ với thông tin của merchant | Merchant cần kiểm tra lại binding_id có hợp lệ với app_id và khởi tạo lại yêu cầu thanh toán với thông tin app_id hợp lệ của merchant. |
| 6 | -1801 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu hủy liên kết không thành công. Merchant cần khởi tạo lại yêu cầu hủy liên kết sau khi bảo trì đã hoàn tất. |
Query User Info
| No | Giá trị | Mô tả ngắn | Chú thích | Ghi chú |
|---|---|---|---|---|
| 1 | -401 | ILLEGAL_DATA_REQUEST | Các tham số trong yêu cầu sai định dạng | Khởi tạo yêu cầu truy vấn thông tin người dùng không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại yêu cầu truy vấn với giá trị các tham số hợp lệ. |
| 2 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Xác thực thông tin merchant thất bại | Khởi tạo yêu cầu truy vấn thông tin người dùng không thành công. Merchant cần kiểm tra thông tin kết nối, chữ ký xác thực và đối chiếu với các thông tin được cung cấp từ Zalopay, và khởi tạo lại yêu cầu truy vấn với thông tin xác thực hợp lệ. |
| 3 | -500 | SYSTEM_ERROR | Hệ thống gặp sự cố | Khởi tạo yêu cầu truy vấn thông tin người dùng không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết |
| 4 | -1801 | SYSTEM_MAINTENANCE | Hệ thống đang được bảo trì | Khởi tạo yêu cầu truy vấn thông tin người dùng không thành công. Merchant cần khởi tạo lại yêu cầu truy vấn sau khi bảo trì đã hoàn tất. |
Create Binding (Thẻ)
| No | Value | Short description | Meaning | Note |
|---|---|---|---|---|
| 1 | -68 | DUPLICATE_APPS_TRANS_ID | Giá trị app_trans_id của đơn hàng bị trùng | Khởi tạo đơn hàng không thành công. Merchant cần truy vấn trạng thái của đơn hàng này, hoặc khởi tạo lại đơn hàng với giá trị app_trans_id khác. |
| 2 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố | Khởi tạo liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ | Khởi tạo liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại liên kết với giá trị các tham số hợp lệ. |
Query Binding (Thẻ)
| No | Value | Short description | Meaning | Note |
|---|---|---|---|---|
| 1 | -101 | APP_TRANS_ID_NOT_EXIST | Giá trị app_trans_id không tồn tại | |
| 2 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố | Khởi tạo liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ | Khởi tạo liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại liên kết với giá trị các tham số hợp lệ. |
Pay by Token (Thẻ)
| No | Value | Short description | Meaning | Note |
|---|---|---|---|---|
| 1 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố | Khởi tạo liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 2 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ | Khởi tạo liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại liên kết với giá trị các tham số hợp lệ. |
| 3 | -7202 | ZPTOKEN_INVALID | Zp token không hợp lệ | |
| 4 | -7032 | ORDER_NOT_FOUND | Giao dịch không hợp lệ hoặc đã vượt quá giới hạn thời gian chờ | |
| 5 | -7041 | TOKEN_NOT_EXIST | Token không tồn tại | |
| 6 | -7217 | TOKEN_STATUS_INVALID | Trang thái token không hợp lệ | |
| 7 | -7223 | TOKEN_NOT_FOUND | không tìm thấy token |
Un Binding (Thẻ)
| No | Value | Short description | Meaning | Note |
|---|---|---|---|---|
| 1 | -101 | BINDING_NOT_EXIST | The binding doesn't exist, please try again | |
| 2 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố | Khởi tạo liên kết không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ | Khởi tạo liên kết không thành công. Merchant cần kiểm tra định dạng của các tham số hoặc các tham số còn thiếu và khởi tạo lại liên kết với giá trị các tham số hợp lệ. |
| 4 | -7216 | IDENTIFIER_INVALID | Identifier không hợp lệ |