充值订单

修改订单状态

URL：POST /deposit_order/changeStatus

请求参数

string

required

充值订单 ID

status

string

目标状态（FINISHED / TIMEOUT）

请求示例

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": "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

请求参数

merchantOrderId

string

required

商户方订单 ID

merchantOrderAmount

number

required

订单金额（USD）

merchantOrderExpireTime

number

订单过期秒数（单位：秒，默认 1800）

请求示例

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}'

{
  "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

请求参数

string

required

充值订单 ID

请求示例

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

请求参数

depositOrderId

string

充值订单 ID

merchantOrderId

string

商户方订单 ID

chain

string

充值链（BSC / BTC / ETH / POLYGON / TRON）

asset

string

充值币种（BNB / BTC / ETH / MATIC / TRX / USD / USDC / USDT）

price

number

锁定价格

请求示例

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}'

{
  "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

此接口无需签名认证。

请求参数

asset

string

required

币种（BNB / BTC / ETH / MATIC / TRX / USD / USDC / USDT）

amount

number

required

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

请求参数

depositOrderId

string

充值订单 ID

merchantOrderId

string

商户方订单 ID

请求示例

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"}'

{
  "depositOrderId": "deposit-001",
  "merchantOrderId": "order-123"
}

响应

成功时返回空响应体。

认证

核心接口

支付页面

回调

修改订单状态

请求参数

请求示例

响应参数

响应示例

获取商户订单收款地址

请求参数

请求示例

响应参数

响应示例

查询订单详情

请求参数

请求示例

响应参数

响应示例

锁定价格并提交订单

请求参数

请求示例

响应参数

响应示例

询价

请求参数

请求示例

响应参数

响应示例

解锁订单价格

请求参数

请求示例

响应

​修改订单状态

​请求参数

​请求示例

​响应参数

​响应示例

​获取商户订单收款地址

​请求参数

​请求示例

​响应参数

​响应示例

​查询订单详情

​请求参数

​请求示例

​响应参数

​响应示例

​锁定价格并提交订单

​请求参数

​请求示例

​响应参数

​响应示例

​询价

​请求参数

​请求示例

​响应参数

​响应示例

​解锁订单价格

​请求参数

​请求示例

​响应

修改订单状态

请求参数

请求示例

响应参数

响应示例

获取商户订单收款地址

请求参数

请求示例

响应参数

响应示例

查询订单详情

请求参数

请求示例

响应参数

响应示例

锁定价格并提交订单

请求参数

请求示例

响应参数

响应示例

询价

请求参数

请求示例

响应参数

响应示例

解锁订单价格

请求参数

请求示例

响应