POST
/
business
/
{business}
/
payments
/
{transaction_reference}
/
refunds
curl --request POST \
  --url https://stage.tonder.io/api/v1/business/{business}/payments/{transaction_reference}/refunds \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 10.5
}'
[
  {
    "id": 17,
    "provider": "tonder",
    "country": "N/A",
    "currency_code": "MXN",
    "created": "2024-06-28T08:15:24.600617-05:00",
    "modified": "2024-06-28T08:15:24.600654-05:00",
    "operation_date": "2024-06-28T13:15:23-05:00",
    "transaction_reference": "16566015",
    "response": {
      "card_account": {
        "issuing_country_code": "IL",
        "masked_pan": "458000...0059"
      },
      "customer": {
        "email": "test@email.com"
      },
      "payment_data": {
        "id": "16563893",
        "remaining_amount": 40
      },
      "refund_data": {
        "amount": 5,
        "auth_code": "gUuMXr",
        "created": "2024-06-28T13:15:23Z",
        "currency": "MXN",
        "id": "16566015",
        "is_3d": true,
        "status": "COMPLETED"
      },
      "payment_method": "BANKCARD",
      "merchant_order": {
        "description": "Requested by the client",
        "id": "TNDR-76b9de76-eeee-42e9-b4bf-255943831ee9"
      }
    },
    "transaction_type": "REFUND",
    "status": "Success",
    "amount": "5.0000",
    "related_transaction_reference": "16563893",
    "reason": "<string>",
    "is_refunded": true,
    "is_disputed": true,
    "number_of_payment_attempts": 123,
    "payment_method_old": "<string>",
    "is_card_international": true,
    "card_brand": "<string>",
    "number_of_installments": 1,
    "incoming_request": "<string>",
    "metadata": "<string>",
    "tonder_intra_transaction_rate": 123,
    "tonder_inter_transaction_rate": 123,
    "tonder_transaction_fee": 123,
    "is_fees_computed": true,
    "fee_amount": 123,
    "net_amount": 123,
    "rolling_reserve_amount": 123,
    "has_balance_transaction": true,
    "business": {
      "id": 97,
      "created": "2024-02-13T13:34:54.796510-06:00",
      "modified": "2024-06-26T19:12:49.988659-05:00",
      "name": "Demo 7",
      "web": "www.google.com",
      "logo": "https://zplit-stage.s3.amazonaws.com/media/business_logos/Web_1920__13dsjcejd2x.png",
      "checkout_logo": "https://zplit-stage.s3.amazonaws.com/media/business_checkout_logos/Web_1920__13dsjcejd2x.png",
      "background_color": "#f2f2f2",
      "primary_color": "#1c202b",
      "textCheckoutColor": "#ffffff",
      "textDetailsColor": "#1c202b",
      "checkout_mode": true,
      "total_annual_sales": "L",
      "average_order_sale": "0.00",
      "comission": "5.00",
      "status": "A",
      "first_time_filled": true,
      "business_info": true,
      "business_legal_representation": true,
      "business_bank_details": true,
      "show_presentation_data": true,
      "enabled_smart_routing": true,
      "enabled_finances": true,
      "risk_level": "Low",
      "timezone": "America/Mexico_City",
      "can_change_tonder_psp": true,
      "enabled_orchestration": true,
      "user": 792,
      "e_commerce_platform": "<string>",
      "country": 1,
      "currency": 5,
      "categories": [
        1
      ]
    },
    "payment": {
      "id": 24943,
      "created": "2024-06-27T18:43:37.519849-05:00",
      "modified": "2024-06-27T18:43:38.523950-05:00",
      "amount": "45.0000",
      "status": "PENDING",
      "date": "2024-06-27T18:43:37.519966-05:00",
      "paid_date": "2023-11-07T05:31:56Z",
      "source": "<string>",
      "customer_order_reference": "TNDR-76b9de76-eeee-42e9-b4bf-255943831ee9",
      "client": 846,
      "business": 97,
      "shipping_address": "<string>",
      "billing_address": "<string>",
      "order": 28579
    },
    "currency": {
      "id": 5,
      "name": "Mexican Peso",
      "code": "MXN",
      "symbol": "$",
      "country": "<string>"
    },
    "payment_method": "<string>",
    "issuing_country": "<string>"
  }
]

The Authorization needs to be in the following format:

Authorization: Token <YOUR_API_KEY>

Use this endpoint to refund a payment, either partially or in full.

Path Parameters

business
string
required

The unique identifier of the business.

transaction_reference
string
required

The unique reference of the transaction to be refunded.

Body

application/json
amount
number
required

The monetary value to be refunded.

Response

200 - application/json
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

The timestamp when the refund was created.

modified
string

The timestamp when the refund was last modified.

operation_date
string

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.

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

The reason for the refund, if provided.

is_refunded
boolean | null

Indicates if the transaction has been refunded.

is_disputed
boolean | null

Indicates if the transaction is disputed.

number_of_payment_attempts
integer | null

The number of payment attempts made for the transaction.

payment_method_old
string | null

The previous payment method, if applicable.

is_card_international
boolean

Indicates if the card used is international.

card_brand
string | null

The brand of the card used.

number_of_installments
integer

The number of installments for the transaction.

incoming_request
string | null

Details of the incoming request, if any.

metadata
string | null

Additional metadata associated with the transaction.

tonder_intra_transaction_rate
number | null

The intra-transaction rate for Tonder.

tonder_inter_transaction_rate
number | null

The inter-transaction rate for Tonder.

tonder_transaction_fee
number | null

The transaction fee charged by Tonder.

is_fees_computed
boolean

Indicates if the fees have been computed.

fee_amount
number | null

The fee amount charged.

net_amount
number | null

The net amount after fees.

rolling_reserve_amount
number | null

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.

payment
object

Details about the payment.

currency
object

Details about the currency used.

payment_method
string | null

The payment method used.

issuing_country
string | null

The issuing country of the payment method.