v2

latestOpenAPI 3.1.02026-08-0572349.3 KB

Refund (Direct Payment)

Initiate a refund for the direct address payment order, which is only applicable to the direct address payment order.

post/v1/pay/address/refund

X-GatePay-Certificate-ClientIdstring required

Merchant client ID, obtained from GatePay platform

X-GatePay-Signaturestring required

HMAC-SHA256 signature for request validation

X-GatePay-Timestampstring required

Millisecond timestamp; the difference from server time must not exceed 30 seconds.

X-GatePay-Noncestring required

Random nonce for replay attack prevention

prepayIdstring required

The ID of the corresponding payment order

refundAmountstring required

The amount to be refunded

refundReasonstring

The reason for the refund

receiverIdinteger required

The Gate user ID of the recipient of the refund for address payment

refundRequestIdstring required

Merchant refund request ID

SUCCESS

statusstring

Status

codestring

Business code

errorMessagestring

Error message

{
  "status": "SUCCESS",
  "code": "000000"
}