Projetos de exemplo

Os guias desta seção mostram o código trecho a trecho. Se você prefere clonar algo que já roda e ler por dentro, existem dois repositórios abertos com a integração inteira: instalação do app na loja e checkout com tokenização, ponta a ponta.

Escolha pela stack — os dois cobrem o mesmo fluxo, com ênfases diferentes.

appstore-demo-nextjs

Next.js (App Router) — Server Components e Route Handlers. Checkout com cartão tokenizado e Apple Pay, credenciais editáveis em tela e seletor de ambiente. É o projeto por trás do guia Checkout em SPA.

appstore-demo-php

PHP puro — sem framework, sem composer, SQLite e Docker. Frontend em HTML/CSS/JS puro. Checkout com cartão, Pix e Apple Pay, mais um painel que loga os webhooks recebidos.

O que cada um cobre

	appstore-demo-nextjs	appstore-demo-php
Stack	Next.js 16, TypeScript, React	PHP puro, HTML/JS, Docker
Instalação do app	sim	sim
Health check	sim	sim
Cartão tokenizado	sim	sim
Pix	não	sim
Apple Pay	sim	sim
Webhooks	não	painel com o JSON cru de cada evento
Sandbox e produção lado a lado	sim	sim

O repositório em PHP nasceu do trabalho de Apple Pay, e é o mais completo em meios de pagamento. O de Next.js é o mais detalhado sobre o contrato do Appmax JS numa SPA — ordem de montagem do DOM, formas do init() e o que fazer com o external_id.

Nenhum dos dois é código de produção

São bancadas de teste: as telas de configuração não têm autenticação, e os segredos ficam em SQLite sem criptografia. Os próprios READMEs listam o que precisa mudar antes de qualquer coisa parecida ir ao ar. Use credenciais de sandbox.

Por onde começar

1. Crie um aplicativo no painel — veja Criar aplicativo.
2. Suba o projeto atrás de um túnel HTTPS público: a Appmax não alcança localhost, nem para o health check da instalação, nem para o Apple Pay.
3. Rode a instalação pela tela do projeto e guarde o external_id que o health check devolveu — é ele que o checkout usa. Ver external-id.