Skip to main content
A API v2 não tem rota para gerenciar endpoints. Cadastre-os no dashboard (recomendado) ou pela API v1.

​
No dashboard (recomendado)

Em Configurações → Webhooks, crie o endpoint e, na mesma tela:
  • Autenticação. Escolha um header customizado com um segredo seu, Bearer, Basic ou Digest. A 4SeletPay envia essa credencial em toda entrega. Sua rota deve recusar qualquer requisição sem ela.
  • Tentativas. Defina de 1 a 10. Com mais de uma, as entregas que falharem são reenviadas (veja Entregas e reenvio).
  • Eventos. Marque os que a sua integração trata.
As entregas não têm assinatura (HMAC). A credencial configurada aqui é a forma de saber que a requisição veio da 4SeletPay. Para decisões críticas, consulte o recurso pela API antes de agir.

​
Pela API v1

POST /v1/webhook-endpoints aceita url e events. A rota exige o login da v1 (POST /v1/login com e-mail e senha) e o header account; a chave de API não serve aqui.
Um endpoint criado pela API nasce com 1 tentativa (sem reenvio) e sem autenticação. Depois de criar, ajuste os dois no dashboard.

Criar endpoint

POST /v1/webhook-endpoints

Listar, alterar e remover

GET, PUT e DELETE /v1/webhook-endpoints

​
Sua rota

  • Responda 2xx rápido e processe em seguida. Mais de 30 s sem resposta conta como falha.
  • Guarde o id (hook_...) de cada entrega e ignore repetidos: o reenvio usa o mesmo id.
  • A ordem das entregas não é garantida. Nunca volte um status por causa de um evento atrasado.
  • Evento de um recurso que você não conhece: responda 2xx e registre. Qualquer outra resposta faz a 4SeletPay tentar de novo.