v1

latestOpenAPI 3.1.02026-07-2182453.1 KB

Refund (Convert Payment)

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

post/v1/pay/address/refundconvert

Headers

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

Timestamp in milliseconds, must not differ from server time by more than 5 minutes

X-GatePay-Noncestring required

Random nonce for replay attack prevention

Request body

refundRequestIdstring required

Merchant request refund number

prepayIdstring required

Payment order ID for refund

refundOrderCurrencystring required

Refund order currency

refundPayCurrencystring required

Refund payment currency

refundPayAmountstring

Refund payment amount in the corresponding currency

refundReasonstring required

Reason for refund

receiverIdstring required

Gate system user ID for refund recipient in address payment

Response

SUCCESS

statusstring
codestring
errorMessagestring