API QR PIX

API REST JSON para operaciones de cobro con PIX. Permite generar una transacción QR PIX, verificar su estado y cancelar la operación antes del cierre de lote.

REST JSON x-api-key Generación PIX Verificación Cancelación

Probar generar PIX Probar verificación Probar cancelación Descargar PDF

Endpoints disponibles

Servicios principales del producto QR PIX.

POST Generar transacción QR PIX

/v1/qr/px/generar

Genera una transacción PIX con datos del comprador, monto, canal, glosa y datos de conversión.

GET Verificar estado QR PIX

/v1/qr/px/verifica/{numeroReferencia}

Consulta el estado de una transacción usando el número de referencia generado por ATC.

GET Cancelar transacción QR PIX

/v1/qr/px/cancela/{numeroReferencia}

Cancela una transacción aprobada antes del cierre del lote diario.

Autenticación y callback

Requisitos básicos para integración.

Header requerido

Header	Valor	Uso
x-api-key	Token provisto por Red Enlace	Autenticación obligatoria en todos los servicios

Callback requerido

La empresa aceptante debe exponer un servicio de confirmación de pago. Por seguridad se acepta token basic, x-api-key y token opcional.

https://dominio.com/qrpix/confirmed
o
https://ip/qrpix/confirmed

Ejemplo de request

Generación de transacción QR PIX.

{
  "numeroReferencia": 203414,
  "glosa": "298414|JHIRAFAS CHICKENS|MISCELANEAS|TRANSACCION QR CON Comercio x",
  "monto": 696.00,
  "moneda": "BOB",
  "canal": "WEB",
  "tiempoQr": "23:59:59",
  "CPF": "78798754911",
  "telefono": "+55777797246",
  "correoElectronico": "",
  "campoExtra": ""
}

Ejemplo de response

Respuesta al generar QR PIX.

{
  "moneda": "BOB",
  "monto": 696.0,
  "origenNumeroReferencia": "203414",
  "numeroReferencia": "6780",
  "codigoRespuesta": "PENDING",
  "detalleRespuesta": "Estado en espera de la confirmación pago QR",
  "imagen": "{cadenaQR} en base64",
  "montoConversion": 592.52,
  "monedaConversion": "BRL",
  "tipoCambio": "0.8513",
  "qrExpiracion": "2025-04-21T21:00:49.219+00:00"
}

Campos clave de entrada

Parámetros más importantes para generar QR PIX.

Campo	Tipo	Descripción	Requerido
numeroReferencia	Long	Código único transaccional del comercio	Sí
glosa	String	Cadena separada por PIPE con sucursal, rubro y glosa	Sí
monto	BigDecimal	Monto de la transacción	Sí
moneda	String	BOB o USD	Sí
canal	String	WEB, MOVIL o DESKTOP	Sí
tiempoQr	String	Tiempo de vida del QR	Opcional
CPF	String	Número de identificación del comprador	Sí
telefono	String	Teléfono del comprador	Sí
correoElectronico	String	Correo del comprador	Opcional
campoExtra	String	Campo reservado	Opcional

Estados

Estados documentados para el servicio.

Código	Descripción
PENDING	Transacción dada de alta pero aún no fue cobrada
NOTFOUND	Servicio QR inactivo
ERROR	Error de servicio
SUCCESS	Transacción completada satisfactoriamente
CANCELLED	Transacción cancelada
CLOSED	Transacción cerrada por ciclo completo
EXPIRED	Código QR expirado

Ejemplo de verificación

Respuesta del servicio de verificación de estado.

{
  "codigoRespuesta": "CANCELLED",
  "detalleRespuesta": "Transacción cancelada",
  "data": {
    "numeroReferencia": "6780",
    "monto": 696.0,
    "moneda": "BOB",
    "montoConversion": 592.52,
    "monedaConversion": "BRL",
    "tipoCambio": 0.8513,
    "reversa": null
  }
}

Ambientes

URLs documentadas por entorno.

Operación	Sandbox	Producción
Generar QR PIX	`https://pixqa.redenlace.com.bo/v1/qr/px/generar`	`https://atcpixcert.redenlace.com.bo/v1/qr/px/generar`
Verificar estado QR PIX	`https://pixqa.redenlace.com.bo/v1/qr/px/verifica/{numeroReferencia}`	`https://atcpixcert.redenlace.com.bo/v1/qr/px/verifica/{numeroReferencia}`
Cancelar QR PIX	`https://pixqa.redenlace.com.bo/v1/qr/px/cancela/{numeroReferencia}`	`https://atcpixcert.redenlace.com.bo/v1/qr/px/cancela/{numeroReferencia}`