POSTWebhooks & API Keys
Webhook de pagamento (inbound)
Recebe eventos de gateway de pagamento/NF (inbound). PÚBLICO — a origem é verificada por assinatura. Idempotente por evento.
POST
/webhooks/{gateway}AutenticaçãoPúblico
Aberto — não requer autenticação.
Parâmetros de caminho
gatewaystringobrigatórioGateway de origem (ex.: stripe, mercadopago).
Requisição
curl -X POST "https://api.ecomplataforma.com.br/webhooks/mercadopago" \
-H "Content-Type: application/json" \
-d '{"type":"payment","data":{"id":"123"}}'Resposta200
200 OK
{ "received": true }Respostas de erro
404Não encontrado
404 Não encontrado
{
"success": false,
"error": "Recurso não encontrado."
}