Notify

[!TIP|style:flat]

Notify URL is used for receiving the payment status notification.

When an order is created, YaBandPay API will deliver the status change to you each time during the payment process.

The notification of the delivered status must apply https protocol. The content of the notification is made up of signature.payment status (Note that there is a dot between the signature and the payment status JSON).

YabandPay will return asynchronous notifications from the following IP addresses, which are recommended to be added to the firewall whitelist.

8.211.8.130

8.211.10.149

1. The notification of payment

Parameter Type Description
sign String signature
type String payment, refund
user String the UID or email of cashier account
amount String the amount submitted
currency String ISO 4217, For example EUR, CHF, the currency submitted
settlement_amount String the settlement amount
settlement_currency String EUR, the settlement currency
exchange_rate String exchange rate
amount_cny String payer paid amount(CNY)
settlement_rate String settlement rate for payer
order_id String order id from Merchant
transaction_id String the transaction id from payment method provider, ie. WeChat Pay or Alipay+
acquirer_id String the transaction id from institution
description String order description
createDate String create date
state String Processing, Cancelled, Paid, Expired, Verify
demo String custom field
out_trade_no String out trade number
sub_pay_method String payer payment method, ie. WeChat Pay, Alipay+
pay_method String offline, online
paid_time String paid time
Example Response:
{
    "sign": "52072b58345e90e07627c3a4b9c0402efce086ce95e533375cfa7f25839240cd",
    "data": {
        "type": "payment",
        "user": "016683",
        "order_id": "190510140815",
        "trade_id": "8a8aa7c7-66d7-e2cc-e2a6-fff7c77aaefd",
        "transaction_id": "4200000298201905227377147799",
        "acquirer_id": "4200000298201905227377147799",
        "amount": "1.00",
        "currency": "EUR",
        "settlement_amount": "1.00",
        "settlement_currency": "EUR",
        "exchange_rate": "1",
        "amount_cny":"0.77",
        "settlement_rate":"7.779779",
        "description": "yaband test",
        "createDate": "1558510731",
        "pay_method": "online",
        "state": "paid",
        "demo": "test",
        "out_trade_no": "a4d7684a-e326-44c1-bea5-0601f7a9b191",
        "sub_pay_method" : "WeChat Pay",
        "paid_time" : "1603355159"
    }
}

2. The notification of refund

Parameter Type Description
sign String signature
type String refund
user String the UID or email of cashier account
pay_method String offline, online
sub_pay_method String payer payment method, ie. WeChat Pay, Alipay+
refund_id String the refund id
m_refund_id String merchant-defined refund number
transaction_id String the transaction id from YabBandPay
refund_amount String the amount submitted
refund_currency String the settlement currency
order_id String the order id from Merchant
refund_description String refund description
refund_time String create date
state String to-be-approval,refund pending,refund processing, refunded,refund error , refund failed,refund cancelled
Notification information：
{
    "sign": "b71a0b52811b98aed22b928c0ab124e39b722bca0547b5e6c5d19763bec456ae",
    "data":  {
        "type": "refund",
        "user": "016683",
        "refund_id": "b20d3668-d71f-432f-8809-f84f0d9139d4",
        "m_refund_id":"20240301143029616187",
        "transaction_id":"cf483d9e-637c-a92d-0716-5b8199d10f8c",
        "refund_amount": "1.00",
        "refund_currency": "EUR",
        "order_id": "200219",
        "refund_description": "test",
        "refund_time": "0",
        "state": "refunded",
        "pay_method": "online",
        "sub_pay_method": "WeChat Pay",
    }
}

[!TIP|style:flat]

  1. the state is refund processing after refund request.

  2. the state is refunded after refund requet completed.

3. Notification frequency

The response of notification must return status-code 200, and body must return ok. If ok is not returned, then we will send the notification again.

The frequency of notifications is as follows:

Retry Frequency
1 10s
2 30s
3 60s
4 300s
5 3600s
... 3600s
15 3600s

Yabandpay will not send nocification once more if ok is not returned after 15 times.

4. Asynchronous notification payment status description

Payment status：
State Description
processing Waiting for customers to pay
cancelled Payment cancelled
paid Payment successful
expired Payment was not accepted within the allocated time
verify The customer has paid, but due to risk control reasons, we need to review it.
Refund status：
State Description
to-be-approval Waiting for admin approval.
refund pending The current balance is insufficient. It will be automatically submitted when the balance is sufficient.
refund processing Refund has been submitted.
refunded Refund successfully.
refund failed Refund failed, please try again.
refund error Please contact our staff.
refund cancelled The refund order has been cancelled.

results matching ""

    No results matching ""