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>