Pular para o conteúdo
KrokoPay
EntrarCriar conta

Para e-commerce

Pedidos pagos com Pix ou cartão, confirmados na sua loja

Pedido parado em "aguardando pagamento" é chamado de suporte na certa. O checkout da KrokoPay aceita Pix ou cartão e avisa a sua loja no momento em que o pedido é pago, ou quando o Pix expirou sem pagamento.

Criar contaConhecer o checkout

Teste o checkout ao lado: escolha Pix ou cartão.

Casa Maré

Checkout por KrokoPay

Modo de teste

Resumo do pedido

2 canecas de cerâmica + 1 travessa

R$ 189,00

TotalR$ 189,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.

Aguardando pagamentoExpira em 14:52
KROKOPAY-DEMO|PIX|chg_9Qs5MbT2kXn8Vd|BRL|18900|NOT-A-REAL-PIX-CODE|E0B78FDD

Controle da demo: marca esta cobrança fictícia como paga.

Do carrinho ao envio

Uma cobrança por pedido, um evento de volta

A sua loja cuida do carrinho e do estoque. A KrokoPay cuida da página de pagamento e da confirmação.

  1. O cliente finaliza a compra

    A sua loja cria uma cobrança com o valor do pedido.

  2. Abre o checkout

    Redirecione para o checkout_url da cobrança.

  3. Paga com Pix ou cartão

    O QR Code ou o formulário de cartão, no checkout próprio da KrokoPay.

  4. A sua loja é avisada

    Chega charge.paid e o pedido passa para pronto para envio.

O que o comprador vê

Um Pix que paga e se confirma sozinho

O comprador lê o QR Code ou copia o código, paga no app do banco dele e o checkout se atualiza sozinho. Sem comprovante para enviar, sem conferência manual do seu lado.

  • O Pix tem validade; quando ela passa, a cobrança expira e você recebe um evento.
  • O cartão fica no mesmo checkout, na aba ao lado.
  • O nome da sua loja aparece no checkout.

O que o pagador vê

Casa Maré

Checkout por KrokoPay

Modo de teste

Resumo do pedido

Curso de identidade visual

Acesso vitalício · 32 aulas

R$ 497,00

TotalR$ 497,00
Gerando seu código Pix…

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.

Status da cobrança
Pendente
Referência
chg_9Qs5MbT2kXn8Vd

Evento 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.

Sua loja, sincronizada

O webhook marca o pedido como pago

Crie a cobrança com a Idempotency-Key do próprio pedido e trate dois eventos: pago vai para o envio, expirado libera o estoque. Simule os dois no pedido abaixo.

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": 18900,    "currency": "BRL",    "description": "Casa Maré #1042",    "methods": [      "pix",      "card"    ]  }'

Proposta provisória de contrato de API — não é um endpoint em operação. verifySignature representa a verificação de assinatura descrita na documentação de webhooks. Proposta de contrato, sujeita a mudanças.

Seu sistema

Demo interativa

Pedido #1042

Cliente
Ana Ribeiro
Total
R$ 189,00
Cobrança
chg_8Mr3EcQ7wT2nVb
Status
Aguardando pagamento

Evento recebido pelo seu endpoint

Nenhum evento ainda. Use um dos botões para ver o que chega ao seu endpoint.

Os casos difíceis

O que acontece quando não dá tudo certo

Cada um tem o seu próprio status ou campo, para a sua loja não precisar adivinhar.

  • O Pix nunca foi pago

    charge.expiredExpirado

    Depois da validade, a cobrança fica expired e charge.expired é enviado. Libere o estoque e, se quiser, ofereça uma nova cobrança.

  • O cartão foi recusado

    failure_codeFalhou

    A cobrança fica failed e traz um failure_code para a sua loja explicar o problema e sugerir outra forma de pagamento.

  • O cliente clicou duas vezes

    Idempotency-Key

    Envie o número do pedido como Idempotency-Key. Repetir a mesma requisição devolve a mesma cobrança, em vez de criar outra.

  • O pedido foi devolvido

    charge.refundedReembolsado

    Reembolse pelo painel. A cobrança fica refunded e charge.refunded avisa a sua loja para atualizar o pedido.

Transparência

O que está pronto e o que ainda não está

Antes de planejar um lançamento, veja em que pé estão as coisas. Sem números inventados.

Já está no produto

  • Checkout hospedado com Pix e cartão.
  • Eventos de cobrança: created, paid, failed, expired, refunded.
  • Idempotency-Key para evitar cobranças duplicadas.
  • Reembolsos pelo painel.

Ainda em definição

  • Parcelamento no cartão.A definir
  • Plugins prontos para plataformas de loja.A definir
  • Tarifas e prazos de repasse.A definir
Veja o que já está definido em preços

Perguntas de lojas virtuais

O que lojistas costumam perguntar antes de integrar.

Não encontrou sua pergunta?

O que já está definido em preçosFale com a gente

Ainda não. A integração é feita pela API e pelos webhooks, que qualquer loja com backend consegue chamar.

O seu endpoint recebe charge.paid com o id da cobrança. Marque o pedido como pago ali, em vez de confiar no retorno do comprador ao seu site.

A cobrança expira e você recebe charge.expired. Você pode liberar o estoque e cancelar ou reabrir o pedido.

O parcelamento no cartão ainda será anunciado. Hoje o cartão é cobrado à vista.

Os prazos de repasse ainda estão em definição e serão publicados na página de preços.

Sim. O checkout mostra o nome do seu negócio e a descrição do pedido, para o comprador saber para quem está pagando.

Continue explorando

Os produtos por trás desta página, a documentação para integrá-los e os outros segmentos.

Passe o seu primeiro pedido pelo checkout

Crie sua conta, gere uma cobrança de teste e veja a sua loja receber charge.paid.

Criar contaLer a documentação

Nenhum pagamento real é feito.