Notifications asynchrones

Pendant tout le cycle de vie d’une commande, nous envoyons une notification asynchrone à notify_url à chaque changement de statut. Le point de terminaison de réception doit utiliser HTTPS. Les notifications contiennent une signature et les paramètres de paiement (au format JSON).

Conseil

1. L’URL de notification est l’notify_url fournie. Une fois le paiement terminé, YabandPay envoie à cette URL les informations pertinentes sur le paiement et l’utilisateur. L’établissement acquéreur tiers doit recevoir la notification et en vérifier la signature avant toute autre action.

2. Lors des échanges de notifications serveur, si l’établissement acquéreur tiers renvoie une réponse autre qu’un succès ou si la requête expire, YabandPay considère la notification comme échouée. YabandPay réessaie périodiquement d’envoyer les notifications selon sa stratégie de nouvelle tentative afin d’optimiser leur remise, sans toutefois garantir qu’elles seront finalement délivrées.

3. Les notifications serveur pouvant être réessayées, une même notification peut être envoyée plusieurs fois au système partenaire. Celui-ci doit gérer correctement les doublons. Lors du traitement d’une notification, nous recommandons de vérifier d’abord l’état des données métier correspondantes afin de déterminer si elles ont déjà été traitées. Ne les traitez que si ce n’est pas le cas ; sinon, renvoyez immédiatement une réponse de succès. Avant de vérifier et de traiter les données métier, utilisez des verrous de données pour gérer la concurrence et éviter les incohérences causées par une réentrée de fonction.

4. YabandPay envoie les notifications asynchrones depuis les adresses IP suivantes. Nous vous recommandons de les ajouter à la liste d’autorisation de votre pare-feu. 8.211.41.31 8.211.10.244 8.211.8.123

1. Notifications de paiement asynchrones

Statuts de réponse 3DS :

Exemple de notification asynchrone :

{
	"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. Notifications de remboursement asynchrones

Informations de notification :

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

Conseil

1. Après l’envoi d’une demande de remboursement, nous renvoyons le statut refund processing.

2. Une fois le remboursement terminé, nous envoyons une notification avec le statut refunded.

3. Fréquence des notifications asynchrones

Remarque : la réponse à une notification doit renvoyer le code de statut 200 et le texte « ok » dans le corps. Si le texte « ok » n’est pas renvoyé, nous renverrons la notification.

La fréquence des notifications est la suivante :

Si nous ne recevons pas la réponse « ok » correcte, nous cessons d’envoyer des notifications après 15 tentatives.

4. Descriptions des statuts de paiement dans les notifications asynchrones

1. Statuts de paiement :

2. Statuts de remboursement :