API · Ordens
Obter QR da ordem
GET /api/crypto/v1/orders/{ref}/qr — imagem SVG do pagamento.
GET /api/crypto/v1/orders/{ref}/qr
Gera um SVG que codifica a paymentUri ERC-681 da ordem. Não requer autenticação.
| Parâmetro | Local | Descrição |
|---|---|---|
ref |
Caminho | Referência 0x mais 64 dígitos hexadecimais. |
size |
Query | Largura em pixels; padrão 320, limitada entre 128 e 1024. |
curl 'https://api.caedral.com/api/crypto/v1/orders/REF_DA_ORDEM/qr?size=480' -o pagamento.svg
200 devolve image/svg+xml, com cache privado de 60 segundos. 400 indica referência malformada, 404 ordem inexistente, 409 URI indisponível para a ordem e 500 falha de geração. A compatibilidade depende da carteira e da rede; ofereça também o link de pagamento. Veja QR universal.
Exemplo de resposta 200
A resposta é um documento SVG, não JSON. O conteúdo abaixo representa apenas a estrutura; os caminhos variam de acordo com a URI do pagamento.
HTTP/1.1 200 OK
Content-Type: image/svg+xml
Cache-Control: private, max-age=60
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 37 37">...</svg>