Docs
Acessar painel

Receba via Pix no seu checkout com a API da Koku

A Koku processa o Pix das suas vendas: você cria a cobrança pela API, mostra o QR Code ao comprador e recebe a confirmação por webhook. O valor entra no seu saldo e o repasse é feito pela Koku, conforme o contrato.

Criar a primeira cobrançaReferência da API

Comece por aqui

Receber via PixCrie cobranças Pix com QR Code e copia e cola, consulte o estado e acompanhe a expiração.WebhooksReceba charge.paid e os demais eventos assinados, com reenvio automático.Saldo e extratoVeja o que está pendente, disponível e a receber, com bruto, tarifa e líquido de cada venda.Chaves de APIGere a chave no painel, escolha os escopos e autentique com Authorization: Bearer.

Qual é o seu caso?

Sou lojistaQuer entender como o Pix da Koku funciona, quanto custa e quando o dinheiro chega? Comece por Como funciona, Tarifas e Saldo e extrato.Sou desenvolvedorVai integrar o checkout? Siga a Primeira cobrança e depois configure os webhooks e o checklist de produção.

O essencial em 30 segundos

  • URL da API: https://api.kokupay.com/v1
  • Autenticação: Authorization: Bearer <sua chave de API> (gerada no painel, em Desenvolvedores).
  • Valores: sempre em centavos. Na resposta, string decimal: "15990" = R$ 159,90.
  • Idempotência: Idempotency-Key obrigatório ao criar cobrança e ao pedir devolução.
  • Confirmação: o pagamento chega pelo webhook charge.paid; confirme consultando a cobrança.
  • Formato: JSON, chaves em snake_case, datas em ISO-8601 (UTC).

Precisa de ajuda?

Veja como falar com a equipe Koku em Suporte. Para integrar com segurança, leia também Segurança e o checklist de Produção.