🇨🇳 中文(简体)

订单回调通知

订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知

  1. 该接口用于通知订单，当订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知

  2. on-ramp订单仅一种情况会触发通知（订单状态变更为已完结，即链上交易已确认时） nft订单已支付、已结算状态会触发通知

  3. 合作伙伴需提供用于接收回调的 Webhook 地址给 FaTPay 具体可联系 developers@fatpay.xyz

  4. FaTPay 平台目前针对回调无重试机制，如合作伙伴对订单存在疑问，可使用订单列表查询接口获取订单信息

订单状态变更为已完结时，FaTPay 对合作伙伴服务端发起异步通知

POST 合作伙伴域名/Webhook_URI

Headers

NameTypeDescription

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==

Request Body

NameTypeDescription

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

合作伙伴收到 FaTPay 回调后，务必对收到的回调进行签名校验，通过后才可进行后续相应处理。

请求参数

请见 Order

PreviousWebhooksNext接口加签 & 验签

Last updated