---
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`

## Request

- Base URL: `https://api-stage.tonder.io/api/v1`
- URL: `https://api-stage.tonder.io/api/v1/business/{business}/payments/{transaction_reference}/refunds`
- Auth: none required

## 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.dev/tonderio/apis/tonder.md) - [All operations](https://skmtc.dev/tonderio/apis/tonder/llms.txt) - [OpenAPI document](https://skmtc.dev/tonderio/apis/tonder/revisions/aface34fb9b2?raw)
