> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/chinese/shuo-ming/shu-ju-jie-gou.md).
# 数据结构
{% hint style="info" %}
说明
CurrencyDetail
{% endhint %}
#### 币种详情
| 名称 | 类型 | 说明 | 示例 |
| ------------------------ | ------- | --------------------- | ------------------------------------------------------------ |
| network | string | 网络 | 示例值：`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` |
| chain | string | 所属公链 | 示例值：`TRON`、`ETHEREUM`、`BSC` |
| code | string | 币种代码 | |
| currency | string | 币种 | |
| name | string | 名称 | |
| logo | string | LOGO | |
| contract\_address | string | 合约地址 | |
| decimal | integer | 精度 | |
| is\_fiat | integer | 是否是法币 | 是 `1` 否`0` |
| payment\_qr\_code | integer | 是否支持扫码支付 | 是 `1` 否`0` |
| payment\_connect\_wallet | integer | 是否支持 ConnectWallet 支付 | 是 `1` 否`0` |
| payment\_tron\_link | integer | 是否支持 tronlink 支付 | 是 `1` 否`0` |
| min\_payment\_amount | integer | 最小支付金额 | |
| max\_payment\_amount | integer | 最大支付金额 | |
#### 交易详情
{% hint style="info" %}
说明
TransactionDetail
{% endhint %}
| 名称 | 类型 | 说明 | 示例 |
| -------------------------- | ------- | -------------------------------------------------------- | ------------------------------------------------------------ |
| out\_trade\_no | string | 商户订单号 | |
| transaction\_id | string | 平台订单号 | |
| description | string | 订单描述（utf8-mb4） | |
| block\_no | integer | 区块号，也可以通过这个查询区块 hash | |
| create\_time | integer | 订单创建时间 | |
| block\_time | integer | 区块时间 | |
| pay\_time | integer | 支付时间(成功才有) | |
| tx\_id | string | 交易 hash | |
| from\_address | string | 支付地址 | |
| contract\_address | string | 合约地址 | |
| to\_address | string | 资金转入地址 | |
| amount | integer | 订单金额 | |
| decimals | integer | 订单金额精度 | |
| pay\_amount | integer | 实际支付金额 | |
| pay\_decimal | integer | 实际支付金额精度 | |
| pay\_currency | string | 实际支付币种 | |
| pay\_chain | string | 实际支付公链 TRON、ETHEREUM、BSC | |
| attach | string | 附加数据，在查询 API 和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段。 | |
| service\_amount | integer | 手续费 | |
| service\_amount\_currency | string | 手续费币种 | |
| handle\_status | integer | 处理状态 | 1待处理 2处理中 3已处理 4待验证 |
| status | integer | 状态 | 1 未支付 2 支付成功 3 转入退款 4 已关闭 |
| currency | object | 支付币种详情 | |
| currency.network | string | 网络 | 示例值：`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` |
| currency.chain | string | 所属公链 | 示例值：`TRON`、`ETHEREUM`、`BSC` |
| currency.code | string | 币种代码 | |
| currency.currency | string | 币种 | |
| currency.name | string | 名称 | |
| currency.contract\_address | string | 合约地址 | |
| currency.decimal | integer | 精度 | |
#### 交易通知详情
{% hint style="info" %}
说明
TransactionNotifyDetail
{% endhint %}
| 名称 | 类型 | 说明 | 示例 |
| ----------------- | -------------- | -------------------------------------------------------- | ----------------------------- |
| out\_trade\_no | string | 商户订单号 | |
| transaction\_id | string | 平台订单号 | |
| description | string | 订单描述（utf8-mb4） | |
| block\_no | integer | 区块号，也可以通过这个查询区块 hash | |
| create\_time | integer | 订单创建时间 | |
| block\_time | integer | 区块时间 | |
| pay\_time | integer | 支付时间(成功才有) | |
| tx\_id | string | 交易 hash | |
| from\_address | string | 支付地址 | |
| contract\_address | string | 合约地址 | |
| to\_address | string | 资金转入地址 | |
| amount | integer | 订单金额 | |
| decimals | integer | 订单金额精度 | |
| currency | CurrencyDetail | 币种详情 | |
| pay\_amount | integer | 实际支付金额 | |
| pay\_decimal | integer | 实际支付金额精度 | |
| pay\_currency | string | 实际支付币种 | |
| pay\_chain | string | 实际支付公链 TRON、ETHEREUM、BSC | |
| attach | string | 附加数据，在查询 API 和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段。 | |
| handle\_status | integer | 处理状态 | 1`待处理` 2`处理中` 3`已处理` 4`待验证` |
| status | integer | 状态 | 1`未支付` 2`支付成功` 3`转入退款` 4`已关闭` |
| sign | string | 签名 | |
| price\_rate | folat | 汇率 | |
#### 代付交易详情
{% hint style="info" %}
说明
PayAnotherTransactionDetail
{% endhint %}
| 名称 | 类型 | 说明 | 说明 |
| -------------------------- | ------- | -------- | ------------------------------------------------------------------------------- |
| out\_trade\_no | string | 商户订单号 | 示例值：`fb72xxxx-xxxx-xxxx-xxxx-xxxx8a7b52cb` |
| transaction\_id | string | 平台订单号 | 示例值：`e98b30294xxxxxxxxxxxx97a9d9e09ce` |
| trade\_type | string | 交易类型 | DAPP、TRANSFER、API |
| description | string | 订单描述 | 示例值：`充值` |
| block\_no | integer | 区块号 | 示例值：`33215220` |
| create\_time | integer | 订单创建时间 | 示例值：`1673407302044` |
| block\_time | integer | 区块时间 | 示例值：`1673407329000` |
| pay\_time | integer | 支付时间 | 示例值：`1673407329000` |
| tx\_id | string | 交易 hash | 示例值：`9fdf0ab5823e23225f93bcc644af30a6ab83b6583a8e29e359ee80219802a33a` |
| from\_address | string | 支付地址 | 示例值：`TULRFYoFuEmUbxxxxxxxx8nQYFHJ88888` |
| contract\_address | string | 合约地址 | 示例值：`TR7NHqjeKQxGTxxxxxxxxpL8otSzgjLj6t` |
| to\_address | string | 收款地址 | 示例值：`TQjxEW2Z3p9wjoxxxxxxxxgJUrWXBun91w` |
| amount | number | 订单金额 | 示例值：`15000000` |
| pay\_chain | integer | 实际支付公链 | 示例值：`TRON`、`ETHEREUM`、`BSC`[查看支持公链](/chinese/huo-bi/cha-xun-bi-zhong-xin-xi.md) |
| decimals | integer | 代币精度 | 示例值：`6` |
| pay\_network | string | 类型 | 示例值：TRX、TRC10、TRC20、TRC721、TRC1155、ERC20、BEP20 |
| pay\_currency | string | 实际支付币种 | |
| pay\_amount | integer | 实际支付金额 | |
| pay\_decimal | integer | 实际支付金额精度 | |
| attach | string | 自定义参数 | 在查询 API 和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段 |
| service\_amount | number | 手续费 | 示例值：`45000` |
| service\_rate | folat | 服务费费率 | |
| service\_amount\_currency | string | 手续费 | 示例值：`USDT` |
| status | integer | 状态 | 示例值：`1`未支付 `2`支付成功 `3`转入退款 `4`已关闭 |
| handle\_status | integer | 处理状态 | 示例值：`1`待处理 `2`处理中 `3`已处理 `4`待验证 |
| currency | object | 支付代币 | |
| currency.network | string | 网络 | 示例值：`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` |
| currency.chain | string | 所属公链 | 示例值：`TRON`、`ETHEREUM`、`BSC` |
| currency.code | string | 币种代码 | |
| currency.currency | string | 币种 | |
| currency.name | string | 名称 | |
| currency.contract\_address | string | 合约地址 | |
| currency.decimal | integer | 精度 | |
#### 商户余额
{% hint style="info" %}
说明
merchantBalance
{% endhint %}
| 名称 | 类型 | 说明 | 说明 |
| ------------ | ------- | ----- | ------------------------------------------------------------ |
| merchant\_id | integer | 商家 ID | 示例值：`1234567890` |
| mch\_id | string | 商户 ID | 示例值：`12345678` |
| network | string | 网络 | 示例值：`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` |
| chain | string | 所属公链 | 示例值：`TRON`、`ETHEREUM`、`BSC` |
| balance | string | 余额 | |
| currency | string | 币种 | |
| decimal | integer | 精度 | |
| create\_time | integer | 创建时间 | 示例值：`1673333676` |
| modify\_time | integer | 修改时间 | 示例值：`1673333676` |
| cash\_time | integer | 提现时间 | 示例值：`1673333676` |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://apidoc.tokenpay.me/chinese/shuo-ming/shu-ju-jie-gou.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.