异步通知

在订单的整个生命周期每一次状态变化我们都会通过异步通知方式通知给notify_url，通知接收必须使用https协议，通知包括签名和支付参数（json格式）。

1. 通知URL是提交的notify_url，支付完成后，YabandPay会相关支付和用户信息发送到该 URL，第三方受理机构需接收该通知并验签，验签通过才可做下一步操作。
2. 对后台通知交互时，如果YabandPay收到第三方受理机构的应答不是成功或超时，YabandPay认为通知失败，YabandPay会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但YabandPay不保证通知最终能成功。
3. 由于存在重新发送后台通知的情况，因此同样的通知可能会多次发送给合作方系统。合作方系统必须能够正确处理重复的通知。推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
4. YabandPay将从下面IP地址返回异步通知，建议加入防火墙白名单。8.211.41.31，8.211.10.244， 8.211.8.123

1. 支付的异步通知

3DS返回状态：

异步通知的示例：

{
	"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. 退款的异步通知

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

小贴士

1. 退款提交后我们返回状态refund processing。

2. 在完成退款后我们会通知状态refunded。

3. 异步通知频率

请注意：消息通知的响应需返回status-code 200，并且body返回“ok”，如果未返回“ok”，我们将会再次发送通知。

通知频率如下:

如果未收到正确的ok返回，我们在通知15次后将不会再通知。

4. 异步通知支付状态说明

1. 支付状态：

2. 退款状态：