> ## 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.

# Notify

### Notify URL

* Notify URL：`notify_url`

`when the order status become (SUCCESS \ FAIL \ CLOSED) Only, will notify the merchant`

### Notify Parameter

| Parameter      | Must | Type   | Explanation                                                 |
| :------------- | :--- | :----- | ----------------------------------------------------------- |
| mch\_id        | Yes  | string | Merchant ID                                                 |
| mch\_order\_no | Yes  | string | Merchant Order NO.                                          |
| order\_no      | Yes  | string | Our System Order NO.                                        |
| currency       | Yes  | string | CNY、 THB、PHP、VND... See more at backoffice                  |
| pay\_method    | Yes  | string | Payment Methods                                             |
| amount         | Yes  | string | Amount                                                      |
| actual\_amount | Yes  | string | Paid Amount                                                 |
| status         | Yes  | string | DEALING, CLOSED, SUCCESS, FAIL, REFUND, UNDERPAID, OVERPAID |
| paid\_at       | Yes  | int    | Timestamp millisecond                                       |
| created\_at    | Yes  | int    | Timestamp millisecond                                       |
| error          | Yes  | string | Error Info                                                  |
| utr            | No   | string | Unique Transaction Reference number, return it when success |
| sign           | Yes  | string | Signature                                                   |

### For Example

```
{
	"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"
}

```

### Response

`The merchant should return a response of  SUCCESS or FAIL , Content-type: text/plain`

| Response   | Must | Type   | Explanation                                                                     |
| :--------- | :--- | :----- | ------------------------------------------------------------------------------- |
| SUCCESS    | YES  | string | if return SUCCESS ，We will not notify merchant more!                            |
| FAIL/other | YES  | string | if return others，We will notify 5times，The intervals are 3/9/27/81/243 seconds. |