POST assinado para a URL que você cadastrou. É o único canal que avisa em tempo
real; o restante você consulta.
Eventos disponíveis hoje
O crédito só gera evento depois de verificado na origem. Você nunca recebe um
aviso de dinheiro que não entrou.
Formato do evento
Headers:
Corpo:
Verifique a assinatura
A receita é a mesma do padrão Stripe: o valor assinado é${t}.${corpo bruto}.
Como responder
1
Responda 2xx rápido
Grave o evento e devolva
200 imediatamente. Processe depois, de forma
assíncrona. Uma resposta lenta vira timeout e entra na fila de retry.2
Deduplique por X-PrismaPay-Delivery
O mesmo id chega em toda retentativa da mesma entrega. Use-o como chave única
do seu lado.
3
Não confie na ordem de chegada
A ordem não é garantida. Decida pelo conteúdo do evento, nunca pela sequência
em que ele chegou.
Retentativas
Uma resposta diferente de2xx, ou um timeout, entra em duas fases:
1
Fase rápida
Até 5 tentativas com backoff exponencial: base de 2 s, dobrando a cada
tentativa, com teto de 60 s e jitter de 50% a 100%. As cinco tentativas cabem
em algumas dezenas de segundos. Cobre uma instabilidade curta.
2
Cauda longa
Se a fase rápida se esgotar, a entrega volta cerca de 30 min, 2,5 h e
24,5 h depois. Cada retorno roda uma fase rápida nova. Cobre uma queda
medida em horas.
dead e para de ser tentada. A partir daí,
reconcilie pelo log de entregas abaixo.
Cada tentativa é assinada de novo, com um t= novo. Não recuse uma retentativa só
porque o timestamp dela é mais recente que o da primeira.
O agendamento é contado, não relojoado: ele vive no banco e avança um passo por
retentativa. Nem uma reinicialização nossa nem uma janela sem processamento
consomem um horário que a entrega não usou.
Log de entregas
Campos
failureReason assume um destes valores:
Paginação
As linhas voltam da mais recente para a mais antiga, ordenadas porseq. Passe o
nextCursor da resposta anterior para buscar a próxima página. nextCursor: null
significa fim da lista. Não existe um campo hasMore separado: o cursor é o sinal.
Polling incremental
Oseq vem de uma sequência compartilhada entre todos os parceiros. O seu fluxo tem
buracos: seq ordena os seus eventos, não os conta. Duas entregas
simultâneas também podem gravar fora de ordem, então uma linha com seq menor pode
aparecer pouco depois de você já ter passado dela.
Ao consultar de forma incremental, reprocesse uma sobreposição, os últimos minutos
ou algumas centenas de seq, em vez de parar na marca que você guardou. Uma
varredura completa para trás não sofre desse efeito.
Um
accountId que você não gerencia, suspenso ou revogado responde
404 account_not_found, igual a qualquer outra leitura por conta. Você nunca
recebe uma página vazia que pareça “nada foi enviado”.Configuração
A URL de destino e owhsec_... são cadastrados pela PrismaPay junto com a
credencial. Para trocar a URL ou girar o segredo, fale com o time.
