Refund (Direct Payment)
Refund
Address Payment Direct Refund
Initiate a refund for the direct address payment order, which is only applicable to the direct address payment order.
POST
Refund (Direct Payment)
Overview
This page documents thePOST /v1/pay/address/refund endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Initiate a refund for a direct (non-convert) address payment order.
Notes
- Authentication uses the standard GatePay signed headers.
- This page documents the standard merchant endpoint.
- Use
refundRequestIdas the merchant refund request ID (do not use the deprecatedrefundGateId). - The response uses the standard
status/code/errorMessage/datawrapper; business fields are underdata. - For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
Merchant client ID, obtained from GatePay platform
HMAC-SHA256 signature for request validation
Millisecond timestamp; the difference from server time must not exceed 30 seconds.
Random nonce for replay attack prevention
Body
application/json
The ID of the corresponding payment order
The amount to be refunded
The Gate user ID of the recipient of the refund for address payment
Merchant refund request ID
The reason for the refund

