修改订单状态
URL：POST /deposit_order/changeStatus
请求参数
请求示例
curl -X POST https://api.satogate.io/deposit_order/changeStatus \
-H "Content-Type: application/json" \
-H "FP-API-KEY: your-api-key" \
-H "FP-SIGN: your-sign" \
-H "FP-TIMESTAMP: 1681973331" \
-d '{"id": "order-001", "status": "FINISHED"}'
响应参数
| 字段 | 类型 | 说明 |
|---|
| id | string | 订单 ID |
| address | string | 收款地址 |
| amount | string | 充值金额 |
| amountUsd | string | 折合 USD |
| chain | string | 区块链 |
| token | string | 币种 |
| status | string | 状态：PROCESSING / FINISHED / ERROR / INSUFFICIENT_AMOUNT / TIMEOUT |
| orderModeStatus | string | 订单模式状态：CREATED / FINISHED / PARTIALLY_PAID / TIMEOUT |
| depositAmount | string | 到账金额 |
| fromAddress | string | 转出地址 |
| merchantAddressId | string | 商户关联 ID |
| txHash | string | 链上交易 Hash |
| txList | array | 链上交易 Hash 列表 |
| settleTxid | string | 结算交易 ID |
| createTime | integer | 创建时间戳 |
| finishedTime | integer | 完成时间戳 |
响应示例
{
"address": "0x1234...abcd",
"amount": "100.00",
"amountUsd": "100.00",
"chain": "BSC",
"createTime": 1681973331,
"depositAmount": "100.00",
"finishedTime": 1681973931,
"fromAddress": "0xfrom...",
"id": "order-001",
"merchantAddressId": "user123",
"orderModeStatus": "FINISHED",
"settleTxid": "tx-settle-001",
"status": "FINISHED",
"token": "USDT",
"txHash": "0xhash...",
"txList": ["0xhash..."]
}
获取商户订单收款地址
URL：POST /deposit_order/depositAddress
请求参数
请求示例
curl -X POST https://api.satogate.io/deposit_order/depositAddress \
-H "Content-Type: application/json" \
-H "FP-API-KEY: your-api-key" \
-H "FP-SIGN: your-sign" \
-H "FP-TIMESTAMP: 1681973331" \
-d '{"merchantOrderId": "order-123", "merchantOrderAmount": 100, "merchantOrderExpireTime": 1800}'
响应参数
| 字段 | 类型 | 说明 |
|---|
| depositOrderId | string | 充值订单 ID |
| merchantOrderId | string | 商户订单 ID |
| type | string | 地址类型 |
| wallets | array | 钱包地址列表 |
| wallets[].address | string | 收款地址 |
| wallets[].chain | string | 区块链 |
| wallets[].supportTokens | array | 支持的币种 |
响应示例
{
"depositOrderId": "deposit-001",
"merchantOrderId": "order-123",
"type": "BOUND",
"wallets": [
{
"address": "0x1234...abcd",
"chain": "BSC",
"supportTokens": ["USDT", "USDC"]
}
]
}
查询订单详情
URL：GET /deposit_order/detail
请求参数
请求示例
curl -X GET "https://api.satogate.io/deposit_order/detail?id=order-001" \
-H "FP-API-KEY: your-api-key" \
-H "FP-SIGN: your-sign" \
-H "FP-TIMESTAMP: 1681973331"
响应参数
与修改订单状态的响应参数一致。
响应示例
{
"address": "0x1234...abcd",
"amount": "100.00",
"amountUsd": "100.00",
"chain": "BSC",
"createTime": 1681973331,
"depositAmount": "100.00",
"finishedTime": 1681973931,
"fromAddress": "0xfrom...",
"id": "order-001",
"merchantAddressId": "user123",
"orderModeStatus": "FINISHED",
"settleTxid": "",
"status": "FINISHED",
"token": "USDT",
"txHash": "0xhash...",
"txList": ["0xhash..."]
}
锁定价格并提交订单
URL：POST /deposit_order/lock
请求参数
充值链（BSC / BTC / ETH / POLYGON / TRON）
充值币种（BNB / BTC / ETH / MATIC / TRX / USD / USDC / USDT）
请求示例
curl -X POST https://api.satogate.io/deposit_order/lock \
-H "Content-Type: application/json" \
-H "FP-API-KEY: your-api-key" \
-H "FP-SIGN: your-sign" \
-H "FP-TIMESTAMP: 1681973331" \
-d '{"depositOrderId": "deposit-001", "merchantOrderId": "order-123", "chain": "BSC", "asset": "BNB", "price": 320.5}'
响应参数
| 字段 | 类型 | 说明 |
|---|
| amount | number | 需充值数量 |
| asset | string | 充值币种 |
| chain | string | 充值链 |
| depositAddress | string | 充值地址 |
| price | number | 锁定价格 |
响应示例
{
"amount": 0.312,
"asset": "BNB",
"chain": "BSC",
"depositAddress": "0x1234...abcd",
"price": 320.5
}
URL：GET /deposit_order/quote
请求参数
币种（BNB / BTC / ETH / MATIC / TRX / USD / USDC / USDT）
请求示例
curl -X GET "https://api.satogate.io/deposit_order/quote?asset=BNB&amount=100"
响应参数
| 字段 | 类型 | 说明 |
|---|
| assetAmount | number | 对应币种数量 |
| price | number | 当前价格 |
响应示例
{
"assetAmount": 0.312,
"price": 320.5
}
解锁订单价格
URL：POST /deposit_order/unlock
请求参数
请求示例
curl -X POST https://api.satogate.io/deposit_order/unlock \
-H "Content-Type: application/json" \
-H "FP-API-KEY: your-api-key" \
-H "FP-SIGN: your-sign" \
-H "FP-TIMESTAMP: 1681973331" \
-d '{"depositOrderId": "deposit-001", "merchantOrderId": "order-123"}'
