API da Alphazz — Documentação para Desenvolvedores

A API REST da Alphazz permite que você automatize a criação de clientes, produtos, faturas e gerencie cobranças diretamente do seu sistema. Os endpoints são autenticados por token de empresa, retornam JSON e seguem os verbos HTTP padrão.

Benefícios da API

  • Automatize a criação de faturas e cobranças a partir de qualquer sistema externo (ERP, CRM, site próprio).
  • Consulte status de pagamentos em tempo real sem acessar o painel.
  • Gerencie clientes e histórico de compras programaticamente.
  • Integre com webhooks de saída para receber notificações de eventos no seu sistema.

Autenticação

Toda requisição à API exige o header X-API-TOKEN com o token da empresa e o header X-Company-ID com o ID da loja.

curl -X GET https://api.alphazz.com/api/v1/customers \ -H "Authorization: Bearer seu-token-aqui" \ -H "Accept: application/json"

Endpoints principais

POST /api/v1/customers Criar cliente GET /api/v1/customers Listar clientes GET /api/v1/customers/{id} Detalhes do cliente POST /api/v1/products Criar produto GET /api/v1/products Listar produtos POST /api/v1/invoices Criar fatura GET /api/v1/invoices/{id} Detalhes da fatura POST /api/v1/webhooks Configurar webhook de saída

Exemplo: Criar fatura

curl -X POST https://api.alphazz.com/api/v1/invoices \ -H "Authorization: Bearer seu-token" \ -H "Content-Type: application/json" \ -d '{ "customer_id": 456, "products": [ {"product_id": 10, "quantity": 1} ], "payment_method": "pix" }'

Resposta: 201 Created com o objeto completo da fatura, incluindo o hash de checkout.

Como a Alphazz ajuda

Diferente de soluções que exigem você gerenciar gateways, status de pagamento e notificações manualmente, a API da Alphazz abstrai toda a complexidade de pagamentos. Você cria a fatura, define o método de pagamento (Pix, boleto ou cartão) e a plataforma gerencia o resto — do processamento no gateway até a confirmação. O resultado chega via webhook no seu sistema, sem polling.

Perguntas Frequentes

Preciso de um token diferente para cada loja?

Sim. Cada empresa (Company) gera seu próprio token de API. O header X-Company-ID identifica qual loja está sendo acessada.

A API suporta rate limiting?

Sim. Consulte a documentação de limites por plano da sua empresa. Planos superiores têm limites mais altos de requisições por minuto.

Posso testar sem token de produção?

Sim, utilize o ambiente sandbox. O token de sandbox é gerado no painel administrativo e permite testar todos os fluxos sem custo.

Onde configuro meu webhook de saída?

A URL do webhook é configurada via POST /api/v1/webhooks. Utilize a URL https://api.alphazzcloud.com como destino para receber os eventos no seu sistema.

Onde encontro a lista completa de endpoints?

A referência completa está disponível na documentação completa , com todos os parâmetros, exemplos de resposta e códigos de erro.

Quer integrar sua loja?

Veja os guias de integração com WooCommerce e Shopify para conectar sua loja em minutos, ou acesse a documentação completa da API para explorar todos os recursos disponíveis.

Saiba mais sobre integração Ver documentação completa
Logo

A plataforma completa para pagamentos online com checkout whitelabel

© 2026 Alphazz Checkout. Todos os direitos reservados.