Generar QR (Base64)

Genera un QR de cobro y devuelve la imagen en Base64 junto con identificadores de seguimiento.

• Responsable: Sistema QR-Comercio

• Consumidor: Sistema interno del comercio

• Método: POST

• Endpoint:

  • /ws-qr-service/qr/simple/encript64

---

Request

Cabecera general

POST /ws-qr-service/qr/simple/encript64
Content-Type: application/json

Cuerpo (JSON)

{
  "infoTx": {
    "sisOrigen": "SO_1"
  },
  "qrCobro": {
    "idTrans": "000000000001",
    "codMoneda": "604",
    "importe": "10000",
    "glosa": "Venta de Prueba 1",
    "fechaVencimiento": "2020-02-19",
    "usoUnico": true,
    "codOperacion": "",
    "cuentaAbono": "CUENTA1_BS",
    "pos": "POS1",
    "cajero": "CAJ1",
    "canal": "WEB",
    "tiempoDuracion": 60,
    "codProducto": "COD_1234",
    "catProducto": "CAT_4321",
    "sucursal": "Sucursal_1",
    "nombreComercio": "ComercioX",
    "info": ""
  }
}

Campos principales

infoTx

Campo	Tipo	Obligatorio	Descripción
sisOrigen	string(10)	Sí	Código del sistema origen (pre-asignado).

qrCobro

Campo	Tipo	Obligatorio	Descripción
idTrans	string(20)	Sí	ID único de la transacción generado por el POS.
codMoneda	string(3)	Sí	Código ISO 4217 (ej. 604 = PEN, 840 = USD).
importe	integer(10)	Sí	Monto en centavos, sin punto decimal.
glosa	string(120)	Sí	Concepto/cadena que describe el cobro.
fechaVencimiento	string(10)	No	Formato yyyy-MM-dd. Si se omite el campo, se usa la fecha actual. No enviar cadena vacía.
usoUnico	boolean	No	Indica si el QR puede usarse una sola vez. true por defecto.
codOperacion	string(30)	No	Código de operación acordado comercio–Tesabiz.
cuentaAbono	string(20)	Sí	Código de mapeo asociado al número de cuenta de abono.
pos	string(50)	Sí	Código del punto o terminal donde se genera el QR.
cajero	string(50)	Sí	Usuario conectado al POS.
canal	string(50)	Sí	Canal de generación: WEB / Móvil.
tiempoDuracion	integer(3)	No	Duración del QR en minutos.
codProducto	string(50)	No	Código de producto definido por el comercio.
catProducto	string(50)	No	Código de categoría de producto.
sucursal	string(50)	No	Sucursal asociada (puede ser requerida dependiendo del proyecto).
nombreComercio	string(20)	No	Texto adicional al titular destino en el QR.
info	string(5000)	No	Información adicional para integraciones específicas.

Response

{
  "header": {
    "codReturn": "0",
    "txtReturn": "SUCCESS"
  },
  "hash": "data:image/png;base64,....",
  "idQr": "20030903001000004769",
  "idQrInterno": "4714",
  "cciVirtual": "84907600000010015356"
}

Campos de respuesta

header

Campo	Tipo	Descripción
codReturn	string	"0" indica éxito. Otro valor indica error o rechazo.
txtReturn	string	Descripción del resultado.

Otros campos

Campo	Tipo	Descripción
hash	string	Imagen QR generada en formato Base64 (data URL).
idQr	string	ID único del QR en la EIF, usado para conciliaciones.
idQrInterno	integer	ID interno del QR en el sistema QR-Comercio.
cciVirtual	string	Número CCI virtual cuando el QR se genera bajo esa modalidad.