创建订单
路径:
POST open/api/payment
必须保留响应中的orderNo,它是用于订单查询的唯一标识符。
参数
请求参数
参数名 | 签名 | 必传 | 类型 | 长度 | 备注 |
|---|---|---|---|---|---|
appId | Y | Y | string | 64 | 商户的唯一标识符 |
sign | N | Y | string | 256 | 签名 |
merchantOrderNo | Y | Y | string | 64 | 客户交易ID |
orderAmount | Y | Y | string | 64 | 订单金额(单位为分) |
payCurrency | Y | Y | string | 64 | 支付货币(EUR / USD) |
userId | Y | Y | string | 128 | 用户的唯一标识符(邮箱 / 手机号码) |
paymentExchange | Y | N | string | 512 | 前提条件:支付方式已配置交易所方式 1.指定交易所,可多次转账 |
paymentTokens | Y | N | string | 128 |
|
redirectURL | N | N | string | 512 | 成功购买后的重定向地址 |
callbackURL | N | N | string | 512 | 接收订单Webhook的地址 |
customParam | N | N | string | 512 | 商户自定义参数 |
支持的token:
| Crypto | Network |
|---|---|
| USDT | TRX, BSC, ETH, SOL |
| USDC | TRX, BSC, ETH, SOL |
| ETH | ETH, BSC |
| BTC | BTC |
| PCI | ETH, PCI |
支持交易所代码:
| Exchange | Code |
|---|---|
| Kraken | 16f021b0-f220-4bbb-aa3b-82d423301957 |
| Paxos | 2fdd678d-8ece-49f5-992c-a1d7c4367833 |
| Bybit | 3b8d8911-b2c0-4c1a-9127-675653c21960 |
| Coinbase | 47624467-e52e-4938-a41a-7926b6c27acf |
| Robinhood | 6e192ebb-a073-4055-bbd7-d644539c9a20 |
| Binance | 9226e5c2-ebc3-4fdd-94f6-ed52cdce1420 |
請求示例:
{
"appId": "TEST000001",
"sign": "TEST000001",
"merchantOrderNo": "11126",
"userId": "[email protected]",
"orderAmount": "1000",
"payCurrency": "USD",
"paymentTokens": "USDT,ETH",
"paymentExchange": "16f021b0-f220-4bbb-aa3b-82d423301957,9226e5c2-ebc3-4fdd-94f6-ed52cdce1420",
"redirectURL": "http://127.0.0.1:8022/open/api/payment2",
"callbackURL": "http://127.0.0.1:8022/open/api/callback"
}响应参数说明
| 参数名 | 类型 | 详情 |
|---|---|---|
| success | boolean | 是否成功 |
| error | boolean | 是否出错 |
| code | long | 响应代码 |
| msg | string | 响应消息 |
| traceId | string | 追踪 ID |
| model | object | 响应详细信息 |
| checkout address | string | 收銀台网址 |
响应示例
{
"code": "0",
"msg": "success",
"model": {
"webUrl": "htts://127.0.0.1:8080?orderNum=30021710923663910033",
"orderNo":"2132131321"
},
"traceId": "666802eeb989c77a375967aded5d646",
"success": true,
"error": false
}响应代码
| 代码 | 解释 |
|---|---|
| 0 | 成功 |
| 1 | 支付异常 |
| 8000 | 参数验证错误 |
| 8003 | Content-type 应为 application/json |
| 8004 | 请求参数格式不正确,需要是 JSON 格式 |
| 8007 | 签名错误 |
| 8011 | 重复的商户订单号 |
| 8012 | 非法的 IP 地址 |
| 8013 | 不支持的加密货币 |
Updated 8 months ago