Pular para o conteúdo principal
A SkalePayments envia requisições HTTP POST com JSON quando o status de uma transação muda.

Eventos disponíveis

Pendente

Cobrança PIX aguardando pagamento (waiting_payment).

Pago

Pagamento confirmado (paid).

Recusado

Pagamento recusado (refused).

Cancelado

Transação cancelada (cancelled).

Reembolsado

Pagamento reembolsado (refunded).

Formas de receber eventos

Informe postbackUrl ao criar a transação. Essa URL recebe todos os status da transação, independentemente das configurações do painel.
Cadastre URLs no painel, escolha os eventos recebidos e, quando necessário, configure application-id e webhook-secret.

Requisitos do endpoint

  • Utilize uma URL HTTPS pública.
  • Aceite requisições POST com Content-Type: application/json.
  • Responda em até 10 segundos.
  • Retorne HTTP 2xx depois de persistir o evento.
  • Processe eventos de forma idempotente.
Em falhas de rede, respostas 5xx ou 429, a entrega é repetida automaticamente com backoff. Seu endpoint deve aceitar eventos duplicados com segurança.

Cabeçalhos enviados

O postbackUrl informado diretamente na transação não envia application-id nem webhook-secret.

Payload

Campos principais

Resposta recomendada

Responda somente depois que o evento estiver salvo. Execute tarefas demoradas de maneira assíncrona.