Skip to main content

创建订单

tip

用于生成 USDT-TRC20 支付数据. 商户可选择直接跳转至 官方收银台 供用户支付,也可以使用数据 自定义收银台.在用户支付成功后,系统将即时进行 回调通知.

接口地址

POST https://api.tusdtapi.com/v1/CreateOrder

入参示例

{
"legal_tender_money": 100,
"currency_type": "CNY",
"out_order_no": "201710192541",
"address": "TVShVcCdEF8MQnc8Pmn9PgUxokr2QC4hxi",
"notify_url": "http://www.xxx.com/notify",
"redirect": "https://www.xxx.com/return",
"attach": "附加参数",
"app_name": "商户端产品名称"
}

接口请求示例-(加密后)

curl -X POST 'https://api.tusdtapi.com/v1/CreateOrder' \
-H 'T-API-KEY:gGsZe8TiALbpRdUwXqbbXh' \
-H 'Content-Type:application/json' \
-d '{"s":"F454385581A150229AFFA530180BEB9E523FF107CBC22FB8CBB2D02C7F506AFBE2CBA03607B9D50FE6AC0B294D428C5B6C3F3325958C6C5D23ACE4DC70865DA69BF9B68D1719E1E08E9E45FB5B9BFADFA0AFE0CB79CC7AC4441BA3C8B3DC8D3076E6A65E07C083F7DA47FDB8EEC45D9E2AC64D9BFDE6F2A0D7FC4CA85005BC1CD78BF53D39B74C07AECB3558720E9774CBE48C1C09CC4C00B34D8E15B1BFD2E12F79F308D7E63BF50ED95CD3FFC1A959972FA8966108FB0A8632301653ACB0D5A5E681A369546378C2F74408283FCD77F34FBB88C4041455B6BB8915EBA3BF4C1243CCA78E6A1C8188F63A092EB799AF8F1ABD61414841DE8D0E092B934319BD36990EAEA3AF39E7CE42B4DBD0EAB3E59B6F855A5A9AFA25333CE44F8B1EB99237D12FF37EE6A3C8BD3264A4F5DF235B3BDDB7B84A1C7C264A0FD1F95E887459"}'

接口返回示例

{
"code": 200,
"data": "7061702e349527bd440cc0ff239389dd30734985effe8be7b12c2fe00f4f4ced34be6ff35b34ea663c82cd73c9633ff5408f9fb2a1429999016b2a125e38e16e39cd2bd6576e5e405d071ff43f26e355f9733ccf345cc91f55dcac84cddd27e9237d2002cc12157fd190e2e8ba30588b325eb33072afe1e8c1ec0deeebe81da9182395dd2df50ae5f54fa2b71ec8e7cb85f315403bec4d3be39b78f7a3ecce573a0eac0d9e6f45a7957cbc74446718d48749700773cafb114ca3b42cbf6b42e2570ba31deada3678dca6024d13e8775077cc432b2bf09b56676df3fb5947abb5dc4c6ced5d4ea6ba4976242099849e8f174b74e1fef7eaac20348b7a88397b130f058d0e883de2e4259088fad518db3880c6da667bd3b73b3a6a9caca178fd325c72b9d331da2112f2ebcabd12008a7b9f62dd2540aebca14254db220c72c45bfb2961844eaebdc04e70a32146b1a382dcb654f064b289717cb0c679c7e3fd52c6d5254901a97e05f846191c6798f3af5b19f2e459e13e924dd2b3bdf16f9825e042b15365b95df8bc151cc336f2339ca970fb0106a42bf4a1ee20290ac729904e352f23b284f37c602da9e67971bd72ae86a6e692a0269ca9ec961b0cb2920ad7fb6cf535b15d07ec12657951225e10d7e614fc09d8bf75d48d970985114787064c161f4a58e5a76422dd5c6fde2947b4b433e54ecb8c6697bd1ed69018b130c8a5e00533acdf741b64b67e7ccdeca56b8809706ca268117b12f572dc37251afd98636ed2356277029bd3e89a502b5dbe9a4a025139499fc4b918ef930b402c54b73eaa782ca29fdd6c70239ce568579a141da90d19b897e1b96b7df5cc8827"
}

返回示例-(解密后)

{
"address": "TVShVcCdEF8MQnc8Pmn9PgUxokr2QC4hxi",
"app_name": "商户端产品名称",
"attach": "附加参数",
"cashier_qrcode": "https://panel.tusdtapi.com/api/qrcode?order_no=1687782852OD0B74A502FBB36525",
"cashier_url": "https://panel.tusdtapi.com/api/cashier?order_no=1687782852OD0B74A502FBB36525",
"currency_rate": 7.232,
"currency_type": "CNY",
"expire_time": 111111111,
"legal_tender_money": 100,
"locale": "zh",
"order_money": 13.827,
"order_no": "1687782852OD0B74A502FBB36525",
"order_timestamp": 11111111,
"out_order_no": "201710192541",
"pay_money": 13.827,
"pay_status": 1,
"pay_type": "USDT"
}

接口参数

参数名含义是否必填类型说明
legal_tender_money订单金额(法币)
必填 ✅
float根据币种汇率转换为USDT金额
currency_type订单币种必填 ✅string订单币种单位.支持:CNYUSDUSDT.
out_order_no商户端订单号必填 ✅string回调时原样返回.例:201710192541.
address订单收款地址选填 🔵string当前订单使用的收款地址(必须已配置且可用,否则返回失败),如果不填则从已配置的地址选择最新配置的可用地址.
notify_url完成后回调通知地址选填 🔵string用户支付完成后,系统会发送一个 post 消息到这个地址.该参数不要转码.例如:http://www.xxx.com/notify . 商户可以在后台设置全局通知地址
redirect完成后同步跳转地址选填 🔵string使用默认收银台:用户支付完成,系统会自动跳转到这个地址.该参数不要转码.例如:https://www.xxx.com/return.
attach附加参数选填 🔵string可以为用户名,也可以为数据库中的用户编号,可以为一个 json 数据,回调时原样返回.
app_name商户端产品名称选填 🔵string该参数会显示在官方收银台页面顶部,留空则显示默认值。

接口返回

参数名含义类型说明
order_no订单号string系统内部订单编号
out_order_no商户端订单号string原数据返回
legal_tender_money订单金额float原数据返回
currency_type订单币种string原数据返回
currency_rate汇率floatUSDT-法币(CNY\USD)汇率
order_money订单 USDT 金额float经过汇率转换后的 USDT 订单金额,由 订单金额 + 订单币种 按照 USDT 汇率转换而来
pay_money订单 支付 USDT 金额float该订单用户需要支付的 USDT 金额,可能与order_money,付款金额必须与该金额一致才会完成订单
address订单收款地址string商户配置的接收用户支付的钱包地址
cashier_url收银台地址string默认收银台 url 地址,商户可直接跳转到该地址供用户支付.
cashier_qrcode收款码地址string供钱包扫码支付的二维码地址.
order_timestamp订单创建时间戳int30分钟后订单过期
expire_time订单过期时间戳int订单过期时间,单位 .
汇率

USDT-法币(CNY\USD)汇率默认根据市场行情调整,商户可在后台设置固定汇率.