Skip to main content

Visão Geral

Endpoints para gerenciar as configurações de webhooks dos estabelecimentos.

POST /webhooks - Cadastrar Webhook

Cadastra uma nova URL de webhook para receber notificações.

Request

cURL

Response

GET /webhooks - Listar Webhooks

Lista todos os webhooks cadastrados.

Request

cURL

Response

GET /webhooks/:id - Buscar Webhook

Busca um webhook específico por ID.

Request

cURL

Response

PATCH /webhooks/:id - Atualizar Webhook

Atualiza a configuração de um webhook.

Request

cURL

Response

DELETE /webhooks/:id - Deletar Webhook

Remove um webhook cadastrado.

Request

cURL

Response

POST /webhooks/:paymentId/retry - Reenviar Webhook

Reenvia o webhook de uma transação específica.

Request

cURL

Response

Exemplos em JavaScript

Cadastrar Webhook

Listar Webhooks

Atualizar Webhook

Deletar Webhook

Reenviar Webhook

Boas Práticas

Sempre use URLs HTTPS para receber webhooks. URLs HTTP não são seguras e podem ser rejeitadas.
Sempre valide que o webhook veio realmente da EconPay consultando a API.
Retorne status 200 em menos de 5 segundos. Processe tarefas pesadas de forma assíncrona.
Webhooks podem ser enviados mais de uma vez. Implemente lógica para evitar processamento duplicado.

Próximos Passos

Guia de Webhooks

Implementação completa de webhooks

Criar Pagamento

Processar pagamentos