Refund

Description： Refund the order if the payment method allows. Support both full refund and partial refund, and can refund only once. Refund will only approve when there is enough unsettled balance in merchant account.
Path： /direct/refund
Method： POST
Request Header： Content-Type: application/json

Request Parameters#

Parameter	Type	Required	Description
merchantId	string	Required	Merchant identifier
orderId	number	Conditional	Order ID of the payment. Required when `merchantReference` is not given
merchantReference	string	Conditional	Unique reference of the order. Required when `orderId` is not given
amount	number	Required	Refund amount

Example:#

{
    "request": "{\"merchantId\":\"3000001\",\"merchantReference\":\"s22tring\",}",
    "signature":"c1hTR2RBNHRSNEIwd25GNk5yOFNocGZOTXRISVNXdXpMcGRLb05Xc2tJZ0Njc3BNVkZGemdrZXo0QnJtdFlYa01xWmgxdHl6LzhzTk5VM0YyVlR1MGZPeCtaUDRDbm1Wak51OGJjaXU0aFR0bnl0QTNZMUdaL3lYQVVEK21WWUdYZXlETzNmSHJxRGRJN2szeFYvUThGQ09kMGN1bFRzTjZSUk14TVpxK29xUjJ4K0VqT1hWb2ZwN0JaSndoUUU4VXM0QWw1NzNGUXo1RUhEdkNMeDM1bHEyaG9NaFhMQ1ZMVkRCSGNwQ2dvdHVZNG1nOTFNWGgvcXFjRkdZL2hRS2hHZFdBYlo5dGNwMlE1czJFU2gzN3JxeG5Pd1pycmVwSzhOQzZ2TUJQVWlTUHhRZWZwZXYybkcwSnpBSE9qUlBiQlhZdzFYQlM2UkJZS0FtdWZaWmlRPT0="
}

Response Parameters#

Parameter	Type	Required	Description
responseCode	string	Required	Payment Gateway response code
message	string	Required	Payment Gateway response message
order	object	Required
order.id	number	Required	Order identifier
order.merchantReference	string	Required	Merchant identifier which own this order
order.currency	string	Required	3-Letters ISO currency code of the order
order.status	string	Required	Status of the order. Maintained by the Payment Gateway
order.amount	number	Required	Order amount
order.createTime	datetime	Required	Timestamp when the order is created. Maintained by the Payment Gateway
order.updateTime	datetime	Required	Timestamp when the order is last updated. Maintained by the Payment Gateway
transaction	object	Required
transaction.id	number	Required	Transaction identifier for the void transaction
transaction.merchantId	number	Required	Merchant identifier which own this transaction
transaction.type	string	Required	Transaction type
transaction.currency	string	Required	Transaction currency
transaction.amount	number	Required	Transaction amount
transaction.status	string	Required	Status of the transaction. Maintained by the Payment Gateway
transaction.maskedPan	string	Required	Masked card number of the original sale transaction if supported by the payment method
transaction.stan	string	Required	System trace audit number for the transaction

Example:#

{
    "responseCode": "0000",
    "message": "SUCCESS",
    "order":{
        "id": "1076",
        "merchantReference": "s22tring",
        "currency": "HKD",
        "amount": 76.19,
        "status": "REFUNDED"
    }
}