订单回调通知
订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知
Last updated
订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知
Last updated
该接口用于通知订单，当订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知
on-ramp订单仅一种情况会触发通知（订单状态变更为已完结，即链上交易已确认时） nft订单已支付、已结算状态会触发通知
合作伙伴需提供用于接收回调的 Webhook 地址给 FaTPay 具体可联系 developers@fatpay.xyz
FaTPay 平台目前针对回调无重试机制，如合作伙伴对订单存在疑问，可使用订单列表查询接口获取订单信息
POST 合作伙伴域名/Webhook_URI
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
合作伙伴收到 FaTPay 回调后，务必对收到的回调进行签名校验，通过后才可进行后续相应处理。
请见
X-Fp-Partner-Id*
String
申请高级合作伙伴时，由 FaTPay 分配的 partner ID e.g. 2yQrS9A0xmM8xpfa
X-Fp-Timestamp*
Integer
Unixtime 时间戳，秒 e.g. 1661346861
X-Fp-Nonce*
Integer
6位随机正整数 e.g. 868964
X-Fp-Signature*
String
由 FaTPayPrivateKey 生成的签名
e.g.
zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==
orderId*
String
订单id，如 jIdvChO85Bw.
orderStatus*
Integer
订单状态，固定值 3 本接口不会返回其他状态
userId*
String
FaTPay 用户id，如 test-4Q4-zf4mDKh7h3FNXPFNaA..
payTime*
String
订单完成支付时间 Unixtime 时间戳，秒 e.g. 1661346861
deliverTime*
Stringe
订单上链时间 Unixtime 时间戳，秒 e.g. 1661346861
finishTime*
String
链上交易完成时间 Unixtime 时间戳，秒 e.g. 1661346861
fiatCurrency*
String
法币ISO代码：USD、THB
currencyAmount*
Long
加密货币数量，最多 2 位小数，如 182
cryptoCurrency*
String
加密货币名称，如 USDT
cryptoCurrencyCode*
String
加密货币标识码，如 USDT_ERC20
cryptoCurrencyAmount*
Decimal
法币金额，最多 2 位小数，如 199
cryptoCurrencyUnitPrice*
Decimal
加密货币单价，最多 2 位小数，如 1.03
walletAddress*
String
钱包地址，如 0xbe188d6641e8b680743a4815dfa0f6208038960f
gasFee*
Decimal
网络手续费，最多 2 位小数，如 1.32
platformFee*
Decimal
平台支付手续费，最多 2 位小数，如 11.94
totalFee*
Decimal
总计支付手续费 2022-10-18后的订单，totalFee=platformFee
payment*
String
txHash*
String
链上交易号，如 0x93da31ee10015ecf3c0dee4a5fa1c74a7a2e02f88ec71f60317c2055f80f3d3c
network*
String
加密货币所在公链，如ethereum_mainnet
blockchainExplorer*
String
链上交易查询地址，如 https://mumbai.polygonscan.com/tx/
gasFeeUnit*
String
网络手续费计价单位，如BTC
2022-10-18后的订单均按照所购加密货币单位来计价，如购买BTC，则gasFee按照BTC单位来收取
platformFeeUnit*
String
平台手续费计价单位，如USD
totalFeeUnit*
String
总计手续费计价单位，如USD
ext*
String
URL入参提交的ext内容，如ext
walletAddressTag*
String
钱包地址附带的Tag/Memo，如888888
法币付款方式，见