> ## 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.

# 业务对象

退款（Refund）业务对象字段说明

| 属性名             | 类型                 | 描述                                                            |
| --------------- | ------------------ | ------------------------------------------------------------- |
| refund\_id      | string             | 退款单ID                                                         |
| trade\_id       | string             | 交易单ID                                                         |
| currency        | string             | 金额对应的交易币种，编码遵照ISO4217                                         |
| callback\_url   | string             | Webhook通知回调地址                                                 |
| reason          | string             | 退款原因                                                          |
| refund\_amount  | string             | 退款金额                                                          |
| refund\_status  | string             | 退款状态<br />pending: 处理中<br />failed: 退款失败<br />succeeded: 退款成功 |
| metadata        | map\[string]string | 元数据                                                           |
| failure\_reason | FailureReason      | 退款失败原因                                                        |
| ref\_arn        | string             | 发卡行侧返回退款凭证                                                    |
| finished\_at    | string             | 退款完成时间                                                        |

## FailureReason

| 属性名              | 类型     | 描述         |
| ---------------- | ------ | ---------- |
| code             | string | 系统返回交易返回码  |
| message          | string | 系统返回交易返回说明 |
| channel\_code    | string | 渠道返回码      |
| channel\_message | string | 渠道返回说明     |
| raw\_error       | string | 原始错误信息     |