---
title: "POST /payments/merchant/refund"
method: POST
path: "/payments/merchant/refund"
---

# POST /payments/merchant/refund

`POST /payments/merchant/refund`

The Refund APIs allow merchants to process refunds for previously captured payments

## Headers

- `Idempotency-Key` string

## Request body

- Refund
  - `xIntentId` string, required — Unique identifier of the intent
  - `amount` string — The amount you want to refund, specified in the smallest unit of the currency (for example, cents for USD, paise for INR). - If you want to issue a partial refund, provide the amount you wish to refund here. For example, if the original payment was $100 (i.e., 10000 cents), and you want to refund $20, you would enter 2000. - If you leave this field blank, the full payment amount will be refunded automatically.
  - `refundReferenceId` string — Your identifier for the refund

## Response `200`

Refund API response

- RefundResponse
  - `refundId` string, required — Unique identifier of the refund
  - `intentId` string, required — Unique identifier of the payment intent
  - `amount` integer, required — The amount in lowest count unit. e.g.: For USD 1, amount is 100 representing 100 cents (The minimum amount should be greater than 1 USD)
  - `currency` string, required — Three letter abbreviation of the currency. Refer [supported currencies](/get-started/currencies-supported)
  - `refundedAt` integer, required — Epoch timestamp in milliseconds of when the refund was processed
  - `refundReferenceId` string — Your identifier for the refund

## Other responses

- `400` — unexpected error

---

[API](https://skmtc.net/xpaycheckout/apis/xpay-api-store.md) · [All operations](https://skmtc.net/xpaycheckout/apis/xpay-api-store/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpaycheckout/xpay-api-store/versions/6329a7c694bc/schema)