Pagar con PIX

PIX paga compras, nunca recarga el saldo. Se cobra en reales con la tasa del momento y un recargo, y tu banco suma el IOF (3,5 %) al pagar.

Requisitos: KYC aprobado, CPF verificado y estar en Brasil, sea cual sea el país de tu documento. Verificar el CPF exige una cuenta GOLD vigente.

Tope y plazosCopy Anchor Link

• Tope: $400 cobrados cada 30 días rodantes por cuenta, sumando todas las compras. Lo reembolsado también cuenta.
• Un solo QR abierto por cuenta.
• Primera compra desde una cuenta Pix nueva: las gift cards y el marketplace se entregan a las 72 h. Las recargas y eSIM, al instante hasta $25 acumulados; por encima, también a las 72 h. Pasado ese plazo sin incidencias, esa cuenta Pix entrega al momento.
• Descuento en sats: no se aplica a un pago con PIX.
• Sin PIX: las marcas de gift card bloqueadas, los paquetes de Cuba entregados por P2P, las gift cards de tiendas y las tiendas de proveedor.

Si una compra retenida no se puede completar, el dinero vuelve en reales a la misma cuenta Pix que pagó, nunca al saldo.

GET /pix/eligibilityCopy Anchor Link

Dice si la cuenta puede pagar con PIX ahora y cuánto cupo le queda.

{
  "data": {
    "eligible": true,
    "reason": null,
    "gold_required": false,
    "surfaces": ["topup", "esim"],
    "quote": { "usd_per_brl": 0.18, "surcharge_pct": 4 },
    "cap": { "cap": 400, "used": 60.5, "remaining": 339.5, "resets_at": "2026-12-01T10:00:00.000Z", "window_days": 30 },
    "hold_hours": 72,
    "instant_max_usd": 25
  }
}

reason puede ser DISABLED, GEO, KYC_REQUIRED, CPF_REQUIRED o RATE_UNAVAILABLE. gold_required es true si falta el CPF y la cuenta no es GOLD, así que aún no puede verificarlo. surfaces lista las compras abiertas: cuba, topup, esim, voucher, market.

POST /pix/checkoutCopy Anchor Link

Crea el cobro y devuelve el QR. Límite: 1 llamada cada 10 segundos. Lleva source y los mismos campos de cada compra:

curl -X POST https://api.qvapay.com/pix/checkout \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "source": "esim", "offer_id": "ESIM_BR_5GB", "country": "BR" }'

{
  "data": {
    "uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "surface": "esim",
    "stage": "awaiting_payment",
    "description": "eSIM BR · 5 GB",
    "total_usd": 10.4,
    "total_brl": 57.78,
    "refunded_brl": 0,
    "expires_at": "2026-11-06T15:34:05.000Z",
    "paid_at": null,
    "clearing_until": null,
    "qr": { "data": "00020126…", "image_url_png": "https://…", "hosted_instructions_url": "https://…", "expires_at": 1793979245 }
  }
}

qr.data es el código Pix «copia y pega». Muestra junto al QR el aviso legal del IOF, en portugués:

Esta é uma compra internacional e não inclui a tarifa de 3.5% de IOF. Ao prosseguir, você reconhece e aceita os termos e condições do Ebanx.

ErroresCopy Anchor Link

GET /pix/checkout/{uuid}Copy Anchor Link

Estado del cobro, para consultar cada pocos segundos mientras el QR está abierto. Solo el dueño lo ve; un uuid ajeno responde 404.

DELETE /pix/checkout/{uuid}Copy Anchor Link

Cancela un QR abierto. Si el pago acaba de entrar responde 409 PIX_NOT_CANCELLABLE y la compra sigue su curso.

Compras en verificaciónCopy Anchor Link

GET /store/my añade pix_holds: las compras pagadas con PIX que aún se están verificando, con la misma forma que GET /pix/checkout/{uuid}.