Comece por aqui

Introdução

O que é a CaedralPay, como o gateway não-custodial funciona e uma visão geral do fluxo de pagamento.

A CaedralPay (razão social Caedral) é um gateway de pagamentos em criptomoedas não-custodial. O comprador paga em stablecoins — USDT, USDC, BRZ ou EURC, conforme a rede disponível — e um contrato inteligente executa o split on-chain na própria transação: taxa da Caedral, repasse do lojista e comissões de afiliados.

Nenhum valor fica retido em conta da Caedral, do lojista ou do contrato. O saldo final do contrato é sempre zero — propriedade comprovada por testes fuzz de 256 execuções e por auditoria de saldos on-chain após cada pagamento.

Como o fluxo funciona

  1. Criação da ordem — o lojista chama a API com o valor em BRL e uma referência própria. A cotação BRL→USDT é calculada e travada por 15 minutos.
  2. Pagamento — o comprador recebe a página de pagamento hospedada (/pay/{ref}) ou um QR universal padrão ERC-681 e paga pela carteira dele.
  3. Split on-chain — o contrato CaedralPaymentSplitter divide taxa e repasse na mesma transação e devolve overpayment automaticamente.
  4. Notificação — webhook assinado (payment.confirmed, HMAC-SHA256), endpoint de status e endpoint de status.

Princípios do produto

  • Autocustódia total — o lojista controla as chaves; a Caedral nunca custodia fundos.
  • Sem conta, sem SDK — integração por API REST: uma chamada cria a ordem.
  • Multi-rede — configuração para Base, Arbitrum, Optimism e Polygon; consulte as redes disponíveis na API.
  • Auditável — taxa fixada on-chain com caps públicos, cada transação com link no explorer.
Dica

Comece pela Iniciação rápida: em três chamadas você emite uma ordem real de teste e acompanha a liquidação.

O que você vai encontrar nesta documentação

Seção Conteúdo
Comece por aqui Visão geral e primeira venda em 3 passos
Referência Moedas, redes suportadas e modelo de taxas
API Rotas REST, payloads, webhooks e códigos de erro
Pagamentos QR universal ERC-681 e liquidação settleDirect