Transfersmile PT

# 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
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.

TIP

Ao classificar os parâmetros, tire os que não têm valor.

# Eventos de Notificação

  • PAID (pago)

  • REJECTED (recusado)

  • REFUNDED (reembolsado)

TIP

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)

TIP

Nossas notificações serão enviadas a partir destes endereços IP, favor adicioná-los à sua lista branca.

← Payout DryRun →