Notificação

Como verificar nossas notificações.

Assim que o payout for confirmado pelo banco, a Pagsmile 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.

Notificação

POST $notify_url which defined when submitting the payout transaction.

Notification Parameters

Headers

Name	Type	Description
Content-Type*	string	application/json; charset=UTF-8
Authorization*	string	SHA256($sorted_params + $app_key)

Request Body

Name	Type	Description
payoutId*	string	pagsmile transaction id
custom_code*	string	merchant custom_code
status*	string	PAID ou REJECTED
msg	string	success ou rejected message
timestamp*	integer	unix timestamp

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 Pagsmile Authorization no cabeçalho do callback.

• Verifique se Pagsmile Authorization corresponde com App Authorization.

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

Eventos de Notificação

• PAID (pago)

• REJECTED (recusado)

• REFUNDED (reembolsado)

No momento, ambas as carteiras SPEI & Pagsmile suportam notificação REFUNDED.

Exemplo de Notificação

curl --location --request POST $your_notify_url \
--header 'Authorization: $pagsmile_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 Pagsmile 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 Pagsmile 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)

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