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:

Se ofrece

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.

No se ofrece

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áginaQué establece
p. 18Cada integrador debe exponer un servicio para que el Gateway QR (Decidir) le reenvíe los BINs que mandó la billetera.
pp. 19-21Ese 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. 22Respondemos 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-25La 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. 24Siempre hay que incluir el medio 112 (transferencia), porque aunque haya BINs, el cliente puede elegir pagar con transferencia al final.
pp. 26-27Cada medio debe traer sus esquemas de cuotas, y siempre el esquema de 1 cuota.
pp. 36, 59La notificación del pago trae card_data.bin (6 u 8 dígitos), el medio y las cuotas que se cobraron.
Lo que el PDF NO dice

2. El flujo completo, paso a paso

Caja (POS) Gateway Prisma Billetera 1. trxpago (importe) 2. crear intención (solo 112) 3. escanea el QR 4. tarjetas del cliente (BINs) 5. PUT con los BINs (p. 19) 6. 204 en menos de 200 ms 7. arma la oferta(árbol de la sección 3) 8. intención completa (≤ 27 s) 9. muestra medios y cuotas 10. elige y paga 11. aviso de pago (medio, BIN, cuotas) 12. ¿coincide conlo ofrecido? 13. aprobado o denegado

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

Tarjeta recibida (medio, banco, BIN) ¿El comercio acepta ese medio de pago? No No se ofrecela billetera no la puede usar Sí ¿Hay establecimientopara ese medio? No Sin oferta (NO_OFFER)error de configuración, no hay venta Sí Se ofrece. Planes, del más específico: 1. plan por rango de BINej. 450799: 6 cuotas 2. plan por bancosi no hay de BIN 3. plan por mediosi no hay de banco

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ónQué hace el gatewayLa caja recibe
AVisa 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).
BVisa 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.
CTarjeta 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.
DLlega 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.
ELlega un pago con un plan ofrecido pero por otro total.AMOUNT_MISMATCH: compensación.Denegado.
FLa billetera nunca manda los BINs.No hay intención completa. Cuando vence la espera de la caja, compensa.Denegado.
GLos BINs llegan, pero no se puede mandar la intención completa dentro de los 27 s.No la manda (PAST_DEADLINE) y compensa.Denegado.
HMedio 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.
IEl 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".

Hoy: se acepta por medio de pago

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.

Alternativa: lista blanca de BIN

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.