回调模板

回调给商家接口（demo）

URL：POST /demo/callback

当商户接收到请求并处理完成后，返回字符串 "OK" 即可。Satogate 会在交易状态变更时主动向商户的回调 URL 发送 POST 请求。

只有当状态为 FINISHED、ERROR、INSUFFICIENT_AMOUNT、TIMEOUT 时，才会回调给商户。PROCESSING 状态时不会回调。TIMEOUT 仅出现于一次性钱包地址的情况。

回调请求体

string

充值订单号

string

required

收款地址

string

required

充值金额

string

required

折合 USD 金额

string

区块链（ETH / BSC / TRON）

string

币种

string

充值状态：FINISHED / ERROR / INSUFFICIENT_AMOUNT / TIMEOUT

string

订单模式状态：CREATED / FINISHED / PARTIALLY_PAID / TIMEOUT

string

商户关联 ID（固定地址充值模式时返回）

string

商户订单 ID

string

required

转出地址

string

required

链上交易 Hash

array

required

链上交易 Hash 列表（订单模式可能关联多笔链上转账）

integer

创建时间戳

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

认证

核心接口

支付页面

回调

回调给商家接口（demo）

回调请求体

回调请求示例

商户响应

​回调给商家接口（demo）

​回调请求体

​回调请求示例

​商户响应

回调给商家接口（demo）

回调请求体

回调请求示例

商户响应