Ambiente de teste

Hoje o ambiente de teste é o único ambiente. Ele roda dentro do painel de demonstração e do checkout hospedado, no seu navegador: nada é enviado a um servidor, nenhum dinheiro circula e nenhum cartão ou banco real participa.

• Cobranças, links de pagamento, clientes, produtos, preços e assinaturas, criados e atualizados como a API descreve.
• O checkout hospedado em /pay/{id}, com cartão e Pix.
• Reembolsos, saldos e saques, com tarifas e prazos de demonstração. Não são condições comerciais.
• Entregas de webhook e logs da API, gerados no navegador.

As chaves de teste começam com kp_test_. Elas são fictícias: só existem na demonstração e não autenticam em lugar nenhum. Veja Chaves de API para prefixos e troca de chaves.

# Secret key: server-side onlykp_test_sk_4f9a2c7e1b8d4a6f9c3e5d7b​# Publishable key: reserved for future client-side usekp_test_pk_8b1d3f5a7c9e2b4d6f8a0c2e​# Webhook signing secretwhsec_test_2e4c6a8b0d1f3a5c7e9b

Use estes números no formulário de cartão do checkout hospedado. Qualquer validade futura e qualquer CVC funcionam.

• Qualquer outro número que passe na verificação de dígitos do cartão (Luhn) é aprovado.
• Números que não passam na verificação são recusados com card_declined.
• Uma tentativa recusada deixa a cobrança como failed e envia charge.failed. Veja falhas de pagamento.

1. 1

   Passo 1: Escolha Pix

   Abra uma cobrança pendente ou um link de pagamento no checkout hospedado e escolha Pix.

2. 2

   Passo 2: Receba o código de demonstração

   A página mostra um QR Code e um código copia e cola fictícios. Eles não seguem o formato real de propósito, para que nenhum app de banco consiga lê-los.

3. 3

   Passo 3: Simule o pagamento

   Abra os Controles de demonstração e toque em Confirmar pagamento Pix. A cobrança vira paid e o charge.paid é entregue.

Se ninguém pagar antes de a contagem terminar (15 minutos na demonstração, um valor de demonstração), a cobrança vira expired e o charge.expired é entregue. Expirar o código, nos controles de demonstração, faz o mesmo na hora.

{  "id": "chg_9Qs5MbT2kXn8Vd",  "object": "charge",  "amount": 49700,  "currency": "BRL",  "status": "pending",  "method": null,  "card": null,  "description": "Curso Identidade Visual do Zero",  "customer_id": "cus_8Hq2LmZr4TxN1a",  "product_id": "prod_3Vb7QpK9sWd2Ee",  "price_id": "price_5Kd1NcR8vYq3Hm",  "link_id": null,  "subscription_id": null,  "fee": null,  "net": null,  "refunded_amount": 0,  "failure_code": null,  "created_at": "2026-11-03T18:40:00.000Z",  "paid_at": null,  "expires_at": null,  "available_at": null,  "checkout_url": "https://krokopay.app/pay/chg_9Qs5MbT2kXn8Vd"}

Os endpoints que você cadastra em Desenvolvedores → Webhooks recebem entregas simuladas com o mesmo envelope da API. As entregas são geradas no seu navegador: a sua URL nunca é chamada. Use-as para conferir os payloads e o fluxo de assinatura descrito em Webhooks.

{  "id": "evt_3Xx4Yy5Zz6Aa7B",  "object": "event",  "type": "charge.expired",  "api_version": "2026-11-01",  "created_at": "2026-11-03T18:55:00.000Z",  "data": {    "object": {      "id": "chg_9Qs5MbT2kXn8Vd",      "object": "charge",      "amount": 49700,      "currency": "BRL",      "status": "expired",      "method": "pix",      "card": null,      "description": "Curso Identidade Visual do Zero",      "customer_id": "cus_8Hq2LmZr4TxN1a",      "product_id": "prod_3Vb7QpK9sWd2Ee",      "price_id": "price_5Kd1NcR8vYq3Hm",      "link_id": null,      "subscription_id": null,      "fee": null,      "net": null,      "refunded_amount": 0,      "failure_code": null,      "created_at": "2026-11-03T18:40:00.000Z",      "paid_at": null,      "expires_at": "2026-11-03T18:55:00.000Z",      "available_at": null,      "checkout_url": "https://krokopay.app/pay/chg_9Qs5MbT2kXn8Vd"    }  }}

Tudo o que você cria fica guardado só neste navegador. Para recomeçar, abra o menu da conta no canto superior direito do painel e escolha Restaurar dados de demonstração: os dados fictícios originais voltam e as suas mudanças são apagadas. Mais respostas em Ajuda.