---
title: "Refund order"
method: POST
path: "/v2/payments/{token}/refund"
tags: ["Orders"]
---

# Refund order

`POST /v2/payments/{token}/refund`

Refund a fulfilled payment. The funds are reversed from the merchant's account and returned to the customer.

## Path parameters

- `token` string, string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `refundAmount` Amount, required — The monetary amount.
    - `amount` string, required — Monetary value. Example: 187.95.
    - `currency` string, required — Currency code.
  - `merchantRefundReference` string — Merchant reference for the refund. Use this to track the refund in your system.

## Response `200`

Refund processed successfully

- object
  - `token` string, required — The order token.
  - `amount` object — The refund amount.
    - `amount` string — The amount value.
    - `currency` string — The currency code (ISO 4217).
  - `merchantReference` string — The merchant reference.
  - `merchantRefundReference` string — The merchant refund reference.
  - `refundToken` string — The refund token.
  - `refundedAt` string — The date and time when the refund was processed.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `409` — Conflict

---

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