Confido Docs

Ambientes: produção e teste

A chave decide o ambiente (ch_live_ é produção, ch_test_ é teste) e o que já funciona em cada um hoje.

Na Confido o endereço é um só, https://api.confidoscm.com. Quem decide o ambiente é a chave:

Chave Ambiente O que acontece
ch_live_… Produção Vendas reais, dinheiro de verdade, avisos reais aos clientes. livemode: true.
ch_test_… Teste Tudo isolado da produção, sem dinheiro de verdade. livemode: false.

O ambiente de teste (sandbox)

No painel, o menu da conta › Ambiente › Novo ambiente de teste cria uma sandbox: uma cópia isolada da conta, com clientes, cobranças, links, saldo, chaves e webhooks próprios. A chave criada lá dentro é sempre ch_test_.

  • Tudo o que nasce na sandbox é teste: livemode: false nas respostas e nos webhooks, e-mails com "[Teste]" e a página de pagamento com a faixa "Modo de teste".
  • Zerar a sandbox (Configurações › Integrações › Início) cria outra no lugar: o id muda e as chaves são revogadas. Gere uma chave nova depois.

O que já funciona com ch_test_ (situação em novembro de 2026)

Rotas Com ch_test_
Cobranças (/charges), links (/payment-links), subcontas (/accounts), webhooks (/webhook-endpoints) Funcionam, na sandbox da chave: criar, listar, consultar e mandar o webhook.test.
Vendas diretas (POST /payments, GET /payments/{id}) Ainda não. A produção aceita só ch_live_ nos pagamentos; uma ch_test_ recebe 403 "API key "test" não vale neste ambiente: use uma chave live".
Pagar a página (checkoutUrl) de uma cobrança de teste Ainda não. O pagamento de teste depende do mesmo serviço de teste dos pagamentos.

Sendo direto: o teste das vendas pela chave está a caminho. Quando ele sair, a mesma chamada com uma ch_test_ vai passar por adquirentes de teste, sem cobrar, e este guia será atualizado. Até lá:

  1. Use a ch_test_ para montar e conferir toda a parte de cobranças, links, subcontas e webhooks.
  2. Para validar a venda de ponta a ponta, faça uma venda real de valor baixo com a ch_live_ e estorne pelo painel. No estorno a taxa da venda não volta.

Boas práticas

  • Use variáveis diferentes para cada chave (CONFIDO_API_KEY_LIVE e CONFIDO_API_KEY_TEST) e nunca misture.
  • Confira o livemode das respostas e dos webhooks antes de liberar um pedido.
  • Os webhooks da sandbox vão para os endpoints cadastrados na sandbox, não para os da produção.