LYNX UPBANK · Tecnologia de pagamentos Pix & Crypto

Criar cobrança LYNX QR

POST/v1/lynx-qr/create

Gera um QR Lynx com valor embutido (funciona como um copia e cola) para receber de OUTRA conta Lynx. Quem paga escaneia o QR no app (Transferir → QR Lynx) ou cola o payload. A liquidação é interna e instantânea, sem passar pela rede PIX. Disponível apenas com chave live.

Permissão necessária: TRANSFER:CREATE

Parâmetros

Parâmetro	Tipo	Descrição
`amountCents`obrig.	integer	Valor em centavos (mínimo 100 = R$ 1,00; máximo R$ 50.000,00).
`message`	string	Recado exibido a quem paga (até 140 caracteres). Ex.: Pedido #42.
`expiresMinutes`	integer	Validade em minutos (15 a 10080 = 7 dias). Sem o campo, não expira.
`singleUse`	boolean	true (padrão): expira ao ser pago. false: aceita vários pagamentos.

Boas práticas

Mostre o qrCodeUrl como imagem OU envie o payload por texto: os dois funcionam.
Confirme o recebimento pelo webhook lynxQr.paid; a consulta de status é só reforço.
Transferência interna: sem custo de provedor e liquidação instantânea, 24/7.

Requisição

bash

curl -X POST https://lynxpix.cc/api/v1/lynx-qr/create \
  -H "Authorization: Bearer lynx_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"amountCents":5000,"message":"Pedido #42","expiresMinutes":1440}'

Resposta

json

{
  "data": {
    "id": "lqr_9f8a2c1e",
    "type": "charge",
    "status": "active",
    "payload": "LYNXQR:lqr_9f8a2c1e.a1b2c3d4",
    "qrCodeUrl": "https://lynx.app/api/transfers/qr/lqr_9f8a2c1e/qrcode.png",
    "amount": 5000,
    "message": "Pedido #42",
    "singleUse": true,
    "expiresAt": "2026-07-02T12:00:00Z",
    "paidCount": 0,
    "createdAt": "2026-07-01T12:00:00Z"
  },
  "error": null
}