Desenvolvedores
Integre o AtmosPay ao seu sistema
API REST v1, webhooks assinados e MCP para IA. O que o seu time precisa para trocar de gateway sem surpresa.
- API v1Produtos, vendas, pedidos, cobranças, assinaturas e faturas. Chaves com acesso total ou somente leitura.Ver a documentação
- WebhooksEventos de venda, assinatura e fatura, assinados com HMAC-SHA256 e horário, com teste e reenvio pelo painel.Ver a documentação
- MCP para IAConecte Claude, ChatGPT e Cursor à conta pelo login do AtmosPay. O guia fica no painel, em Developers.Entrar no painel
O essencial dos webhooks
As respostas que todo integrador pede primeiro. Os detalhes e o código estão na documentação de webhooks.
- Assinatura
- X-AtmosPay-Signature: t=<segundos unix>,v1=<hex do HMAC-SHA256 de "t.corpo bruto" com o secret>. Recuse t com mais de 5 minutos de diferença. A X-Webhook-Signature (legada, sem horário) continua saindo.
- Secret
- Cada webhook tem o seu. Em branco na criação, o AtmosPay gera um (whsec_...). No painel, o dono revela, gera ou troca, e tudo fica registrado. Por 24 horas depois de uma troca, o X-AtmosPay-Signature leva dois v1 (o novo e o anterior).
- Ids da entrega
- X-Webhook-Event-Id: o event_id, igual nas tentativas e no reenvio da entrega (deduplique por ele). X-Webhook-Delivery-Id: um por tentativa. X-Webhook-Attempt: o número da tentativa.
- Testes e reenvios
- O botão Testar manda X-Webhook-Test: 1 e test: true no corpo. O reenvio manual manda X-Webhook-Resend: 1 e reenvio: true.
- Tentativas
- Sucesso é 2xx em até 30 s. Fora disso, 6 tentativas no total: a primeira na hora e as outras 1 min, 5 min, 30 min, 2 h e 6 h depois da anterior. Depois, Reenviar no painel.
- API keys
- Acesso total ou somente leitura, escolhido na criação. A de leitura recebe 403 insufficient_scope ao cancelar ou cobrar.