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
- 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.
- 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. - Split on-chain — o contrato
CaedralPaymentSplitterdivide taxa e repasse na mesma transação e devolve overpayment automaticamente. - 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.
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 |