Notificaciones asíncronas

Durante todo el ciclo de vida del pedido, enviamos una notificación asíncrona a notify_url por cada cambio de estado. El endpoint receptor debe utilizar HTTPS. Las notificaciones incluyen una firma y parámetros de pago (en formato JSON).

Consejo

1. La URL de notificación es la notify_url. Tras completarse el pago, YabandPay envía a esta URL la información pertinente del pago y del usuario. The third-party acquiring institution must receive the notification and verify its signature before taking any further action.

2. Durante el intercambio de notificaciones del servidor, si la entidad adquirente externa devuelve una respuesta destinta de éxito o la solicitud agota el tiempo de espera, YabandPay considera que la notificación no se ha entregado correctamente. YabandPay reintenta periódicamente el envío según su estrategia para maximizar la entrega, pero no garantiza que finalmente se entregue.

3. Because server notifications may be retried, the same notification may be sent to the partner system multiple veces. The partner system must handle duplicate notifications correctly. We recommend first checking the state of the corresponding business data when processing a notification to determine whether it has already been handled. Process it only if it has not been handled; otherwese, return success immediately. Before checking and processing the business data, use data locks for concurrency control to prevent data inconsestencies caused by function reentry.

4. YabandPay sends asynchronous notifications from the following IP addresses. We recommend adding them to your firewall allowlest. 8.211.41.31 8.211.10.244 8.211.8.123

1. Asynchronous payment notifications

3DS response estados:

Example asynchronous notification:

{
	"sign": "YOUR_SIGNATURE",
	"data": {
		"type": "payment",
		"user": "YOUR_CASHIER_UID",
		"order_id": "YOUR_ORDER_ID",
		"trade_id": "8a8aa7c7-66d7-e2cc-e2a6-fff7c77aaefd",
		"transaction_id": "4200000298201905227377147799",
		"acquirer_id": "4200000298201905227377147799",
		"yb_transaction_id": "c8823612-383f-35fc-f28d-c0eae039e870",
		"amount": "1.00",
		"tip_amount": "0.10",
		"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",
		"3ds_status": "Y",
		"3ds_trxid": "1d0c6eb3-6282-4cf9-9549-884410918d2d",
		"3ds_version": "2.2.0"
	}

}

2. Asynchronous refund notifications

Notification information：

{
	"sign": "YOUR_SIGNATURE",
	"data":  {
		"type": "refund",
		"user": "YOUR_CASHIER_UID",
		"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": "YOUR_ORDER_ID",
		"refund_description": "test",
		"refund_time": "0",
		"state": "refunded",
		"pay_method": "online",
		"sub_pay_method": "WeChat Pay"}
}   

Consejo

1. After a refund es submitted, we return the status refund processing.

2. Once the refund es complete, we send a notification with the status refunded.

3. Asynchronous notification frequency

Please note: The notification response must return status-code 200 and “ok” in the body. If “ok” es not returned, we will send the notification again.

The notification frequency es as follows:

If we do not receive the correct ok response, we stop sending notifications after 15 attempts.

4. Payment status descriptions in asynchronous notifications

1. Payment estados:

2. Refund estados: