---
title: "Refund"
method: POST
path: "/v3/transactions/refund"
tags: ["Transactions"]
---

# Refund

`POST /v3/transactions/refund`

This API endpoint supports two refund flows. Include `originalTransactionId` for a linked refund against a previous sale; omit it for a blind credit refund. The final approval/decline result is delivered asynchronously to the callbackURL.

## Headers

- `Authorization` string, required
- `X-Idempotency-Key` string, uuid, required

## Request body

- RefundRequest
  - `tenantId` string, required — The last 12 digits of the merchant identifier (MID).
  - `terminalId` string, required — 10-digit terminal serial number.
  - `transactionId` string, required — Client-generated transaction identifier used for reconciliation.
  - `originalTransactionId` string, nullable — Original sale transaction identifier for a linked refund. Omit this field to run the existing blind credit refund flow.
  - `tenderType` 'CREDIT' | 'DEBIT', required — Tender type used on the original transaction.
  - `amount` object, required — Message amount providing total and currency for refunds.
    - `total` number, required — The total amount to be refunded, in cents.
    - `currency` string, required — The three-letter alphabetic ISO currency code.
  - `reason` string, nullable — Reason for the Refund.
  - `printReceipt` 0 | 1 | 2 | 3, required — Allowed values: <br> 0 – No receipt<br> 1 – Print merchant receipt<br> 2 – Print customer receipt<br> 3 – Print both merchant and customer receipts
  - `callbackURL` string, required — HTTPS endpoint that receives the asynchronous callback payload.
  - `metadata` object

## Response `200`

Transaction Initiated

- SuccessResponse
  - `traceId` string, uuid — Correlation identifier matching the initial API response traceId
  - `response` object
    - `status` 'SUCCESS' — Whether the original request was successful.

## Other responses

- `400` — Invalid Request

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/revisions/face82bdd778/schema)