Começar
Ambientes
Produção e ambiente de testes, URL da API e como a chave define o ambiente.
Produção
| Item | Valor |
|---|---|
| URL base | https://api.kokupay.com/v1 |
| Chaves | koku_live_... |
| Painel | app.kokupay.com (abre em nova aba) |
| Dinheiro | Real: cada cobrança paga é uma venda de verdade. |
O ambiente vem da chave. Todas as respostas de recursos trazem environment, e as cobranças trazem is_simulated. Com uma chave de produção, environment vem production e is_simulated vem false. Os valores sandbox e is_simulated: true estão reservados para o ambiente de testes, que ainda está em preparação.
Ambiente de testes: em preparação
Enquanto isso, para validar a sua integração:
- Leia os exemplos desta documentação: todos são conferidos automaticamente contra a API, com valores fictícios e o formato real das respostas.
- Combine com a equipe Koku uma validação em produção com cobranças de valor baixo antes de abrir o Pix para os seus compradores. Veja o checklist de Produção.
- Use Dados da chave atual para conferir se a chave é de produção (
environment: "production").
Separação entre ambientes
Quando o ambiente de testes estiver disponível, ele será separado da produção: dados de um ambiente não aparecerão no outro (uma cobrança criada com uma chave de testes não será encontrada com uma chave de produção, e a resposta será 404), e os webhooks de cada ambiente serão cadastrados separadamente. Hoje só existem chaves de produção (koku_live_...).