API thanh toán đơn mua hộ
POST /v1/orders/pay
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
order_id | Yes | Main order id từ create |
pay_channel | 1688 optional | ví dụ Alipay / kjpayV2 |
Response
StandardOrderPayResult — response model.
Xác nhận và khôi phục thanh toán {#recovery-guidance}
Taobao self chuẩn chỉ trả success: true khi truy vấn đơn xác nhận thanh toán. code: "0" hoặc kết quả thành công cũ không chứng minh đã trừ tiền. pending là kết quả Gateway chưa xác nhận, không phải hàng đợi chính thức.
Idempotency-Key là tiêu đề HTTP tùy chọn. Dùng cùng Key cho một lần thử; Key mới gửi một thanh toán thực mới, không tự động tạo để bỏ qua kết quả chưa xác nhận.
Các trường mới tùy chọn:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | Xác nhận và khôi phục thanh toán |
|---|---|
none | Không thanh toán lại |
query_order | Truy vấn đơn hoặc dùng lại Key |
retry_with_new_key | Sau từ chối rõ ràng, sửa nguyên nhân và xác nhận đơn còn có thể thanh toán trước lần thử mới |
manual_review | Kiểm tra thủ công lịch sử thanh toán và giao dịch; không tự động trả lại |
Sau 15 phút từ lần thử ban đầu có Key: unknown / manual_review / CONFIRMATION_OVERDUE. Ngưỡng này không chứng minh thất bại hay hết hạn; không mở khóa Key hoặc trừ tiền lại. Lặp lại phản hồi cũ, hết thời gian chờ hoặc bị kẹt chỉ truy vấn và lưu xác nhận. Trước Key mới, phải xác nhận thủ công lần trước đã kết thúc không thanh toán hay trừ tiền. Trạng thái chưa thanh toán là chưa đủ.
request_id trong nội dung là lần thử ban đầu; tiêu đề x-request-id là HTTP hiện tại. Upstream, sandbox và kho không đổi. 1688 thêm hướng dẫn khi paySuccess rõ ràng; op_request_id gửi rõ ràng cho lần mới cũng phải mới.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days