`POST /qr/generate`

Genera un QR de pago interbancario. Crea la transacción y devuelve la imagen lista para mostrar. Guía completa: Flujo de pago con QR.

Auth: requiere x-wpay-key.

Request

Campo	Tipo	Requerido	Descripción
`amount`	number	✅	Monto a cobrar.
`order_id`	string	—	Tu identificador interno.
`name`	string	—	Nombre de la transacción (default `Pago QR`).
`description`	string	—	Descripción.
`id_currency`	number	—	`1` BOB (default) · `2` USD.
`moneda`	string	—	Moneda que muestra el QR: `BOB` (default) o `USD`.
`metadata`	object	—	JSON libre.

Response `201`

{
  "reference": "WP-1784169095747-578AFA46",
  "qr": {
    "numero_referencia": 9509574123,
    "imagen": "iVBORw0KGgoAAAANSUhEUgAA...",
    "monto": 350.0,
    "moneda": "BOB",
    "estado": "00"
  }
}

qr.imagen — PNG en base64: <img src={"data:image/png;base64," + imagen} />.
qr.numero_referencia — id del QR en la red bancaria (para GET /qr/status).
reference — tu transacción WizPay (para el stream SSE y /status).
El QR expira en 10 minutos (estado: "00" = generado OK).

Errores

HTTP	Mensaje
`400`	`amount es requerido`
`400`	Mensaje del gateway QR si la generación falla.

Pruébalo

POST/qr/generate⚡ Simulador — se ejecuta en tu navegador

Ruta

Header x-wpay-key (prueba dejarlo vacío o poner “invalid”)

Body (JSON)

Ver cURL equivalente (producción)

curl -X POST "https://api.wizpay.app/qr/generate" \
  -H "x-wpay-key: wpk_sandbox_demo" \
  -H "Content-Type: application/json" \
  -d '{ "order_id": "ORD-1042", "name": "Pedido #1042", "amount": 350, "moneda": "BOB" }'

GET /status/:reference QR: status y stream (SSE)

POST /qr/generate

Request

Response 201

Errores

Pruébalo

`POST /qr/generate`

Response `201`