Ambientes sandbox e produção

A Appmax oferece dois ambientes distintos para integração.

Sandbox (ambiente de testes)

Utilize o sandbox para testar a integração antes de ir para produção e antes de ser aprovado na homologação.

Serviço	URL
Autenticação	https://auth.sandboxappmax.com.br
API	https://api.sandboxappmax.com.br
Autorização	https://breakingcode.sandboxappmax.com.br/appstore/integration/HASH
Script JS (Appmax JS)	https://scripts.sandboxappmax.com.br/appmax.min.js

Produção

Utilize a produção para transacionar com clientes reais.

Serviço	URL
Autenticação	https://auth.appmax.com.br
API	https://api.appmax.com.br
Autorização	https://admin.appmax.com.br/appstore/integration/HASH
Script JS (Appmax JS)	https://scripts.appmax.com.br/appmax.min.js

Resumo das diferenças

INFO

• No sandbox, as URLs usam o subdomínio sandboxappmax e o redirecionamento é para o BC Sandbox.
• Em produção, as URLs usam o domínio padrão appmax e o redirecionamento é para o Admin da Appmax.

O script do Appmax JS não é o mesmo arquivo nos dois ambientes

A URL da API fica embutida no bundle em tempo de build, então cada ambiente tem o seu build. Não existe parâmetro para apontar um para o outro.

Misturar o script de um ambiente com o external_id do outro faz a tokenização acontecer contra a API errada, que não conhece aquele merchant: o retorno é 404 Merchant not found, que chega no onError como TOKENIZATION_FAILED / status: 404. Ao trocar de ambiente, troque os dois — script e external_id.

Testando pagamentos no sandbox

• Cartão de crédito: o resultado depende do número do cartão. Veja os cartões de teste.
• Pix e boleto: são aprovados automaticamente em ~5 segundos, e há documentos específicos para manter o pedido pendente. Veja Testar no sandbox.

Instabilidades no sandbox

O ambiente de sandbox pode apresentar lentidão ou indisponibilidade temporária. Se você receber timeout (504) ou erro 503, aguarde alguns minutos e tente novamente. Esses problemas não afetam o ambiente de produção. Se persistir por mais de 30 minutos, entre em contato com o suporte.

Como migrar para produção

Terminou os testes em sandbox? Veja o guia completo de go-live, com checklist técnico, processo de homologação e o que muda ao migrar:

• Publicação em produção