Criada
Você cria a cobrança pela API, por um link de pagamento ou pelo painel. Ela começa como pendente.
- Status
- Pendente
- Evento
charge.created
Pix · Produtos
Crie uma cobrança, envie o pagador para um checkout com o QR Code e o Pix Copia e Cola e receba um webhook quando ela for paga ou expirar. O checkout confirma o pagamento na tela em tempo real.
Neste site tudo roda em modo de teste: as cobranças são fictícias e nenhum dinheiro é movimentado.
O que o pagador vê
Estúdio Jacarandá
Checkout por KrokoPay
Resumo do pedido
Curso de identidade visual
Acesso vitalício · 32 aulas
R$ 497,00
O que o seu sistema recebe
Etapa 1 de 4
Criada
Seu sistema cria a cobrança pela API, por um link de pagamento ou pelo painel. O pagador é levado ao checkout.
chg_9Qs5MbT2kXn8VdEvento de webhook
{
"type": "charge.created",
"data": { "object": {
"id": "chg_9Qs5MbT2kXn8Vd",
"status": "pending"
} }
}Os prazos exibidos são valores de demonstração, não condições comerciais.
Nunca usou Pix?
O Pix é o meio de pagamento instantâneo do Brasil. O pagador abre o app do banco, lê um QR Code ou cola um código e confirma. Sem número de cartão, sem formulário para preencher e sem redirecionamento para uma página de terceiros.
Seus clientes já conhecem o Pix. O que muda é o seu lado: um objeto de cobrança, um checkout e os mesmos webhooks que você usa para cartão.
Pense nele como um pedido de pagamento com prazo. Você cria, o pagador aprova no app do próprio banco e você recebe um evento. O pagador nunca digita dados sensíveis no seu site.
Estúdio Jacarandá
Checkout por KrokoPay
Resumo do pedido
Curso de identidade visual
Acesso vitalício · 32 aulas
R$ 497,00
Escaneie o QR Code para pagar
Abra o app do seu banco, escolha Pix e escaneie o código, ou copie o código abaixo.
KROKOPAY-DEMO|PIX|chg_9Qs5MbT2kXn8Vd|BRL|49700|NOT-A-REAL-PIX-CODE|F597D6CDQR Code
Para pagar de outro aparelho: o pagador aponta a câmera do app do banco para a tela.
Pix Copia e Cola
O mesmo pagamento em texto, para quando o pagador já está no celular. Um toque copia o código.
Contagem regressiva
Toda cobrança Pix tem prazo. Quando ele acaba, o código deixa de funcionar e a cobrança expira.
Confirmação na tela
Assim que a cobrança é paga, o checkout vira uma confirmação. O pagador não precisa atualizar a página nem enviar comprovante.
Status e eventos
Uma cobrança Pix percorre um caminho curto e previsível. Seu código reage a eventos de webhook em vez de ficar consultando a API.
Você cria a cobrança pela API, por um link de pagamento ou pelo painel. Ela começa como pendente.
charge.createdO checkout mostra o QR Code, o código e a contagem regressiva. Por enquanto, nada a fazer do seu lado.
O pagador confirmou no app do banco. Libere o pedido, o acesso ou o download.
charge.paidou
Ninguém pagou antes do prazo. O código deixa de funcionar. Crie uma nova cobrança se o comprador voltar.
charge.expiredReembolsos de cobranças pagas são informados com charge.refunded.
curl -X POST https://api.krokopay.app/v1/charges \ -H "Authorization: Bearer kp_test_sk_4f9a2c7e1b8d4a6f9c3e5d7b" \ -H "Idempotency-Key: order_1042" \ -H "Content-Type: application/json" \ -d '{ "amount": 49700, "currency": "BRL", "description": "Curso Identidade Visual do Zero", "customer_id": "cus_8Hq2LmZr4TxN1a", "methods": [ "pix" ] }'{ "id": "evt_6Ff7Gg8Hh9Ii0J", "object": "event", "type": "charge.paid", "api_version": "2026-11-01", "created_at": "2026-11-03T14:23:41.000Z", "data": { "object": { "id": "chg_4Fp9KzW1xQm7Rt", "object": "charge", "amount": 49700, "currency": "BRL", "status": "paid", "method": "pix", "description": "Curso Identidade Visual do Zero", "expires_at": "2026-11-03T14:37:05.000Z", "paid_at": "2026-11-03T14:23:41.000Z" } }}Proposta provisória de contrato da API. São exemplos, não um endpoint em operação.
Como os webhooks são assinados e reenviadosNo painel
Cada cobrança aparece em Pagamentos com status, cliente e meio de pagamento. Abra uma para ver os eventos pelos quais ela passou e as entregas de webhook que gerou.
Endereço: krokopay.app/dashboard/payments
| Descrição | Meio | Status | Valor |
|---|---|---|---|
| Curso Identidade Visual do Zerochg_9Qs5MbT2kXn8Vd | Ainda não escolhido | Pendente | R$ 497,00 |
| Curso Identidade Visual do Zerochg_7Lc3PvN8yHd2Ws | Visa final 0002 | Falhou | R$ 497,00 |
| Curso Identidade Visual do Zerochg_4Fp9KzW1xQm7Rt | Pix | Pago | R$ 497,00 |
| Clube Jacarandá — Mensalchg_2Rz6TnB4mKw9Pc | Mastercard final 5100 | Pago | R$ 49,00 |
| Pack de Templates — Completochg_8Mx1WqH5dVr3Ls | Pix | Pago | R$ 149,00 |
charge.created
charge.paid
Respostas curtas, incluindo o que ainda não está definido.
Ainda não definido
Aparece como “A definir” até as condições serem finais.
Ver preçosCrie uma conta, gere uma cobrança no painel de demonstração e veja a cobrança passar de pendente para paga.
Nenhum pagamento real é feito.
