Changelog

Mudanças que acrescentam campos ou eventos podem acontecer sem aviso: a sua integração deve ignorar campos que não conhece. Mudanças que quebram compatibilidade serão anunciadas aqui com antecedência.

#07/10/2026 — Ajustes antes da publicação

• 503 provider_unavailable passa a trazer details.reason público: processing_unavailable (repita com a mesma Idempotency-Key) ou account_not_enabled (repetir não resolve; fale com a Koku). Veja Erros.
• failure_message da cobrança failed e resolution_note de devolução não executada passam a ser textos fixos da Koku. Lista em Estados da cobrança.
• description do extrato passa a ser um texto fixo por tipo de lançamento; os repasses feitos pela Koku aparecem como gateway.external_payout. Veja Saldo e extrato.
• charge.failed sempre traz reason; cobrança cancelada antes do pagamento chega como charge.expired com data.status: "cancelled".
• Devolução: reason de 3 a 300 caracteres (o esquema dizia 500) e a mesma Idempotency-Key com outro motivo responde 409 idempotency_conflict.

#07/10/2026 — Versão inicial

• Publicação da documentação pública em docs.kokupay.com.
• API v1 para Pix: criar, consultar e listar cobranças; devolução total ou parcial; casos da cobrança (devoluções e contestações MED).
• Saldo, extrato com bruto, tarifa e líquido de cada venda, e lista dos repasses feitos pela Koku.
• Webhooks assinados (x-koku-signature, HMAC-SHA256), com reenvio automático, lista de eventos e de entregas.
• Referência gerada a partir da especificação OpenAPI (/openapi.json), com exemplos conferidos automaticamente contra a API.
• Ambiente de testes para integradores: em preparação.