Skip to main content

​
回调给商家接口（demo）

URL：POST /demo/callback
当商户接收到请求并处理完成后，返回字符串 "OK" 即可。Satogate 会在交易状态变更时主动向商户的回调 URL 发送 POST 请求。
只有当状态为 FINISHED、ERROR、INSUFFICIENT_AMOUNT、TIMEOUT 时，才会回调给商户。PROCESSING 状态时不会回调。TIMEOUT 仅出现于一次性钱包地址的情况。

​
回调请求体

​
id
string
充值订单号
​
address
string
required
收款地址
​
amount
string
required
充值金额
​
amountUsd
string
required
折合 USD 金额
​
chain
string
区块链（ETH / BSC / TRON）
​
token
string
币种
​
status
string
充值状态：FINISHED / ERROR / INSUFFICIENT_AMOUNT / TIMEOUT
​
orderModeStatus
string
订单模式状态：CREATED / FINISHED / PARTIALLY_PAID / TIMEOUT
​
merchantAddressId
string
商户关联 ID（固定地址充值模式时返回）
​
merchantOrderId
string
商户订单 ID
​
fromAddress
string
required
转出地址
​
txHash
string
required
链上交易 Hash
​
txList
array
required
链上交易 Hash 列表（订单模式可能关联多笔链上转账）
​
createTime
integer
创建时间戳
​
finishedTime
integer
完成时间戳

​
回调请求示例

{
  "address": "0x1234...abcd",
  "amount": "100.00",
  "amountUsd": "100.00",
  "chain": "BSC",
  "createTime": 1681973331,
  "finishedTime": 1681973931,
  "fromAddress": "0xfrom...",
  "id": "order-001",
  "merchantAddressId": "user123",
  "merchantOrderId": "order-123",
  "orderModeStatus": "FINISHED",
  "status": "FINISHED",
  "token": "USDT",
  "txHash": "0xhash...",
  "txList": ["0xhash..."]
}

​
商户响应

商户收到回调后处理完成，直接返回字符串： 
OK