# 订单回调通知

1. 该接口用于通知订单，当订单状态变更时，FaTPay 对合作伙伴服务端发起异步通知
2. on-ramp订单仅一种情况会触发通知（订单状态变更为已完结，即链上交易已确认时）\
   nft订单已支付、已结算状态会触发通知
3. 合作伙伴需提供用于接收回调的 Webhook 地址给 FaTPay 具体可联系 <developers@fatpay.xyz>
4. FaTPay 平台目前针对回调无重试机制，如合作伙伴对订单存在疑问，可使用[订单列表查询接口](https://dev.fatpay.org/zh/reference/api-reference/on-ramp-apis/list-all-orders)获取订单信息

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

<mark style="color:green;">`POST`</mark> `合作伙伴域名/Webhook_URI`

#### Headers

| Name                                              | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| X-Fp-Partner-Id<mark style="color:red;">\*</mark> | String  | <p>申请高级合作伙伴时，由 FaTPay 分配的 partner ID<br>e.g. 2yQrS9A0xmM8xpfa</p>                                                                                                                                                                                                                                                                                                                                                |
| X-Fp-Timestamp<mark style="color:red;">\*</mark>  | Integer | <p>Unixtime 时间戳，秒<br>e.g. 1661346861</p>                                                                                                                                                                                                                                                                                                                                                                         |
| X-Fp-Nonce<mark style="color:red;">\*</mark>      | Integer | <p>6位随机正整数<br>e.g. 868964</p>                                                                                                                                                                                                                                                                                                                                                                                    |
| X-Fp-Signature<mark style="color:red;">\*</mark>  | String  | <p>由 <code>FaTPayPrivateKey</code> 生成的签名<br>e.g.<br>zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==</p> |

#### Request Body

| Name                                                      | Type    | Description                                                                                                                  |
| --------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| orderId<mark style="color:red;">\*</mark>                 | String  | 订单id，如 jIdvChO85Bw.                                                                                                          |
| orderStatus<mark style="color:red;">\*</mark>             | Integer | <p>订单状态，固定值 3<br>本接口不会返回其他状态</p>                                                                                             |
| userId<mark style="color:red;">\*</mark>                  | String  | FaTPay 用户id，如 test-4Q4-zf4mDKh7h3FNXPFNaA..                                                                                  |
| payTime<mark style="color:red;">\*</mark>                 | String  | <p>订单完成支付时间<br>Unixtime 时间戳，秒<br>e.g. 1661346861</p>                                                                         |
| deliverTime<mark style="color:red;">\*</mark>             | Stringe | <p>订单上链时间<br>Unixtime 时间戳，秒<br>e.g. 1661346861</p>                                                                           |
| finishTime<mark style="color:red;">\*</mark>              | String  | <p>链上交易完成时间<br>Unixtime 时间戳，秒<br>e.g. 1661346861</p>                                                                         |
| fiatCurrency<mark style="color:red;">\*</mark>            | String  | 法币ISO代码：USD、THB                                                                                                              |
| currencyAmount<mark style="color:red;">\*</mark>          | Long    | 加密货币数量，最多 2 位小数，如 182                                                                                                        |
| cryptoCurrency<mark style="color:red;">\*</mark>          | String  | 加密货币名称，如 USDT                                                                                                                |
| cryptoCurrencyCode<mark style="color:red;">\*</mark>      | String  | 加密货币标识码，如 USDT\_ERC20                                                                                                        |
| cryptoCurrencyAmount<mark style="color:red;">\*</mark>    | Decimal | 法币金额，最多 2 位小数，如 199                                                                                                          |
| cryptoCurrencyUnitPrice<mark style="color:red;">\*</mark> | Decimal | 加密货币单价，最多 2 位小数，如 1.03                                                                                                       |
| walletAddress<mark style="color:red;">\*</mark>           | String  | 钱包地址，如 0xbe188d6641e8b680743a4815dfa0f6208038960f                                                                            |
| gasFee<mark style="color:red;">\*</mark>                  | Decimal | 网络手续费，最多 2 位小数，如 1.32                                                                                                        |
| platformFee<mark style="color:red;">\*</mark>             | Decimal | 平台支付手续费，最多 2 位小数，如 11.94                                                                                                     |
| totalFee<mark style="color:red;">\*</mark>                | Decimal | <p>总计支付手续费<br>2022-10-18后的订单，totalFee=platformFee</p>                                                                        |
| payment<mark style="color:red;">\*</mark>                 | String  | 法币付款方式，见 [#paymentoption](https://dev.fatpay.org/zh/reference/on-ramp-apis/list-all-fiat-currencies#paymentoption "mention") |
| txHash<mark style="color:red;">\*</mark>                  | String  | 链上交易号，如 0x93da31ee10015ecf3c0dee4a5fa1c74a7a2e02f88ec71f60317c2055f80f3d3c                                                   |
| network<mark style="color:red;">\*</mark>                 | String  | 加密货币所在公链，如ethereum\_mainnet                                                                                                  |
| blockchainExplorer<mark style="color:red;">\*</mark>      | String  | 链上交易查询地址，如 <https://mumbai.polygonscan.com/tx/>                                                                              |
| gasFeeUnit<mark style="color:red;">\*</mark>              | String  | <p>网络手续费计价单位，如BTC</p><p>2022-10-18后的订单均按照所购加密货币单位来计价，如购买BTC，则gasFee按照BTC单位来收取</p>                                            |
| platformFeeUnit<mark style="color:red;">\*</mark>         | String  | 平台手续费计价单位，如USD                                                                                                               |
| totalFeeUnit<mark style="color:red;">\*</mark>            | String  | 总计手续费计价单位，如USD                                                                                                               |
| ext<mark style="color:red;">\*</mark>                     | String  | URL入参提交的ext内容，如ext                                                                                                           |
| walletAddressTag<mark style="color:red;">\*</mark>        | String  | 钱包地址附带的Tag/Memo，如888888                                                                                                      |

{% hint style="warning" %}
合作伙伴收到 FaTPay  回调后，务必对收到的回调进行[签名校验](https://dev.fatpay.org/zh/reference/verification#webhook-hui-tiao-yan-qian)，通过后才可进行后续相应处理。
{% endhint %}

## 请求参数

请见 [#order](https://dev.fatpay.org/zh/reference/on-ramp-apis/list-all-orders#order "mention")