Hoàn tiền giao dịch
Dùng để hoàn tiền các giao dịch thành công (có mã trạng thái là 0).
Hoàn tiền 1 phần: hoàn một phần tiền của số tiền đã thanh toán (khi mà số tiền cần hoàn nhỏ hơn số tiền đã trả).
Hoàn tiền toán phần: Hoàn lại toàn bộ số tiền đã thanh toán (khi mà số tiền cần hoàn bằng số tiền đã trả).
Luồng Xử Lý
Cấu Hình API
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.
HTTP Request
POST /v2/gateway/api/refund
| Attribute | Type | Required | Description |
|---|---|---|---|
| partnerCode | String |  | Thông tin tích hợp |
| orderId | String | | Id của giao dịch hoàn tiền, khác với Id đã dùng cho giao dịch mua ban đầu của hàng hóa/dịch vụ này |
| requestId | String(50) | | Định danh duy nhất cho mỗi yêu cầu Đối tác sử dụng requestId cho xử lý idempotency control |
| amount | Long | | Số tiền cần hoàn Nhỏ nhất: 1.000 VND (10.000 VND đối với phương thức thanh toán cổng ATM nội địa) Tối đa: 50.000.000 VND (30.000.000 VND đối với phương thức thanh toán tự động) Tiền tệ: VND |
| transId | Long | | Mã giao dịch của MoMo Đây là Id do MoMo cung cấp cho giao dịch mua thành công của hàng hóa/dịch vụ này |
| lang | String | | Ngôn ngữ của message được trả về (vi hoặc en) |
| description | String | Mô tả chi tiết yêu cầu hoàn tiền | |
| signature | String | | Chữ ký để kiểm tra thông tin. Sử dụng thuật toán Hmac_SHA256 với data theo định dạng sau: accessKey=$acessKey&amount=$amount&description=$description&orderId=$orderId&partnerCode=$partnerCode&requestId=$requestId&transId=$transId |
Mẫu Request
{
"partnerCode": "MOMO",
"orderId": "1527297954700",
"requestId": "1527314064527",
"amount": 55000,
"transId": 144492817,
"lang": "vi",
"description": "",
"signature": "8cdba11a7ff4cc7267d2b23c1f5d228a2ee52af1095420f9571c2d64ec6735fe"
}
HTTP Response
| Attribute | Type | Required | Description |
|---|---|---|---|
| partnerCode | String | | Thông tin tích hợp |
| orderId | String | | Mã đơn hàng của đối tác |
| requestId | String | | ID duy nhất cho mỗi request |
| amount | Long | | Số tiền cần hoàn |
| transId | Long | | Mã giao dịch của MoMo |
| resultCode | int | | Result Code |
| message | String | | Mô tả kết quả dựa trên lang |
| responseTime | Long | | Thời gian trả kết quả thanh toán về đối tác Định dạng: timestamp |
Mẫu Response
{
"partnerCode": "MOMO",
"orderId": "1527297954700",
"requestId": "1527314064527",
"amount": 55000,
"transId": 144518121,
"resultCode": 0,
"message": "Thành công",
"responseTime": 12454547875
}