Webhooks
Os Webhooks enviam uma requisição POST com informações sobre cada pedido. O seu sistema deve retornar uma resposta 2xx confirmando o recebimento. Caso contrário, o Webhook será reenviado até 5 vezes. Todos os valores financeiros são enviados como INTEGER em centavos. Ou seja,11094 significa R$ 110,94
É possível escolher entre a versão 1.0 ou versão 2.0 do payload do webhook ao criar a integração na plataforma.
- Versão 1.0 = sistema antigo da Pepper (em produção até 2024)
- Versão 2.0 = sistema atual da Pepper
Isso garante compatibilidade com versões anteriores já configuradas em outras plataformas – consulte a documentação da plataforma que deseja integrar.
Tipos de evento
A integração de Webhooks pode receber:- Transações —
event=transaction(vendas avulsas / pedidos) - Assinaturas —
event=subscription.*(ciclo de vida da recorrência)
A regra de valores em centavos acima aplica-se principalmente aos webhooks de transação. Nos webhooks de assinatura (v2.0), preços e valores monetários vêm como string em reais (ex.:
"9.99").