---
title: "Create Refund"
method: POST
path: "/v3/refunds"
---

# Create Refund

`POST /v3/refunds`

## Request

- Base URL: `https://apitest.myfatoorah.com`
- URL: `https://apitest.myfatoorah.com/v3/refunds`
- Auth: HTTP bearer

## Request body

- object
  - `PaymentId` string, required: The paymentId for which the refund will be created.
  - `Amount` number, required: The amount to be refunded
  - `ExternalIdentifier` string: External data associated with the refund, which will be received in the webhook.
  - `SupplierRefundedAmount` object[]: Specifies the refund amount allocated to each supplier (if a supplier participated in the payment).
    - `Code` string: The supplier code.
    - `Amount` number: This is the amount that will be deducted from the supplier in the refund process. It will be part form the total amount.
  - `Comment` string: Extra comments for your reference
  - `ServiceChargeOnCustomer` boolean: Determine whether the customer will be charged for the service fees or not. Service fees are charged by MyFatoorah.

## Response `201`

Refund Created Successfully

- object
  - `IsSuccess` boolean: Indicates if the request was successful.
  - `Message` string: Response message associated with the request.
  - `ValidationErrors` object[]
    - `Name` string: Name of the field with validation error.
    - `Error` string: Description of the validation error.
  - `Data` object
    - `Refund` object: Contains the created refund details.
      - `Id` string: Unique identifier of the refund, which can be used later to inquire about the refund status.
      - `Reference` string: The refund reference generated by MyFatoorah for following up with the finance team.
      - `Status` string: Current status of the refund. It will initially be "Pending". You can rely on the Refund Status Changed webhook once the refund status is updated.
      - `InvoiceId` string: The InvoiceId of the refunded amount.
      - `ExternalIdentifier` string: External identifier provided in the request.
      - `CreationDate` string: Date and time when the refund was created.
      - `RefundDate` string: Date and time when the refund was completed. This will be empty while the refund is pending.
      - `RRN` string: Refund Reference Number that the customer can use to check the refund with their bank. It will be empty initially.
      - `Comment` string
      - `VendorComment` string: Comment provided in the refund request.
    - `Amount` object: Contains the refund amount and its distribution.
      - `BaseCurrency` string: Base currency of the account
      - `ValueInBaseCurrency` number: Total refund amount in the base currency.
      - `Distribution` object
        - `Vendor` number: Amount that will be deducted from the vendor for the refund.
        - `Suppliers` object[]: Amount that will be deducted from the suppliers for the refund.
          - `Code` string: Supplier code.
          - `Amount` number: Amount refunded by the supplier.
    - `ReferencedInvoice` object: Contains details of the original invoice.
      - `Id` string: Id of the original invoice.
      - `Reference` string: Reference number of the original invoice.
      - `ExternalIdentifier` string: External identifier of the original invoice.
      - `PaymentMethod` string: Payment method used for the original payment.
      - `BaseCurrency` string: The base currency of your account (e.g., KWD).
      - `ValueInBaseCurrency` string: The total value of the original invoice in base currency.
      - `RemainingValueInBaseCurrency` string: The remaining amount in base currency after the refund.

## Changes

- **2026-11-03** `00639fc15f06`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/changes/v3/refunds/post.md)

---

[API](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3.md) - [All operations](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v3/revisions/00639fc15f06?raw)