---
title: "Refund (Direct Payment)"
method: POST
path: "/v1/pay/address/refund"
---

# Refund (Direct Payment)

`POST /v1/pay/address/refund`

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

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Request body

- RefundRequest
  - `prepayId` string, required — The ID of the corresponding payment order
  - `refundAmount` string, required — The amount to be refunded
  - `refundReason` string — The reason for the refund
  - `receiverId` integer, required — The Gate user ID of the recipient of the refund for address payment
  - `refundRequestId` string, required — Merchant refund request ID

## Response `200`

SUCCESS

- RefundResponse — Standard response wrapper; business fields are under data
  - `status` string — Status
  - `code` string — Business code
  - `errorMessage` string — Error message
  - `data` RefundData — Address refund business data
    - `refundRequestId` string — Merchant's refund request id
    - `prepayId` string — The id of the payment order to be refunded
    - `orderAmount` string — The amount of the original payment order
    - `refundAmount` string — The amount to be refunded

## Changes

- **2026-08-05** `00c10e31a4f9` — 2 breaking, 7 warning, 4 info
  - added the new required request property `refundRequestId`
  - the `receiverId` request property type/format changed from `string`/`` to `integer`/`int64`
  - removed the request property `clientId`
  - removed the request property `mId`
  - …9 more

[Change history](https://skmtc.dev/gate/apis/gatepay-address-payment-api/changes/v1/pay/address/refund/post.md)

---

[API](https://skmtc.dev/gate/apis/gatepay-address-payment-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-address-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-address-payment-api/revisions/e66c448f796e/schema)