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

# Object

Refund entity field reference.

## Business object

| Field           | Type               | Desc                                                                                                                             |
| --------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| refund\_id      | string             | Refund ID                                                                                                                        |
| trade\_id       | string             | Trade ID                                                                                                                         |
| currency        | string             | Transaction currency corresponding to the amount, encoded according to ISO4217                                                   |
| callback\_url   | string             | Webhook notification callback URL                                                                                                |
| reason          | string             | Refund reason                                                                                                                    |
| refund\_amount  | string             | Refund amount                                                                                                                    |
| refund\_status  | string             | Refund status<br />pending: Processing<br />failed: Refund failed<br />succeeded: Refund successful                              |
| metadata        | map\[string]string | A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format. |
| failure\_reason | FailureReason      | Refund failure reason                                                                                                            |
| ref\_arn        | string             | Refund credential returned by the issuing bank                                                                                   |
| finished\_at    | string             | Refund completion time                                                                                                           |

### FailureReason

| Field            | Type   | Desc                                           |
| :--------------- | :----- | :--------------------------------------------- |
| code             | string | System returned transaction return code        |
| message          | string | System returned transaction return description |
| channel\_code    | string | Channel return code                            |
| channel\_message | string | Channel return description                     |
| raw\_error       | string | Raw error information                          |