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
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -68 | DUPLICATE_APPS_TRANS_ID | app_trans_id đã tồn tại trên hệ thống Zalopay | Merchant nên tra cứu trạng thái đơn hàng bằng API Get Order's Status hoặc tạo đơn hàng mới với app_trans_id khác. |
| 2 | -401 | ILLEGAL_DATA_REQUEST | Request không hợp lệ hoặc thiếu tham số bắt buộc | 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 | Không thể xác thực request do thông tin ứng dụng hoặc giá trị MAC không hợp lệ | Merchant kiểm tra định dạng và giá trị của các tham số trước khi gửi lại request. |
| 4 | -429 | LIMIT_REQUEST_REACH | Yêu cầu vượt quá tần suất cho phép | Merchant giảm tần suất gọi API và thử lại sau một khoảng thời gian phù hợp. |
| 5 | -500 | SYSTEM_ERROR | Hệ thống Zalopay gặp sự cố trong quá trình xử lý | Merchant thử lại sau. Nếu lỗi vẫn tiếp tục xảy ra, vui lòng liên hệ Zalopay để được hỗ trợ. |
| 6 | -999 | SYSTEM_MAINTENANCE | Hệ thống Zalopay đang bảo trì | Merchant gửi lại request sau khi quá trình bảo trì kết thúc. |
Query Order's Status
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -54 | TIME_INVALID | Đơn hàng đã hết thời gian thanh toán | Merchant tạo đơn hàng mới nếu người dùng vẫn có nhu cầu thanh toán. |
| 2 | -63 | ZPW_BALANCE_NOT_ENOUGH | Thanh toán thất bại do tài khoản người dùng không đủ số dư | Nếu đơn hàng vẫn còn thời gian thanh toán, người dùng có thể bổ sung số dư và thực hiện thanh toán lại. |
| 3 | -92 | APPTRANSID_INVALID | Giá trị app_trans_id không đúng định dạng | Merchant kiểm tra lại định dạng của app_trans_id trước khi gửi lại request. |
| 4 | -101 | ORDER_NOT_EXIST | Không tìm thấy đơn hàng tương ứng với app_trans_id | Merchant kiểm tra lại app_trans_id. |
| 5 | -217 | BANK_ERROR | Thanh toán thất bại do lỗi từ hệ thống ngân hàng | Merchant thông báo kết quả thanh toán thất bại cho người dùng. Nếu cần xác minh thêm, liên hệ ZaloPay để được hỗ trợ. |
| 6 | -332, -333 | PROMOTION_ERROR | Thanh toán thất bại do không đáp ứng điều kiện chương trình khuyến mãi | Merchant thông báo kết quả thanh toán thất bại cho người dùng. Nếu cần xác minh thêm, liên hệ ZaloPay để được hỗ trợ. |
| 7 | -401 | ILLEGAL_DATA_REQUEST | Request không hợp lệ hoặc thiếu tham số bắt buộc | Merchant kiểm tra định dạng và giá trị của các tham số trước khi gửi lại request. |
| 8 | -402 | ILLEGAL_APP/SIGNATURE_REQUEST | Không thể xác thực request do thông tin ứng dụng hoặc giá trị MAC không hợp lệ | Merchant kiểm tra lại cách tạo MAC, bao gồm thứ tự các trường trong hmacinput, ký tự phân cách, giá trị của từng trường, thuật toán HMAC và MAC key do Zalopay cấp; sau đó tính lại giá trị MAC và gửi lại request. |
| 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 | Merchant giảm tần suất gọi API và thử lại sau một khoảng thời gian phù hợp. |
| 10 | -500 | SYSTEM_ERROR | Hệ thống Zalopay gặp sự cố trong quá trình xử lý | Merchant thử lại sau. Nếu lỗi vẫn tiếp tục xảy ra, vui lòng liên hệ Zalopay để được hỗ trợ. |
| 11 | -999 | SYSTEM_MAINTENANCE | Hệ thống Zalopay đang bảo trì | Merchant gửi lại request sau khi quá trình bảo trì kết thúc. |
| 12 | -1330, -1331, -1332, -1333 | EXCEED_MAX_FUND_OUT_PER_DAY | Người dùng vượt hạn mức giao dịch trong ngày | Người dùng có thể thực hiện thanh toán vào ngày tiếp theo hoặc sử dụng nguồn tiền khác. |
| 13 | -1340, -1341, -1342, -1343 | EXCEED_MAX_FUND_OUT_PER_MONTH | Người dùng vượt hạn mức giao dịch trong tháng | Người dùng có thể thực hiện thanh toán vào tháng tiếp theo hoặc sử dụng nguồn tiền khác. |
Refund Order
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -14 | REFUND_AMOUNT_INVALID | Số tiền yêu cầu hoàn không hợp lệ | 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
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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 |
| 13 | 0 | SYSTEM_ERROR | Hệ thống gặp sự cố | Hoàn tiền không thành công. Merchant liên hệ Zalopay để biết thêm chi tiết. |
Create Binding (Ví)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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í)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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í)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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í)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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í)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 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ẻ)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -68 | DUPLICATE_APPS_TRANS_ID | Giá trị app_trans_id của đơn hàng bị trù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 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố. | Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ. | 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ẻ)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -101 | APP_TRANS_ID_NOT_EXIST | Giá trị app_trans_id không tồn tại. | Merchant cần kiểm tra giá trị app_trans_id và thực hiện truy vấn lại với giá trị hợp lệ. |
| 2 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố. | Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ | 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 truy vấn với giá trị các tham số hợp lệ. |
Pay by Token (Thẻ)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố. | Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 2 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ. | 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ệ. | Không thực hiện gọi thanh toán với token này |
| 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ờ. | Không gọi thanh toán cho đơn hàng này do đã hết hạn |
| 5 | -7041 | TOKEN_NOT_EXIST | Token không tồn tại. | Không thực hiện gọi thanh toán với token này. |
| 6 | -7217 | TOKEN_STATUS_INVALID | Trang thái token không hợp lệ. | Không thực hiện gọi thanh toán với token này. |
| 7 | -7223 | TOKEN_NOT_FOUND | Không tìm thấy token. | Không thực hiện gọi thanh toán với token này. |
Un Binding (Thẻ)
| TT | Giá trị | Mô tả lỗi | Ý nghĩa | Khuyến nghị xử lý |
|---|---|---|---|---|
| 1 | -101 | BINDING_NOT_EXIST | The binding doesn't exist, please try again. | Không thực hiện gọi hủy liên kết với binding_id này. |
| 2 | -500 | INTERNAL_ERROR | Hệ thống gặp sự cố. | Merchant liên hệ Zalopay để biết thêm chi tiết. |
| 3 | -7002 | WRONG_PARAMETER | Dữ liệu không hợp lệ. | 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 hủy 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ệ. | Merchant cần kiểm tra giá trị identifier |