---
title: "Create a refund for a transaction."
method: POST
path: "/business/{business}/payments/{transaction_reference}/refunds"
---

# Create a refund for a transaction.

`POST /business/{business}/payments/{transaction_reference}/refunds`

## Path parameters

- `business` string, required
- `transaction_reference` string, required

## Request body

- object
  - `amount` number, float, required — The monetary value to be refunded.

## Response `200`

Refund processed successfully

- object[]
  - `id` integer — The unique identifier of the refund transaction.
  - `provider` string — The payment service provider for the transaction.
  - `country` string — The country associated with the refund.
  - `currency_code` string — The currency code used for the transaction.
  - `created` string, date-time — The timestamp when the refund was created.
  - `modified` string, date-time — The timestamp when the refund was last modified.
  - `operation_date` string, date-time — The date and time when the refund operation was performed.
  - `transaction_reference` string — The reference identifier of the original transaction.
  - `response` object — The response details of the refund operation.
    - `card_account` object — Details about the card account used in the transaction.
      - `issuing_country_code` string — The country code of the card issuer.
      - `masked_pan` string — The masked primary account number (PAN) of the card.
    - `customer` object — Customer details associated with the transaction.
      - `email` string — The email address of the customer.
    - `payment_data` object — Details about the payment data.
      - `id` string — The unique identifier of the payment data.
      - `remaining_amount` number, float — The remaining amount after the refund.
    - `refund_data` object — Details about the refund data.
      - `amount` number, float — The amount refunded.
      - `auth_code` string — The authorization code for the refund.
      - `created` string, date-time — The timestamp when the refund was created.
      - `currency` string — The currency used for the refund.
      - `id` string — The unique identifier of the refund transaction.
      - `is_3d` boolean — Indicates if the refund was processed through 3D Secure.
      - `status` string — The status of the refund.
    - `payment_method` string — The payment method used for the refund.
    - `merchant_order` object — Details about the merchant order.
      - `description` string — A description of the merchant order.
      - `id` string — The unique identifier of the merchant order.
  - `transaction_type` string — The type of transaction (e.g., REFUND).
  - `status` string — The status of the transaction.
  - `amount` string — The amount refunded.
  - `related_transaction_reference` string — The reference identifier of the related transaction.
  - `reason` string, nullable — The reason for the refund, if provided.
  - `is_refunded` boolean, nullable — Indicates if the transaction has been refunded.
  - `is_disputed` boolean, nullable — Indicates if the transaction is disputed.
  - `number_of_payment_attempts` integer, nullable — The number of payment attempts made for the transaction.
  - `payment_method_old` string, nullable — The previous payment method, if applicable.
  - `is_card_international` boolean — Indicates if the card used is international.
  - `card_brand` string, nullable — The brand of the card used.
  - `number_of_installments` integer — The number of installments for the transaction.
  - `incoming_request` string, nullable — Details of the incoming request, if any.
  - `metadata` string, nullable — Additional metadata associated with the transaction.
  - `tonder_intra_transaction_rate` number, float, nullable — The intra-transaction rate for Tonder.
  - `tonder_inter_transaction_rate` number, float, nullable — The inter-transaction rate for Tonder.
  - `tonder_transaction_fee` number, float, nullable — The transaction fee charged by Tonder.
  - `is_fees_computed` boolean — Indicates if the fees have been computed.
  - `fee_amount` number, float, nullable — The fee amount charged.
  - `net_amount` number, float, nullable — The net amount after fees.
  - `rolling_reserve_amount` number, float, nullable — The rolling reserve amount, if any.
  - `has_balance_transaction` boolean — Indicates if there is a balance transaction.
  - `business` object — Details about the business associated with the transaction.
    - `id` integer — The unique identifier of the business.
    - `created` string, date-time — The timestamp when the business was created.
    - `modified` string, date-time — The timestamp when the business was last modified.
    - `name` string — The name of the business.
    - `web` string — The website URL of the business.
    - `logo` string — The logo URL of the business.
    - `checkout_logo` string — The checkout logo URL of the business.
    - `background_color` string — The background color used by the business.
    - `primary_color` string — The primary color used by the business.
    - `textCheckoutColor` string — The text color used for checkout by the business.
    - `textDetailsColor` string — The text color used for details by the business.
    - `checkout_mode` boolean — Indicates if the business is in checkout mode.
    - `total_annual_sales` string — The total annual sales of the business.
    - `average_order_sale` string — The average order sale amount of the business.
    - `comission` string — The commission percentage charged by the business.
    - `status` string — The status of the business.
    - `first_time_filled` boolean — Indicates if the business information was filled for the first time.
    - `business_info` boolean — Indicates if the business information is provided.
    - `business_legal_representation` boolean — Indicates if the legal representation details of the business are provided.
    - `business_bank_details` boolean — Indicates if the bank details of the business are provided.
    - `show_presentation_data` boolean — Indicates if the presentation data is shown.
    - `enabled_smart_routing` boolean — Indicates if smart routing is enabled for the business.
    - `enabled_finances` boolean — Indicates if finances are enabled for the business.
    - `risk_level` string — The risk level of the business.
    - `timezone` string — The timezone of the business.
    - `can_change_tonder_psp` boolean — Indicates if the business can change the Tonder payment service provider (PSP).
    - `enabled_orchestration` boolean — Indicates if orchestration is enabled for the business.
    - `user` integer — The unique identifier of the user associated with the business.
    - `e_commerce_platform` string, nullable — The e-commerce platform used by the business, if any.
    - `country` integer — The country ID associated with the business.
    - `currency` integer — The currency ID associated with the business.
    - `categories` integer[] — The categories associated with the business.
  - `payment` object — Details about the payment.
    - `id` integer — The unique identifier of the payment.
    - `created` string, date-time — The timestamp when the payment was created.
    - `modified` string, date-time — The timestamp when the payment was last modified.
    - `amount` string — The amount of the payment.
    - `status` string — The status of the payment.
    - `date` string, date-time — The date of the payment.
    - `paid_date` string, date-time, nullable — The date when the payment was paid, if applicable.
    - `source` string, nullable — The source of the payment.
    - `customer_order_reference` string — The customer order reference ID.
    - `client` integer — The unique identifier of the client associated with the payment.
    - `business` integer — The unique identifier of the business associated with the payment.
    - `shipping_address` string, nullable — The shipping address for the payment.
    - `billing_address` string, nullable — The billing address for the payment.
    - `order` integer — The order ID associated with the payment.
  - `currency` object — Details about the currency used.
    - `id` integer — The unique identifier of the currency.
    - `name` string — The name of the currency.
    - `code` string — The code of the currency.
    - `symbol` string — The symbol of the currency.
    - `country` string, nullable — The country associated with the currency.
  - `payment_method` string, nullable — The payment method used.
  - `issuing_country` string, nullable — The issuing country of the payment method.

---

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