Asynchrone Benachrichtigungen

Während des gesamten Lebenszyklus einer Bestellung senden wir bei jeder Statusänderung eine asynchrone Benachrichtigung an notify_url. Der Empfangs-Endpunkt muss HTTPS verwenden. Die Benachrichtigungen enthalten eine Signatur und Zahlungsparameter (im JSON-Format).

Tipp

1. Die Benachrichtigungs-URL ist die übermittelte notify_url. Nach Abschluss der Zahlung sendet YabandPay die zugehörigen Zahlungs- und Nutzerinformationen an diese URL. Das Drittanbieter-Acquiring-Institut muss die Benachrichtigung empfangen und die Signatur überprüfen, bevor es weitere Schritte ausführt.

2. Gibt das Drittanbieter-Acquiring-Institut beim Austausch von Serverbenachrichtigungen keine erfolgreiche Antwort zurück oder läuft die Anfrage ab, gilt die Benachrichtigung für YabandPay als fehlgeschlagen. YabandPay wiederholt Benachrichtigungen regelmäßig gemäß seiner Wiederholungsstrategie, um die Zustellung möglichst sicherzustellen; eine endgültige Zustellung wird jedoch nicht garantiert.

3. Da Serverbenachrichtigungen erneut gesendet werden können, kann dieselbe Benachrichtigung mehrfach beim Partnersystem eingehen. Das Partnersystem muss Duplikate korrekt verarbeiten. Prüfen Sie bei der Verarbeitung zuerst den Status der zugehörigen Geschäftsdaten, um festzustellen, ob die Benachrichtigung bereits bearbeitet wurde. Bearbeiten Sie sie nur, wenn dies noch nicht geschehen ist; andernfalls geben Sie sofort eine erfolgreiche Antwort zurück. Verwenden Sie vor der Prüfung und Verarbeitung der Geschäftsdaten Datensperren zur Nebenläufigkeitskontrolle, damit Wiedereintritte keine Inkonsistenzen verursachen.

4. YabandPay sendet asynchrone Benachrichtigungen von den folgenden IP-Adressen. Wir empfehlen, diese in die Firewall-Zulassungsliste aufzunehmen. 8.211.41.31 8.211.10.244 8.211.8.123

1. Asynchrone Zahlungsbenachrichtigungen

3DS-Antwortstatus:

Beispiel für eine asynchrone Benachrichtigung:

{
	"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. Asynchrone Rückerstattungsbenachrichtigungen

Informationen zu Benachrichtigungen:

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

Tipp

1. Nach Übermittlung einer Rückerstattung geben wir den Status refund processing zurück.

2. Sobald die Rückerstattung abgeschlossen ist, senden wir eine Benachrichtigung mit dem Status refunded.

3. Häufigkeit asynchroner Benachrichtigungen

Bitte beachten Sie: Die Antwort auf eine Benachrichtigung muss den Statuscode 200 und „ok“ im Antworttext zurückgeben. Wird „ok“ nicht zurückgegeben, senden wir die Benachrichtigung erneut.

Die Benachrichtigungen werden wie folgt gesendet:

Wenn wir keine korrekte „ok“-Antwort erhalten, beenden wir das Senden nach 15 Versuchen.

4. Beschreibungen der Zahlungsstatus in asynchronen Benachrichtigungen

1. Zahlungsstatus:

2. Rückerstattungsstatus: