Notificações assíncronas

Durante todo o ciclo de vida de um pedido, enviamos uma notificação assíncrona para notify_url a cada alteração de status. O endpoint receptor deve usar https. As notificações incluem uma assinatura e parâmetros de pagamento (no formato json).

Dica

1. O URL de notificação é o notify_url enviado. Após a conclusão do pagamento, a YabandPay envia para esse URL as informações relevantes sobre o pagamento e o usuário. A instituição adquirente terceirizada deve receber a notificação e verificar a assinatura antes de realizar qualquer outra ação.

2. Durante as trocas de notificações entre servidores, se a instituição adquirente terceirizada retornar uma resposta que não indique sucesso ou se a solicitação expirar, a YabandPay considerará a notificação malsucedida. A YabandPay tentará reenviar notificações periodicamente de acordo com sua estratégia de novas tentativas para maximizar a probabilidade de entrega, mas não garante a entrega final.

3. Como as notificações do servidor podem ser reenviadas, o mesmo aviso pode chegar várias vezes ao sistema parceiro. O sistema parceiro deve tratar corretamente as notificações duplicadas. Recomendamos verificar primeiro o estado dos dados comerciais correspondentes para determinar se a notificação já foi processada. Processe-a apenas se ainda não tiver sido tratada; caso contrário, retorne sucesso imediatamente. Antes de verificar e processar os dados comerciais, use bloqueios de dados para controlar a concorrência e evitar inconsistências causadas pela reentrada da função.

4. A YabandPay envia notificações assíncronas a partir dos endereços IP abaixo. Recomendamos adicioná-los à lista de permissões do firewall. 8.211.41.31 8.211.10.244 8.211.8.123

1. Notificações assíncronas de pagamento

3DS response statuses:

Exemplo de notificação assíncrona:

{
	"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. Notificações assíncronas de reembolso

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

Dica

1. Após o envio de um reembolso, retornamos o status refund processing.

2. Quando o reembolso for concluído, enviaremos uma notificação com o status refunded.

3. Frequência das notificações assíncronas

Atenção: a resposta à notificação deve retornar o status-code 200 e “ok” no corpo. Se “ok” não for retornado, enviaremos a notificação novamente.

A frequência das notificações é a seguinte:

Se não recebermos a resposta “ok” correta, interromperemos o envio de notificações após 15 tentativas.

4. Descrições dos status de pagamento nas notificações assíncronas

1. Status de pagamento:

2. Status de reembolso: