Código QR PIX: un BR Code estático para cobrar en Brasil
PIX es el sistema de pagos instantáneos de Brasil, y sus códigos QR siguen la especificación EMV QR Code Payment: la misma gramática de campo y longitud que usan los códigos de pago en otros países. Un código PIX estático lleva la clave del beneficiario dentro, así que una app bancaria puede construir la transferencia sin llamar antes a un servidor. Eso lo abarata de imprimir y lo hace utilizable sin conexión, pero también significa que el código es una instantánea fija.
Cómo se estructura un código PIX estático
Cada campo se escribe con un identificador de dos dígitos, una longitud de dos dígitos y el valor. La carga empieza por 00 y termina con el CRC en el campo 63. El campo 26 es el bloque de la cuenta del comercio, donde el subcampo 00 identifica el esquema PIX y el 01 contiene la clave.
| Campo | Valor en el ejemplo | Función |
|---|---|---|
| 00 | 01 | Indicador de formato de la carga. |
| 26 | br.gov.bcb.pix + clave | Información de la cuenta: GUI de PIX y la clave CPF, CNPJ, correo, teléfono o aleatoria. |
| 52 | 0000 | Código de categoría del comercio; 0000 se acepta cuando se desconoce. |
| 53 | 986 | Moneda: 986 es el real brasileño. |
| 58 | BR | Código de país. |
| 59 | QrDeco Example | Nombre del comercio, hasta 25 caracteres. |
| 60 | Sao Paulo | Ciudad del comercio, hasta 15 caracteres. |
| 62 | 05 + txid | Datos adicionales: el identificador de transacción, o *** si no hay. |
| 63 | 3C63 | CRC16-CCITT sobre todo lo anterior a este campo. |
Genera un código PIX con tu propia clave
- Elige el tipo de clave que la cuenta tenga registrada: CPF o CNPJ en dígitos, correo tal como se escribió, teléfono con +55 delante o la clave aleatoria EVP en formato UUID.
- Fija los campos 52, 53 y 58 en 0000, 986 y BR.
- Rellena 59 y 60 con el nombre y la ciudad que mostrará el banco; ambos tienen límite y ninguno admite etiquetas.
- Calcula el CRC y exporta SVG para imprenta o PNG para una página de pago.
Dejar el importe abierto
Si omites el campo 54, el pagador escribe el importe. Si incluyes 54 con separador decimal de punto —10.50, nunca 10,50— la app lo rellena sola. Los importes abiertos encajan con propinas, donaciones y un mostrador donde primero se acuerda el total; los importes fijos encajan con una página de producto o un servicio de precio único.
El txid y la conciliación
El subcampo 62-05 identifica la transacción. El valor *** significa «sin identificador», aceptable para una hucha anónima pero inútil para cuadrar las ventas diarias de una tienda. Usa un número de factura corto, de hasta 25 caracteres alfanuméricos, y anota qué código se imprimió y cuándo.
Preguntas frecuentes
¿Un código PIX estático es lo mismo que uno dinámico?
No. El estático contiene la clave y los datos fijos; el dinámico contiene una URL que un servicio de pagos resuelve en un cobro, y así funcionan los importes por factura y los vencimientos.
¿Por qué la app del banco rechaza mi código?
Casi siempre por el CRC. Recalcula el campo 63 después de cualquier cambio —nombre, ciudad o txid— y comprueba que cada longitud siga coincidiendo con su valor.
¿Puedo reutilizar un código PIX para todas las ventas?
Sí en un código estático con importe abierto, pero el txid será idéntico en todos los pagos salvo que generes uno nuevo por venta. Reutilizar es cómodo; no es una estrategia de conciliación.