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.
