Generar un QR de cobro

Nivel de seguridad requerida para este servicio

Medio Medio (accessToken)

Objetivo

Genera un código QR de cobro sobre una cuenta habilitada. Se llama una vez por cada cobro que quieras generar.

Request

Method: POST

/external/api/generate-qr

curl -X POST "https://$env/external/api/generate-qr?portfolioId=$portfolioId&personId=$personId&description=$description&amount=$amount&qrUseType=2" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN'

env: Entorno de la API, como producción o desarrollo.
YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`portfolioId`	int	Sí	Cuenta de cobro. Sale de Obtener cuentas de cobro.
`personId`	int	Sí	Titular de la cuenta. Sale de Obtener cuentas de cobro.
`description`	string	Sí	Descripción del cobro, visible en la conciliación.
`amount`	decimal	Sí	Monto del cobro, en pesos argentinos. No puede ser cero.
`qrUseType`	int	No	Tipo de QR. Por defecto `2` (`QrSingleUse`). Ver tipos de QR.
`expirationDate`	datetime	No	Vencimiento del QR. Ver vigencia.

⚠️

Los parámetros van por query string, no en el cuerpo del mensaje.

Ejemplo de Respuestas:

JSON

{
    "order_id": "PQR-000987654",
    "qr_raw": "00020101021226580011ar.com.qr01...",
    "expiration_date": "2026-09-16T18:45:00",
    "date": "2026-09-16T00:00:00",
    "amount": 1500.50,
    "description": "Pedido 123",
    "social_reason": "Comercio Demo S.A."
}

Información adicional sobre campos

order_id: identificador del QR. Es el valor que los demás endpoints piden bajo el nombre propagoQrId.
qr_raw: string EMV a codificar como imagen QR de tu lado. La API no devuelve una imagen.
expiration_date: vencimiento del QR. Si no enviaste expirationDate y el tipo es QrSingleUse, son 15 minutos desde la generación.
social_reason: razón social del titular de la cuenta de cobro.

ℹ️

Cada llamada genera un QR nuevo. No hay idempotencia: si reintentás una generación que en realidad había funcionado, vas a terminar con dos QR válidos.

Obtener cuentas de cobro Consultar estado