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.