> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Refund

> A Tazapay API object that is used to return money to a customer after a payment has been made. It simplifies the process of issuing refunds for products or services, helping businesses maintain customer satisfaction.

## Object Structure

```json JSON expandable theme={null}
{
  "id": "rfd_afiuabfia23wifaiofnioa12nfianf",
  "object": "refund",
  "payin": "chk_cirsp2sl4ar024j0akj0",
  "amount": 90000,
  "currency": "USD",
  "customer_receives": {
      "currency": "SGD",
      "amount": 133200
    },
  "payment_attempt": "pat_ahbfiuahfiuaiofnioain",
  "reason": "Damaged Goods",
  "metadata": {
      "key1": "value1",
      "key2": "value2"
    },
  "status": "succeeded",
  "status_description": "",
  "webhook_url": "https://mystore.webhook.tazapay.refund/",
  "created_at": "2023-07-23 23:59:56"
}
```

## Parameters

### Refund

| Field               | Subfield | Type                   | Description                                                                                             |
| :------------------ | :------- | :--------------------- | :------------------------------------------------------------------------------------------------------ |
| id                  |          | string                 | The unique Tazapay identifier for the refund.                                                           |
| object              |          | string                 | The type of object, which is "refund".                                                                  |
| payin               |          | string                 | The unique Tazapay ID of the related payin transaction.                                                 |
| amount              |          | number                 | The total amount being refunded.                                                                        |
| currency            |          | string                 | The currency in which the refund was made (e.g., USD).                                                  |
| customer\_receives  |          | object                 | The amount and currency received by the customer after the refund.                                      |
|                     | currency | string                 | The currency in which the customer receives the refund.                                                 |
|                     | amount   | number                 | The amount the customer receives after the refund.                                                      |
| payment\_attempt    |          | string                 | The unique Tazapay ID of the payment attempt associated with the refund.                                |
| reason              |          | string                 | The reason for the refund (e.g., "Damaged Goods").                                                      |
| metadata            |          | json                   | Set of key-value pairs attached to the refund object.                                                   |
| status              |          | enum                   | The current status of the refund \[Values - Requested, Pending, Initiated, Succeeded, Failed, Rejected] |
| status\_description |          | string                 | A description of the current refund status.                                                             |
| webhook\_url        |          | string                 | The URL for webhook notifications related to the refund.                                                |
| created\_at         |          | string (ISO timestamp) | The timestamp when the refund was created.                                                              |