Ambientes
URLs
| Recurso | Sandbox | Produção |
|---|---|---|
| API Base | https://{FQDN} | https://{FQDN} |
| Tokenizer JS | https://cdn.simpleps.com/sandbox/inyo.js | https://cdn.simpleps.com/production/inyo.js |
| Especificação OpenAPI | {FQDN}/q/swagger-ui | ā |
Ambiente Sandbox
Use o sandbox para desenvolvimento e testes. As transaƧƵes sĆ£o simuladas ā nenhum dinheiro real Ć© movimentado e nenhuma rede de cartƵes Ć© contatada.
Recursos do sandbox:
- Funcionalidade completa da API, espelhando o comportamento de produção
- CartƵes de teste para simular aprovaƧƵes, recusas, desafios 3DS e resultados de AVS
- Códigos de simulação via nome do titular do cartão (ex.:
REFUSEDdispara uma recusa) - Entrega de webhooks aos seus endpoints configurados
LimitaƧƵes do sandbox:
- Sem autorização real na rede de cartões
- Alguns comportamentos especĆficos de emissores podem diferir da produção
- Os limites de taxa podem ser menores que os de produção
Ambiente de Produção
Use a produção para transações reais, com dinheiro de verdade. Garanta que todas as integrações estejam completamente testadas no sandbox antes de entrar em produção.
Antes de ir para produção:
- [ ] Todos os fluxos de pagamento testados de ponta a ponta no sandbox
- [ ] Endpoints de webhook configurados e verificados
- [ ] Tratamento de erros e lógica de retry implementados
- [ ] Fluxos de redirect 3DS testados (sucesso e falha)
- [ ] URLs de origem para CORS fornecidas Ć equipe da Inyo
- [ ] Credenciais de produção recebidas e armazenadas com segurança
Configuração de CORS
Durante o onboarding, forneƧa Ć Inyo suas URLs de origem para ambos os ambientes. A biblioteca de tokenização (inyo.js) se comunica com os servidores da Inyo a partir do navegador, entĆ£o seu domĆnio precisa estar na lista de permissƵes conforme a polĆtica de CORS.
