创建收款订单
大约 2 分钟
创建收款订单
提示
用于生成 USDT.TRC20 的支付数据。商户可选择直接跳转至 官方收银台 供用户支付，也可以使用数据 自定义收银台。在用户支付成功后，系统将即时进行 回调通知。
接口地址
POST https://api.tronpaid.com/api/v1/deposit/create
接口参数
| 参数名 | 含义 | 验证 | 类型 | 说明 |
|---|---|---|---|---|
| appid | appid | 必填 | string(16) | 商户 appid |
| amount | 订单金额 | 必填 | string(16) | 精确到小数点后2位, 订单币种单位 USDT |
| notify_url | 完成后回调通知地址 | 选填 | string(256) | 1. 用户支付完成后，系统会发送一个 post 消息到这个地址。2. 该参数不需要 urlencode。例如：http://www.xxx.com/pay_notify。3. 商户也可统一在后台对该参数进行配置，配置后可以不传 |
| redirect_url | 完成后同步跳转地址 | 选填 | string(256) | 1. 用户支付完成后，系统会自动跳转到这个地址。 2. 该参数不要 urlencode。例如：https://www.xxx.com/pay_return |
| order_id | 商户订单号 | 必填 | string(64) | 系统在通知商户接口时，会带上这个参数。例：201710192541 |
| attach | 商户自定义数据 | 选填 | string(64) | 商户自定义数据，回调时原路返回 |
| product_name | 商户端产品名称 | 选填 | string(64) | 该参数会显示在官方收银台页面顶部，留空则显示默认值 |
| locale | 收银台多语言 | 选填 | string(12) | 该参数指定收银台多语言，支持：中文（zh-CN），英文（en-US），默认为中文 |
| sign | 签名串 | 必填 | string(32) | 数据签名 |
接口返回
| 参数名 | 含义 | 类型 | 说明 |
|---|---|---|---|
| trade_id | 官方订单号 | string(64) | 官方订单号 |
| order_id | 商户订单号 | string(64) | 商户订单号 |
| amount | 订单金额 | string(16) | 订单金额，原数据返回 |
| actual_amount | 订单支付金额 | string(16) | 订单实际需要支付的金额 |
| token | 订单收款地址 | string(64) | 商户配置的接收用户支付的钱包地址 |
| payment_url | 官方收银台地址 | string(256) | 官方收银台 url 地址，商户可直接跳转到该地址供用户支付 |
| notify_url | 完成后回调通知地址 | string(256) | 用户支付完成后，系统会发送一个 post 消息到这个地址 |
| redirect_url | 完成后同步跳转地址 | string(256) | 用户支付完成后，系统会自动跳转到这个地址 |
| expiration_time | 订单过期时间 | int | 订单过期时间(Unix时间戳)，单位 秒 |
| product_name | 商户端产品名称 | string(64) | 该参数会显示在官方收银台页面顶部，留空则显示默认值 |
| locale | 收银台多语言 | string(12) | 收银台多语言，默认为中文 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"trade_id": "202307091688832169091964",
"order_id": "1688832169",
"amount": "100",
"actual_amount": "100",
"token": "TYDiUX1GvAvyj4F6HLbVedg7FFXa4jUvAT",
"expiration_time": 1688832769,
"payment_url": "https://api.tronpaid.com/pay/check/202307091688832169091964",
"notify_url": "https://xxxx/transaction/create",
"redirect_url": "https://xxxx/transaction/create",
"product_name": "your product name",
"locale": "zh-CN"
},
"request_id": "8282f031-63a2-4229-b0a8-e2a5c1c84b29"
}