Xác nhận thanh toán
Hóa đơn thanh toán chỉ có thể được captured nếu đang ở trạng thái Authorized (resultCode là 9000). Trạng thái authorized chỉ áp dụng cho luồng thanh toán trực tiếp với thẻ quốc tế, ví MoMo với tham số autoCapture được chỉnh giá trị là false.
Sau khi cấp quyền thành công, giao dịch được cấp quyền sẽ có trạng thái là 9000:Authorized. Đối tác sẽ xử lý nội bộ và gọi API này để xác nhận giao dịch, bao gọi 2 kiểu request:
Confirm (
capture): Đối tác xử lý giao dịch thành công, số tiền sẽ được chuyển đến ví của đối tác. Giao dịch này bên phía MoMo sẽ được lưu với trạng thái Thành Công (Successful).Cancel (
cancel): Đối tác thất bại trong việc xử lý giao dịch, và ở trạng thái này số tiền đang được chuyển về cho user. Giao dịch này từ phía MoMo sẽ được lưu với trạng thái Thất Bại (Failed).
Thông tin kết nối đến MoMo
Thời gian timeout nhỏ nhất khi gọi API này nên là 30s để đảm bảo nhận phản hồi từ server của MoMo.
POST /v2/gateway/api/confirm
| Attribute | Type | Required | Description |
|---|---|---|---|
| partnerCode | String |  | Thông tin tích hợp |
| requestId | String | | Định danh duy nhất cho mỗi yêu cầu Đối tác sử dụng requestId cho xử lý idempotency |
| orderId | String | | Mã đơn hàng của đối tác đã xác thực |
| requestType | String | | Loại yêu cầu với 2 giá trị sau: - Xác nhận giao dịch: capture- Hủy bỏ giao dịch: cancel |
| amount | Long | | Số tiền của hóa đơn cần xác nhận (hủy bỏ) |
| lang | String | | Ngôn ngữ của message được trả về (vi hoặc en) |
| description | String | Mô tả lý do (dùng trong trường hợp) cancel) | |
| signature | String | | Chữ ký để kiểm tra thông tin. Sử dụng thuật toán Hmac_SHA256 với dữ liệu theo định dạng sau: accessKey=$accessKey&amount=$amount&description=$description&orderId=$orderId&partnerCode=$partnerCode&requestId=$requestId&requestType=$requestType |
| Attribute | Type | Required | Description |
|---|---|---|---|
| partnerCode | String | | Thông tin tích hợp |
| requestId | String | | ID duy nhất cho mỗi request |
| orderId | String | | Mã đơn hàng của đối tác đã xác thực |
| amount | Long | | Số tiền của hóa đơn gốc |
| transId | Long | | Mã giao dịch của MoMo |
| resultCode | int | | Result Code |
| message | String | | Mô tả lỗi, ngôn ngữ dựa trên lang |
| requestType | String | | Loại yêu cầu với 2 giá trị sau: - Xác nhận giao dịch: capture- Hủy bỏ giao dịch: cancel |
| responseTime | Long | | Thời gian trả kết quả thanh toán về đối tác Định dạng: timestamp |