Ir para o conteúdo
DocsAPI 2026-11-13

Documentação para desenvolvedores

Integre pagamentos ao seu produto

A API do Eclipta Pay cria clientes, pedidos e cobranças (Pix, boleto e cartão), abre checkouts e avisa o seu sistema por webhooks assinados. Contrato 2026-11-13: 66 de 69 rotas de servidor já implementadas; as demais aparecem na referência como especificadas.

Cinco regras para integrar bem

  1. Dinheiro é texto em centavos. "14970" são R$ 149,70. Nunca envie reais com vírgula ou ponto, nem números de ponto flutuante.
  2. Toda mutação leva Idempotency-Key. Gere uma chave por intenção e repita a mesma chave ao refazer a chamada. Veja Idempotência.
  3. 202 é intenção aceita, não pagamento feito. Cobranças, estornos e transferências respondem com uma Operation. O resultado chega pela consulta da operação e pelos webhooks.
  4. Confirmado não é disponível. payment.confirmed significa que o pagador pagou e o valor está a liberar. Libere o produto com order.payment_completed.
  5. Webhooks chegam pelo menos uma vez. Verifique a assinatura, deduplique por eventId e descarte aggregateVersion menor que a já aplicada.