Notificação
Como verificar nossas notificações.
Assim que o payout for confirmado pelo banco, a transfersmile enviará uma notificação para a URL de notificação do comerciante informando o resultado da transação. Este URL é definido ao submeter a transação de pagamento, usando o parâmetro notify_url para cada pedido de pagamento. A notificação tentará novamente 6 vezes quando seu processamento falhar.
Post
$notify_url which defined when submitting the payout transaction.
Notificação
Notification Parameters
Parameters
Header
Content-Type* | string | application/json; chartset=UTF-8 |
Authorization* | string | SHA256($sorted_params + $app_key) |
Body
payoutId* | string | ID da transação transfersmile |
custom_code* | string | merchant custom_code |
status* | string | PAID or REJECTED |
msg | string | success or rejected message |
timestamp* | string | unix timestamp |
Responses
200 | O Merchant processou o callback, e resultado "sucesso". |
success
Verificação de Autorização
Obtenha os parâmetros do corpo de retorno e classifique-os de forma ascendente.
Concatenar sorted_params com app_key.
Use sha256(sorted_params + app_key) para gerar App Authorization.
Obtenha transfersmile Authorization no cabeçalho do callback.
Verifique se transfersmile Authorization corresponde com App Authorization.
Tips
Ao classificar os parâmetros, tire os que não têm valor.
Eventos de Notificação
PAID (pago)
REJECTED (recusado)
REFUNDED (reembolsado)
Tips
No momento, ambas as carteiras SPEI & transfersmile suportam notificação REFUNDED.
Exemplo de Notificação
curl --location --request POST $your_notify_url \
--header 'Authorization: $transfersmile_authorization' \
--header 'Content-Type: application/json' \
--data-raw '{
"payoutId": "TS202202071548044sGt3ADbmpGsPB",
"custom_code": "custom_code_test",
"status": "PAID",
"msg": "success",
"timestamp": 1628564650
}'
Tentativas de notificação
A transfersmile enviará notificações com o seguinte cronograma de novas tentativas e confirmação aguardando os horários. Você deve retornar um HTTP STATUS 200 (OK) com dados de resposta "success" antes que o tempo correspondente expire. Caso contrário, será assumido que você não recebeu os dados corretamente e será notificado novamente.
Recomenda-se responder à notificação antes de executar a lógica de negócios ou antes de acessar recursos externos, para não exceder os tempos de resposta estimados.
Esta comunicação é exclusivamente entre os servidores da transfersmile e seu servidor, de modo que não haverá um usuário físico vendo qualquer tipo de resultado.
Evento | Tempo após o primeiro envio |
---|---|
Envio | -- |
1ª tentativa | 10 minutos |
2ª tentativa | 30 minutos |
3ª tentativa | 60 minutos |
4ª tentativa | 120 minutos |
5ª tentativa | 360 minutos |
6ª tentativa | 840 minutos |
Lista de IPs de Notificação
13.52.172.128
54.151.3.172
104.233.212.11 (Sandbox)
52.9.118.255
54.151.20.116
107.148.232.114 (Sandbox)
Tips
Nossas notificações serão enviadas a partir destes endereços IP, favor adicioná-los à sua lista branca.