Skip to main content

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

ParameterTypeRequiredDescription
merchantIdstringRequiredMerchant identifier
orderIdnumberConditionalOrder ID of the payment. Required when merchantReference is not given
merchantReferencestringConditionalUnique reference of the order. Required when orderId is not given
amountnumberRequiredRefund amount

Example:

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

Response Parameters

ParameterTypeRequiredDescription
responseCodestringRequiredPayment Gateway response code
messagestringRequiredPayment Gateway response message
orderobjectRequired 
order.idnumberRequiredOrder identifier
order.merchantReferencestringRequiredMerchant identifier which own this order
order.currencystringRequired3-Letters ISO currency code of the order
order.statusstringRequiredStatus of the order. Maintained by the Payment Gateway
order.amountnumberRequiredOrder amount
order.createTimedatetimeRequiredTimestamp when the order is created. Maintained by the Payment Gateway
order.updateTimedatetimeRequiredTimestamp when the order is last updated. Maintained by the Payment Gateway
transactionobjectRequired 
transaction.idnumberRequiredTransaction identifier for the void transaction
transaction.merchantIdnumberRequiredMerchant identifier which own this transaction
transaction.typestringRequiredTransaction type
transaction.currencystringRequiredTransaction currency
transaction.amountnumberRequiredTransaction amount
transaction.statusstringRequiredStatus of the transaction. Maintained by the Payment Gateway
transaction.maskedPanstringRequiredMasked card number of the original sale transaction if supported by the payment method
transaction.stanstringRequiredSystem trace audit number for the transaction

Example:

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