createRefund
API cho phép đối tác hoàn tiền toàn phần hoặc từng phần của 1 giao dịch thanh toán.
Đối với API này, sẽ không được tích hợp sẵn trong Payment SDK. Đơn vị kinh doanh cần chủ động xây dựng phương án gọi API này để thực hiện hoàn tiền.
Lưu ý
- Quy tắc hoàn tiền dựa vào các quy tắc hoàn tiền của đối tác thanh toán.
API specification
| Method | Headers | Endpoint |
|---|---|---|
| POST | https://payment-mini.zalo.me/api/refund/create |
Parameters
Object object
| Property | Type | Required | Description |
|---|---|---|---|
| appId | string | true | Id định danh của mini app |
| transId | string | true | Mã giao dịch muốn hoàn tiền (mã được trả về khi thanh toán) |
| amount | long | true | Số tiền muốn hoàn lại cho khách hàng |
| description | string | Lý do hoàn tiền | |
| mac | string | true | Thông tin chứng thực, xem cách tạo thông tin chứng thực ở dưới |
Tạo thông tin chứng thực
data =
"appId={appId}&transId={transId}&amount={amount}&description={description}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);
Return Values
Promise <Object data>
| Property | Type | Description |
|---|---|---|
| refundId | string | Id của yêu cầu hoàn tiền |
| returnCode | int |
|
| returnMessage | string | Mô tả thông tin returnCode |