Flujos de BIN en el QR de Prisma
Qué dice el documento oficial (Integradores Grandes Cuentas QR v0.27) y cómo lo resuelve hoy el gateway.
Respuesta corta: "si no tenemos el BIN, ¿la billetera no debería poder usarlo?"
Depende de qué significa "no lo tenemos". Son dos cosas distintas:
No hay un plan cargado para ese BIN, pero la tarjeta es de una marca que el comercio acepta (por ejemplo, una Visa de un banco sin promoción).
La tarjeta se ofrece igual, como mínimo en 1 cuota del total. Un plan por BIN es una promoción, no una lista de tarjetas permitidas.
La tarjeta es de un medio de pago que el comercio no acepta (no tiene establecimiento para esa marca).
La tarjeta no entra en la intención completa y la billetera no puede pagar con ella. Si igual llegara un pago con ella, el gateway lo rechaza y lo anula.
Tu intuición es correcta para el segundo caso, que es lo que hace hoy el gateway. Para el primero sería un error: bloquear una Visa aceptada solo porque no tiene promoción haría perder ventas, y el PDF no lo pide.
1. Qué dice el documento oficial
| Página | Qué establece |
|---|---|
| p. 18 | Cada integrador debe exponer un servicio para que el Gateway QR (Decidir) le reenvíe los BINs que mandó la billetera. |
| pp. 19-21 | Ese reenvío es un PUT /{integrator_path}/intentions/{intention_id} con payment_methods_data: una lista de payment_method_id, bank_id y bin (6 u 8 dígitos). Banco y BIN no son obligatorios si el comercio opera con Transferencia 3.0. |
| p. 22 | Respondemos 204 No Content. La intención completa debe llegar a Prisma dentro de los 27 segundos de recibidos los BINs (boletín CIMPRA, tiempos del BCRA). |
| pp. 23-25 | La intención completa (PUT /largeaccounts/intentions/complete) lleva payment_methods_data, definido como el array de medios de pago aceptados. Cada entrada lleva BIN, medio, banco, establecimiento, terminal, trace, ticket y los planes de cuotas. |
| p. 24 | Siempre hay que incluir el medio 112 (transferencia), porque aunque haya BINs, el cliente puede elegir pagar con transferencia al final. |
| pp. 26-27 | Cada medio debe traer sus esquemas de cuotas, y siempre el esquema de 1 cuota. |
| pp. 36, 59 | La notificación del pago trae card_data.bin (6 u 8 dígitos), el medio y las cuotas que se cobraron. |
- No dice que la billetera tenga prohibido pagar con algo que no esté en la intención completa. Se deduce, porque la intención completa es "la lista de medios aceptados", pero no está escrito. Por eso el gateway lo verifica al recibir el pago (ver escenario D).
- No dice cuánto espera Prisma nuestro 204 ni si reintenta. Ya está preguntado en el ítem 5 del mail a Prisma.
- No habla de listas blancas de BIN. Aceptar o no es por medio de pago (marca más establecimiento), no por BIN.
2. El flujo completo, paso a paso
El 204 (paso 6) y la intención completa (paso 8) son dos relojes distintos: el primero es nuestra respuesta al callback, el segundo es el plazo de 27 s del PDF.
3. Qué hace el gateway con cada tarjeta que manda la billetera
- Siempre se agrega 1 cuota del total, aunque no haya ningún plan cargado. Un plan de 1 cuota con recargo se rechaza.
- Siempre se agrega el medio 112 (transferencia), una sola vez y al final.
- Si la billetera repite el mismo medio con el mismo BIN, se ofrece una sola vez.
- Si ninguna tarjeta es de un medio aceptado, igual se manda la intención completa, pero solo con transferencia.
Código: CompleteOffer.assemble (filtro por medios aceptados, 1 cuota obligatoria, 112 al final) y BinsWorker (plazo de 27 s, NO_OFFER).
4. Escenarios posibles
| # | Situación | Qué hace el gateway | La caja recibe |
|---|---|---|---|
| A | Visa con BIN 450799 y plan de 6 cuotas cargado para ese BIN. | Ofrece 1, 3 y 6 cuotas. La billetera elige 6. | Aprobado en 6 cuotas (pago 9 de la demo). |
| B | Visa de un BIN sin plan propio (medio aceptado). | Ofrece 1 cuota más los planes de banco o de medio que haya (por ejemplo, las 3 cuotas genéricas de Visa). | Aprobado en lo que elija el cliente. |
| C | Tarjeta de un medio que el comercio no acepta. | No la incluye. Si era la única tarjeta, ofrece solo transferencia. | Aprobado si paga por transferencia. Si no paga, la espera vence y se deniega. |
| D | Llega un pago con un medio, BIN o cantidad de cuotas que no se ofreció. | Lo detecta como UNOFFERED_PLAN: consulta el pago y lo anula (compensación). | Denegado. No se registra una venta que no ofrecimos. |
| E | Llega un pago con un plan ofrecido pero por otro total. | AMOUNT_MISMATCH: compensación. | Denegado. |
| F | La billetera nunca manda los BINs. | No hay intención completa. Cuando vence la espera de la caja, compensa. | Denegado. |
| G | Los BINs llegan, pero no se puede mandar la intención completa dentro de los 27 s. | No la manda (PAST_DEADLINE) y compensa. | Denegado. |
| H | Medio aceptado pero sin establecimiento cargado. | No arma oferta (NO_OFFER): una oferta inválida es peor que ninguna. | Denegado. Hay que corregir la configuración del comercio. |
| I | El BIN del aviso de pago tiene 8 dígitos y el ofrecido tiene 6, o al revés. | Los considera la misma tarjeta si uno es el comienzo del otro (el PDF admite 6 u 8). | Aprobado si el resto coincide. |
5. ¿Y si el negocio quisiera solo ciertos BINs?
Es posible, pero es una decisión de producto, no algo que pida Prisma. Por ejemplo, "en esta caja solo aceptamos tarjetas del banco X".
Cualquier tarjeta de una marca aceptada paga, al menos en 1 cuota. Las promociones por BIN o por banco solo agregan cuotas. Se pierden menos ventas.
Habría que agregar una regla nueva de "no ofrecer". Más control, pero el cliente con otra tarjeta solo podría pagar por transferencia. Y un BIN de 6 dígitos cubre muchas tarjetas distintas.
Fuentes: IntegradoresGrandesCuentasQRv27.pdf (pp. 18-27, 36, 59); gateway CompleteOffer, BinsWorker, OfferCheck, PurchaseResults.