> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay247.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 订单通知

### 通知URL

* 通知地址：`商户发起请求时的notify_url`

` 代收订单处理成功或失败或关闭都会发送异步通知，需要判断返回结果里的 status 参数为成功或失败做后续的处理`

### 通知回调参数

| 参数名            | 必选 | 类型     | 说明                                                                                |
| :------------- | :- | :----- | --------------------------------------------------------------------------------- |
| mch\_id        | 是  | string | 商户号                                                                               |
| mch\_order\_no | 是  | string | 商户订单号                                                                             |
| order\_no      | 是  | string | 系统订单号                                                                             |
| status         | 是  | string | 支付状态    PENDING：等待支付； DEALING：处理中；CLOSED：订单超时关闭； SUCCESS：转账成功；FAIL：失败； REFUND 退款； |
| currency       | 是  | string | 订单币种 string 类型                                                                    |
| utr            | 是  | string | 支付机构订单号，支付成功时返回                                                                   |
| amount         | 是  | string | 订单金额                                                                              |
| paid\_at       | 是  | int    | unix时间戳 毫秒                                                                        |
| created\_at    | 是  | int    | unix时间戳 毫秒                                                                        |
| error          | 是  | string | 错误或失败信息                                                                           |
| sign           | 是  | string | 签名                                                                                |

### 商户接收的数据示例

```
{
	"mch_id": "MCH12345678",
	"mch_order_no": "20200708135806101549897485",
	"order_no": "P20200707042747519753974832",
	"currency": "USD",
	"amount": "11.11",
	"actual_amount": "11.22",
	"pay_method": "BANK",
	"pay_theme": "link",
	"fee": "0.11",
	"paid_at": 1594187989123,
	"created_at": 1594187989123,
	"error": "",
	"status": "SUCCESS",
	"sign": "1235e535956e6c288b6fdcae4522a13a"
}

```

`注：逻辑处理成功响应字符串 SUCCESS，否则返回 FAIL 或其它提示`

**通知回调响应结果**

| 返回值        | 必选 | 类型     | 说明                                 |
| :--------- | :- | :----- | ---------------------------------- |
| SUCCESS    | 是  | string | 成功，不再继续通知                          |
| fail/other | 是  | string | 非成功，则会继续尝试通知5次，分次间隔为3/9/27/81/243秒 |