Pagamentos

QR universal (ERC-681)

Como o QR da CaedralPay funciona: URI ERC-681, pagamento direto ao contrato e liquidação settleDirect.

O QR da CaedralPay não é um endereço simples — é uma URI ERC-681 completa, que codifica rede, token, contrato e valor. A compatibilidade depende da carteira e da rede.

Anatomia da URI

ethereum:{tokenAddress}@{chainId}/transfer?address={splitter}&uint256={rawUnits}
Parte Exemplo Significado
tokenAddress 0x4c56…EFE Contrato do token (USDT/USDC)
chainId 8453 Rede da ordem (Base)
address contrato do splitter Destino do pagamento
uint256 27638000 Valor em unidades brutas, conforme os decimais do token

O endpoint GET /api/crypto/v1/orders/{ref}/qr devolve a imagem SVG já codificada com essa URI — renderize direto no checkout:

<img
  src="https://api.caedral.com/api/crypto/v1/orders/REF_DA_ORDEM/qr"
  alt="QR de pagamento"
/>

Pagamento direto com settleDirect

Além do fluxo com approve + pay, o contrato expõe o caminho settleDirect: o comprador transfere o token diretamente ao contrato do splitter e o operador registra a liquidação.

  • Funciona em qualquer carteira, inclusive as que não fazem approve contratual;
  • O valor da ordem é único por referência — o contrato casa o pagamento com a ordem correta;
  • Excedente é devolvido; valor a menor reverte.

Por que isso importa

Recurso Benefício
ERC-681 padrão Compatível com MetaMask, Rabby, Rainbow, Trust e demais carteiras
Valor único por ordem Sem colisão entre pagamentos simultâneos
Multi-rede A URI já carrega o chainId — a carteira pode solicitar a troca de rede
Liquidação direta Sem custódia intermediária em nenhum ponto do fluxo
Dica

Sempre renderize o QR a partir do qrCodeUrl da ordem — nunca gere a URI manualmente, pois ela depende da cotação travada e das decimais corretas.