Por onde começar
Novo na Appmax? Este guia ajuda você a entender o modelo de integração e escolher o caminho certo para o seu cenário.
O que é a Appmax?
A Appmax é uma plataforma de pagamentos com gateway, antifraude e adquirência integrados. A integração acontece via uma Loja de Aplicativos (Appstore): você cria um aplicativo, merchants instalam esse app em suas lojas, e a partir daí você processa pagamentos em nome deles.
Modelo Appstore vs API direta
Se você vem de outros gateways (PagSeguro, Mercado Pago, Stripe), pode estranhar o modelo. A diferença:
| Gateway tradicional | Appmax |
|---|---|
| Você recebe credenciais diretas por email | Credenciais são geradas via fluxo de instalação |
| Uma chave de API por conta | Um par de credenciais por merchant que instala seu app |
| Integra direto na API | Cria um app na Appstore → merchant instala → gera credenciais → integra |
INFO
Essa arquitetura existe para que um único app sirva múltiplos merchants com isolamento de dados e credenciais por loja.
Escolha seu cenário
Quero integrar um checkout próprio
Você é um desenvolvedor construindo um checkout customizado para um merchant (ou para si mesmo).
- Criar seu aplicativo (privado se for para um merchant só)
- Instalar e obter credenciais
- Quickstart — primeiro pagamento
- Exemplo completo de integração
Quero construir uma plataforma para múltiplos merchants
Você está criando uma plataforma (ERP, e-commerce, marketplace) que será usada por vários merchants.
- Criar seu aplicativo (público)
- Instalação — entender o fluxo de 4 etapas
- Autenticação — entender app vs merchant credentials
- Publicação em produção
Quero adicionar upsell pós-compra
Conceitos que vão aparecer
| Conceito | O que é | Onde aprender |
|---|---|---|
| App vs Merchant credentials | Dois pares de credenciais com escopos diferentes | Autenticação |
| Health check / URL de validação | Endpoint do seu sistema que a Appmax chama durante a instalação para receber o external_id (UUID) que vincula a instalação à loja | Instalação · Valide sua URL |
| Webhook | Notificação em tempo real de eventos (pedido pago, etc) | Webhooks |
| Sandbox vs Produção | Dois ambientes com URLs diferentes | Ambientes |
| Valores em centavos | Todos os valores monetários são inteiros em centavos | Conceitos |
Precisa de ajuda?
- FAQ — respostas para dúvidas frequentes
- Integração com IA — conecte Claude, Cursor ou outro agente MCP para acelerar