Transfersmile PTTransfersmile PT
  • EN
  • PT
  • ES
  • EN
  • PT
  • ES
  • Introdução
  • API Payin
    • Ambientes
    • Integração direta
      • Brasil
        • Cartão de crédito
        • Pix
        • Lotérica
        • Boleto
        • Depósito Express
        • Carteira
    • Notificação
      • Segurança
    • Detalhes Payin
    • Reembolso
    • Plug-in & Ferramentas
      • transfersmile JavaScript
      • transfersmile SDK
      • Lista de Bancos Suportados
      • Consulta de detalhes de parcelamento
    • Dados
      • Método de Pagamento
      • Dados para teste (Sandbox)
      • Status Payin
      • Lista de Bancos
      • Ícone dos métodos
    • Código API
  • API Payout
    • Ambientes
    • Segurança
    • Criar um payout
      • Carteira transfersmile
        • Exemplo WebView
        • Autorização H5
        • Autorização de App nativo
        • Enviar prêmios
      • Brasil
        • Pix
        • Transferência bancária
    • Notificação
    • Payout DryRun
    • Saldo da Conta
    • Status do Payout
    • Lista de Payout
    • Detalhes do Payout
    • Método de pagamento
    • Dados para teste
    • Código do Banco
      • Bancos Brasil
    • Código API

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*stringapplication/json; chartset=UTF-8
Authorization*stringSHA256($sorted_params + $app_key)

Body

payoutId*stringID da transação transfersmile
custom_code*stringmerchant custom_code
status*stringPAID or REJECTED
msgstringsuccess or rejected message
timestamp*stringunix timestamp

Responses

200O 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.

EventoTempo após o primeiro envio
Envio--
1ª tentativa10 minutos
2ª tentativa30 minutos
3ª tentativa60 minutos
4ª tentativa120 minutos
5ª tentativa360 minutos
6ª tentativa840 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.

Prev
Criar um payout
Next
Payout DryRun