# Asynchronous Notification

## Exchange Payment Asynchronous Notification

This asynchronous notification is sent out to the `notify_url` of the original request whenever a transaction is confirmed as `SUCCESS` in our system.

> Refer to [asynchronous notification](https://lianlianpay.gitbook.io/docs/development/async-notification-concept) for the introduction of its concept and its requirements.

## Request

### Parameters

| Name             | Required | Type        | Description                                                                                                                                                                                                 |
| ---------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| oid\_partner     | Required | String(18)  | The unique identification assigned to the merchant. E.g. 201304121000001004                                                                                                                                 |
| sign\_type       | Required | String(3)   | Fixed value, RSA                                                                                                                                                                                            |
| sign             | Required | String      | Signature value, refer to [signature document](https://lianlianpay.gitbook.io/docs/development/signature)                                                                                                   |
| no\_order        | Required | String(32)  | Merchant transaction No.                                                                                                                                                                                    |
| dt\_order        | Required | String(14)  | The date when the transaction is initialized. Format: yyyyMMddHHmmss, E.g. 20170801225714                                                                                                                   |
| oid\_paybill     | Required | String(18)  | Unique transaction No. in LianLian system. E.g. 2011030900001098                                                                                                                                            |
| result\_pay      | Required | String      | <p>Payment result. <br> SUCCESS - Payment proceed successfully <br> PROCESSING -  Payment is processing. Return only when <strong>No SMS Verification Flow</strong> is setup</p>                            |
| settle\_date     | Required | String(8)   | Format YYYYMMDD.                                                                                                                                                                                            |
| info\_order      | Optional | String(255) | Returns when `info_order` is sent in API requests                                                                                                                                                           |
| pay\_type        | Required | String(1)   | The pay type used in current transaction.                                                                                                                                                                   |
| bank\_code       | Optional | String(8)   | The bank short code of the payer's card issuer                                                                                                                                                              |
| currency\_order  | Required | String(3)   | The currency used in the transaction. Refer to [supported currencies](https://lianlianpay.gitbook.io/docs/development/supported-currencies)                                                                 |
| money\_order     | Required | String(12)  | Merchant transaction amount, range: 0.01 \~ 100,000,000.00, 2 decimal places are expected, in the currency of `currency_order`                                                                              |
| currency\_settle | Required | String(3)   | The settle currency of transaction                                                                                                                                                                          |
| money\_settle    | Required | String(12)  | The settle amount of transaction                                                                                                                                                                            |
| currency\_pay    | Required | String(3)   | The currency of which the payer used. Refer to [supported currencies](https://lianlianpay.gitbook.io/docs/development/supported-currencies)                                                                 |
| money\_pay       | Required | String(12)  | The amount of which the payer payed                                                                                                                                                                         |
| exchange\_rate   | Required | String      | The exchange rate of current transaction                                                                                                                                                                    |
| no\_agree        | Optional | String(16)  | A token which represents the key payment information, refer to [Card binding document](https://lianlianpay.gitbook.io/docs/relevant-api/card-bind-overview) for more details. Return when it is configured. |

### Sample Request

```
curl ${notify_url} \
-H "Content-type: text/json;charset=utf-8" \
-d '{
        "oid_partner": "201103171000000000",
        "dt_order": "20130515094013",
        "no_order": "2013051500001",
        "oid_paybill": "2013051613121201",
        "money_order": "31.68",
        "currency_order": "USD",
        "money_pay": "210.97",
        "currency_pay": "CNY",
        "money_sellte": "31.47",
        "currency_sellte": "USD",
        "exchange_rate": "6.66",
        "result_pay": "SUCCESS",
        "settle_date": "20130516",
        "info_order": "用户13958069593购买了3桶羽毛球",
        "pay_type": "D",
        "bank_code": "01020000",
        "ret_code": "0000",
        "ret_msg": "交易成功",
        "sign_type": "RSA",
        "sign": "ZPZULntRpJwFmGNIVKwjLEF2Tze7bqs60rxQ22CqT5J1UlvGo575QK9z/+p+7E9cOoRoWzqR6xHZ6WVv3dloyGKDR0btvrdqPgUAoeaX/YOWzTh00vwcQ+HBtXE+vPTfAqjCTxiiSJEOY7ATCF1q7iP3sfQxhS0nDUug1LP3OLk="
    }'
```
