---
title: "Create Refunds"
method: POST
path: "/payouts/refunds"
tags: ["Refunds"]
---

# Create Refunds

`POST /payouts/refunds`

Creates and queues a refund payment for approval or rejection. Refunds are always returned to the originating account of the corresponding payment. The total refund amount cannot exceed the original payment. For processing amounts greater than the original payment, please refer to payouts.

## Headers

- `Content-Type` string, required

## Request body

- object[]
  - `payment_id` string, required — Unique identifier for the corresponding intitiated payment
  - `amount` integer, required — The refund amount to be processed.
  - `currency` string — The ISO 3 letter currency code for the account stores value in.
  - `reason_code` 'FRAUDULENT_PAYMENT' | 'ORDER_CANCELLED' | 'DUPLICATED_PAYMENT' | 'CUSTOMER_REQUEST', required — Code indicating the reason for the refund
  - `description` string — Additional notes about the refund being created. Can include order references/customer-id for the refund being generated.
  - `external_reference` string — Useful for tracking and reporting the transaction on your end. e.g You can enter transaction ID of this refund maintained in your system
  - `status` 'CREATED' | 'APPROVED' — Refers to the transaction status of the refund being created.

## Response `201`

- object[]
  - `refund_id` string, required — Unique identifier for the refund inititated
  - `payment_id` string, required — Unique identifier for the payment inititated
  - `status` 'CREATED' | 'APPROVED' | '', required — Status of the payment. Default is INITIATED. Acceptable values: INITIATED or CONFIRMED
  - `amount` number, required — The refund amount to be processed.
  - `currency` string, required — The ISO 3 letter currency code for the refund amount
  - `reason_code` 'CUSTOMER_REQUEST' | 'DUPLICATED_PAYMENT' | 'ORDER_CANCELLED' | 'FRAUDULENT_PAYMENT', required — Code indicating the reason for the refund
  - `description` string, required — Additional notes about the refund being created. Can include order references/customer-id for the refund being generated
  - `external_reference` string, required — Useful for tracking and reporting the transaction on your end. e.g You can enter transaction ID of this refund maintained in your system
  - `beneficiary` object
    - `name` string, required — Defines the name of the benefeciary.
    - `iban` string, required — Defines the IBAN of the benefeciary
    - `city` string, required — Defines city of Benefeciary. Defaults to Dubai

---

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