Thanh toán bằng token
API dùng để thanh toán đơn hàng bằng token của người dùng.
- application/json
- application/x-www-form-urlencoded
Request Body required
- app_id int64 required
Định danh cho ứng dụng (web, app, pos ...) hay dịch vụ (auto-debit, disbursement ...) của Merchant được cấp khi đăng ký tích hợp phương thức thanh toán với Zalopay.
- identifier string required
Thông tin định danh của người dùng trên hệ thống của merchant, có thể là: id/username... của người dùng.
- zp_trans_token string required
Giá trị zp_trans_token trong response trả về của hệ thống Zalopay sau khi Merchant khởi tạo đơn hàng thành công bằng API Create order.
- pay_token string required
Thông tin token của người dùng.
- req_date int64 required
Thời gian tạo yêu cầu thanh toán (unix timestamp in milisecond). Thời gian tính đến milisecond, lấy theo giờ hiện hành
- mac string required
Thông tin chứng thực: mac = HMAC(hmac_algorihtm, mac key, hmacinput), chi tiết như bên dưới:
- hmac_algorihtm: là phương thức bảo mật được Merchant đăng ký với Zalopay, mặc định là HmacSHA256.
- mac key: được cung cấp bởi Zalopay.
- hmac_input = app_id +|+ identifier +|+ zp_trans_token +|+ pay_token +|+ req_date.Vui lòng tham khảo phần truyền dữ liệu an toàn để biết thêm chi tiết.
Request Body required
- app_id int64 required
Định danh cho ứng dụng (web, app, pos ...) hay dịch vụ (auto-debit, disbursement ...) của Merchant được cấp khi đăng ký tích hợp phương thức thanh toán với Zalopay.
- identifier string required
Thông tin định danh của người dùng trên hệ thống của merchant, có thể là: id/username... của người dùng.
- zp_trans_token string required
Giá trị zp_trans_token trong response trả về của hệ thống Zalopay sau khi Merchant khởi tạo đơn hàng thành công bằng API Create order.
- pay_token string required
Thông tin token của người dùng.
- req_date int64 required
Thời gian tạo yêu cầu thanh toán (unix timestamp in milisecond). Thời gian tính đến milisecond, lấy theo giờ hiện hành
- mac string required
Thông tin chứng thực: mac = HMAC(hmac_algorihtm, mac key, hmacinput), chi tiết như bên dưới:
- hmac_algorihtm: là phương thức bảo mật được Merchant đăng ký với Zalopay, mặc định là HmacSHA256.
- mac key: được cung cấp bởi Zalopay.
- hmac_input = app_id +|+ identifier +|+ zp_trans_token +|+ pay_token +|+ req_date.Vui lòng tham khảo phần truyền dữ liệu an toàn để biết thêm chi tiết.
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
- return_code integer
Mã trạng thái.
Vui lòng tham khảo mã trạng thái để biết thêm chi tiết. - return_message string
Mota3 mã trạng thái.
- sub_return_code integer
Mã trạng thái chi tiết.
Vui lòng tham khảo mã trạng thái để biết thêm chi tiết. - sub_return_message string
Mo tả mã trạng thái chi tiết.
- app_trans_id string
Mã giao dịch Merchant gửi qua hệ thống Zalopay để user thực hiện thanh toán (TXID của giao dịch đơn hàng).
- zp_trans_id integer
Mã giao dịch của Zalopay, khi người dùng thực hiện thanh toán.
{
"return_code": 0,
"return_message": "string",
"sub_return_code": 0,
"sub_return_message": "string",
"app_trans_id": "string",
"zp_trans_id": 0
}