Bridge - Integración VTOL con billeteras virtuales adquirientes
© 2024 Napse. Todos los derechos reservados.
Introducción
Bridge cuenta con la integración de billeteras virtuales, para región Argentina, de varios proveedores. Existen integraciones de billeteras donde los planes de financiación y accesos a descuentos por membresías son directamente aplicados por las mismas billeteras. En otros casos, adquirientes, tanto los planes de pago como los descuentos o promociones por membresías son detalladas por Bridge en cada transacción de pago
En este ultimo caso, las billeteras que son integradas a través de Prisma, intentaremos detallar y recomendar la personalización, configuraciones, promociones y funcionamiento desde Bridge y como interactuamos con los productos Promo y VTOL.
Particularidades de billeteras integradas a través de Prisma (adquiriente)
En este tipo de billeteras, tal como mencionamos anteriormente, es Bridge quien le indica al Prisma el tipo de billetera, planes de financiamiento por cada variedad de tarjeta de crédito / débito, y promociones para membresías (con sus respectivos porcentajes y límites de descuento)
Para esto, es necesario entender como Bridge le indica a Prisma cada uno de estos datos, las relaciones de planes entre Promo y VTOL, planes exclusivos para billeteras, y procesamiento de beneficios que otorga Bridge (a través de Prisma) para reflejarse en una transacción de venta.
Promociones
Planes de pago
En Promo existen diversos beneficios no monetarios, pero particularmente en este caso nos vamos a referir a los planes de pago.
Un plan de pagos no es ni mas ni menos que un beneficio al cual se accede por diversas condiciones y que el mismo se encuentra disponible para ser utilizado por el cliente. A diferencia de otros beneficios, es importante entender que el sólo acceso al beneficio no implica que se vaya a utilizar; todo depende de la elección del cliente a la hora de realizar sus pagos, los tipos de pago que utilice, la variedad de pago que elija, etc.
Para poder entender el alcance de los planes de pago vamos a brindar dos ejemplos concretos:
- Dada una promoción con condición X (ejemplo, la compra de un determinado artículo, sobre pasar el monto de compra de artículos de una determinada categoría o marca, etc.), Promo otorga un beneficio para poder acceder a un plan de pagos con tarjeta Visa en 6 pagos sin interés. Este beneficio fue otorgado por Promo, pero el cliente decide cancelar su compra en efectivo, o bien utilizar un plan de pagos para AMEX en 12 cuotas.
- Dada una promoción con X condición (de igual forma que el ejemplo anterior), Promo otorga un beneficio de plan de pagos para tarjeta AMEX en 12 cuotas sin interés, pero utilizada a través de la billetera BIMO. De igual forma, Promo ya otorgó el beneficio, pero el cliente decide cancelar su compra con la billetera de Mercado Pago
En ambos casos la promoción se cumplió, Promo otorgo el beneficio, pero el cliente decidió no utilizarlo
Ahora bien, en estos ejemplos los planes de pagos eran bien diferenciados, y solo tenían en común un determinado plan de pagos; pero el primero era para uso exclusivo de una tarjeta Visa presencial mientras que el segundo era asignado a una tarjeta de crédito, pero siendo utilizada desde una billetera electrónica.
Definición de Promociones de Planes de Pago para Billeteras Electrónicas Adquirientes
Como podemos ver, las condiciones en este caso están basadas en artículos (pudiéramos agregar cualquier otra condición tales como eventos, cupones, clientes, etc. pero NUNCA debe formar parte de la condición el medio de pago involucrado. Esto es porque el plan de pago debe estar siempre disponible, y solo se utilizará cuando se procese el tipo y medio de pago indicado por el mismo plan de pagos. En este caso solo se utilizará cuando el cliente decida pagar con su tarjeta VISA a través de una billetera electrónica (en el siguiente punto explicaremos los datos más relevantes)
En este punto solo vamos a detallar un solo plan de cuotas, destacando lo importante para cada punto
Otorgar plan de pagos y Plan de Pago VTOL: es importante tener en cuenta que este tipo de plan, cuotas y recargo debe existir previamente en VTOL (no olvidar que al crearlo en VTOL se debe indicar que es "Promocional", para evitar que Bridge lo ofrezca sin condición alguna)
"Cuotas" y "Cuotas a mostrar en el POS": cantidad de cuotas del plan de pagos. Generalmente tienen el mismo valor, pero en algunos planes (tales como Ahora 12 / Ahora 18) la cantidad de cuotas en la mensajería de VTOL es diferente a las cuotas reales que el cliente visualizará en su liquidación.
Tipo de Pago: 4 – Tarjeta de Crédito / Débito (integrada por catálogos Bridge / Promo)
Medio de pago: VI (Medio de pago Bridge, integrada por catálogos Bridge / Promo)
OperationType VTOL: uno de los atributos más importantes.
0 - Uso en tarjetas de crédito/débito presenciales físicamente
1 - Indica que es para utilizarse a través de billeteras electrónica adquirientes
Promociones sobre Tarjetas no bancarias que pueden registrarse en una billetera electrónica
Existen programas de membresía / fidelidad de empresas que luego ofrecen descuentos en determinados comercios al realizar una compra determinada. El cliente puede tener registradas sus N tarjetas de crédito / débito en su billetera junto a estas tarjetas de programas de membresía.
De esta forma, Bridge informa junto a los planes de pago (de Promo o configurados como permanentes) cualquier tipo de beneficio aplicado sobre un pago con billetera. Estos beneficios especiales se trasladan al adquiriente.
En el momento escanear el QR y seleccionar la tarjeta para realizar el pago, el cliente puede obtener el beneficio de la tarjeta de membresía si es que posee alguna que respete el identificador enviado por Bridge.
Estos identificadores ya se encuentran configurados en VTOL como tarjetas de Beneficios, e integradas por Promo justamente para permitir configurar los beneficios basados en billeteras.
A continuación, se muestra un ejemplo de definición de promoción y beneficio de este tipo.
Como beneficio, definimos las X posibles variantes de los tipos de tarjetas de membresías.
Al pagar con el medio de pago BIMO, Bridge envia la intención de pago a Promo y solicita su evaluación.
Promo, en caso de cumplirse las N condiciones, retorna estos beneficios.
Bridge los interpreta y los agrega al mensaje a enviar al adquiriente.
Al procesar la respuesta del adquiriente, nos indica tanto el plan de pagos utilizado como si aplico un beneficio. Este beneficio que pudo haber aplicado no es otro que alguno de los definidos en el ejemplo anterior.
En este punto es importante recordar los pasos que hemos realizado hasta aquí:
- El cliente desea pagar con una billetera adquiriente
- Bridge informa la intención del pago a Promo
- Promo retorna los posibles beneficios aplicados en la transacción, junto a los planes de pago exclusivos de billeteras y los posibles beneficios de tarjetas de membresías
- Bridge envía el mensaje a la billetera adquiriente con todos los planes de pago disponibles en la mensajería "Online" (VTOL) para billeteras + los planes de pago que pudieran ser otorgados por Promo + beneficios de tarjetas de membresías.
- Al procesar la respuesta, Bridge debe identificar si el plan de pagos utilizado genera algún tipo de recargo y procesarlo
- Si también se detecta que la billetera aplico una promoción para membresías, entonces debe informarle a Promo el monto y tipo de beneficio. Esto se hace para que Promo aplique el descuento y lo distribuya entre los artículos alcanzados (artículos alcanzados en la definición de la promoción anterior)
Se informa a Promo un "Beneficio Externo, por lo tanto, debemos definir una promoción e incluirla en el mapa para que Promo reconozca este beneficio y aplique el descuento
Promociones para aplicar un descuento realizado por una billetera
Como mencionamos anteriormente, cuando una billetera otorga un beneficio determinado, tenemos que lograr que Promo integre este beneficio con el resto de los medios de pago.
Es importante entender que este beneficio ya fue aplicado efectivamente por la billetera, por lo tanto, debemos pensar que su convivencia con el resto de las promociones no lo haga colisionar de tal forma que se vea restringida su aplicación.
Para lograr que Promo lo integre como una promoción y aplique exactamente el mismo importe otorgado por la billetera debemos definir una promoción basada en Beneficio Externo. Este tipo de promociones básicamente tienen al Beneficio Externo como condición y como beneficio. Los elementos alcanzados por el beneficio también son informados por el punto de venta (recodemos que este beneficio se origina en las promociones para billeteras, con tarjetas de membresía, por lo tanto, utilizamos las secuencias de artículos alcanzadas en esa promoción y se las informamos en este Beneficio Externo)
A continuación, un ejemplo de una promoción como Beneficio Externo
Como puede verse, el Tipo de Beneficio Externo de la condición es igual al Tipo de Beneficio Externo del beneficio. Si esto no se cumple, el benefcio no es otorgado.
Se define en este ejemplo igual a CP porque fue uno de los beneficios de membresias definidos en la promocion correspondiente.
RELACION ENTRE LAS 3 PROMOCIONES: PLANES DE PAGO, BENEFICIO PARA TARJETA DE MEMBRESIA Y BENEFICIO EXTERNO.
- De las promociones de planes de pago Bridge se queda solo con aquellos planes de pago exclusivos para billeteras (OperationType VTOL = 1)
- Al informarle a Promo la intención de un pago con billetera BIMO, Bridge se queda con los beneficios del tipo wallet (Clase de beneficio Monedero)
- Al recibir la respuesta de la billetera, y solo en caso de que la misma haya aplicado un beneficio, informamos a Promo el Beneficio Externo con el mismo tipo del recibido en el beneficio Monedero. Al procesarse la respuesta, este beneficio monetario es aplicado en las secuencias de artículos informadas por la promoción.
EMV Kit
Mencionamos que la validación del pago con billeteras es realizada por VTOL, siendo EMV Kit quien hace de nexo entre Bridge POS y VTOL.
Este componente realiza diversas transacciones, entre las cuales se encuentran pagos con tarjeta de crédito / débito, billeteras, transferencias bancarias, recarga de celulares, etc.
En este punto vamos a mencionar como en un pago con billeteras del tipo adquiriente Bridge le informa a EMV Kit el tipo de billetera, los planes de pago y los beneficios que podrían ser utilizados por el cliente.
Los campos más relevantes en este caso, además de los utilizados por el resto de los módulos, son:
Campo 401 – Opciones de Pago
Por cada variedad de Tarjeta de Crédito / Débito que se valida a través de VTOL, se informan los pales de pago y sus datos correspondientes. Algunas restricciones: no se puede informar por validad de tarjeta diferentes planes con la misma cantidad de cuotas (restricción Prisma)
[
{
"providerPosCode":"VI",
"installments":[
{
"paymentOptionId":"VI_1",
"quantity":1,
"amountPerInstallment":10890,
"totalAmount":10890,
"surcharge":0,
"nominalAnnualRate":0
},
{
"paymentOptionId":"VI_3",
"quantity":3,
"amountPerInstallment":4066,
"totalAmount":12196,
"surcharge":1200,
"nominalAnnualRate":0
},
{
"paymentOptionId":"VI_6",
"quantity":6,
"amountPerInstallment":2087,
"totalAmount":12523,
"surcharge":1500,
"nominalAnnualRate":0
},
{
"paymentOptionId":"VI_9",
"quantity":9,
"amountPerInstallment":1452,
"totalAmount":13068,
"surcharge":2000,
"nominalAnnualRate":0
},
{
"paymentOptionId":"VI_12",
"quantity":12,
"amountPerInstallment":1180,
"totalAmount":14157,
"surcharge":3000,
"nominalAnnualRate":0
}
]
},
{
"providerPosCode":"MA",
"installments":[
{
"paymentOptionId":"MA_1",
"quantity":1,
"amountPerInstallment":10890,
"totalAmount":10890,
"surcharge":0,
"nominalAnnualRate":0
}
]
},………
{
"providerPosCode":"MC",
---------------------------------
}
]
Campo 402 – Opciones de Beneficios
[
{
"benefitCardId":"CC_1",
"providerPosCode":"CC",
"discountPercentage":500,
"maximumDiscountAmount":545
},
{
"benefitCardId":"CP_2",
"providerPosCode":"CP",
"discountPercentage":1500,
"maximumDiscountAmount":1634
}
]Beneficios del tipo Monedero obtenido desde Promo
Ejemplo de un mapa con las promociones conviviendo
Ejemplo de visualización en Bridge
En este ejemplo de compra estamos utilizando un mapa similar al del ejemplo. Al vender un articulo se aplica una promoción genérica, y nos sugiere el uso de BIMO para acceder a un beneficio del diario Clarín (en caso que el cliente tenga registrada la tarjeta en la app de su celular)
Si decidimos pagar con una tarjeta "presencial" se nos despliegan las opciones de pago definidas en VTOL para este tipo de tarjetas
En cambio, si decidimos pagar con BIMO, nos solicita escanear el QR con con la app de BIMO
Ejemplo de visualización en la APP (celular)
Aquí vamos a mostrar el ejemplo desde el punto de vista de la app del celular
- Ingresamos a la app y escaneamos el QR
- - La app detecta el beneficio y aplica el descuento
- Elegimos la tarjeta y el plan de pagos, observemos que en 12 cuotas el interés es diferente al de una tarjeta tradicional (en este caso es de Promo el plan)
- - Confirmación del pago
- En este tipo de billeteras, Prisma no responde cuando el pago es autorizado, por lo cual el operador debe siempre forzar la consulta al cumplirse el timeout.
- - Finalmente en Bridge se recupera el pago
- Impresión del comprobante
Detalle del ejemplo anterior Vamos a detallar la venta del ejemplo anterior
- La compra del articulo IVA21 cuyo precio de venta es 121,00
- Promo otorga un beneficio del 10%, por lo cual la transacción es de 108,90
- También nos brinda los planes de pago a aplicar en caso de utilizar BIMO
- Al seleccionar el medio de pago BIMO enviamos a Promo la intención de este pago y nos adjudica la promoción BIMO – CLARÍN, con los beneficios para monedero CC y CP
- Esto lo podemos ver en el requerimiento a EMV KIT
- Campo 401 con los planes de pago (nos centramos en los de VISA – VI). En este punto si recordamos los planes de pago para VISA presencial, observamos que el interés es del %12,12. Sin embargo lo que hicimos (solo en esta prueba) fue reemplazarlo por el de Promo %30,00. Recordemos que Prisma solo admite planes para una misma tarjeta sin repetir la cantidad de cuotas.
- Bridge tomo todos los planes de pago configurados para Visa (wallet) y luego los de Promo. Solo se agregan aquellos planes cuyas cuotas no han sido previamente procesadas
- También se agregan las tarjetas de beneficio en el campo 402
- El cliente visualiza los beneficios y selecciona el plan de pagos
- En la respuesta, EMV nos dice que plan de cuotas eligió el cliente, el monto original del pago, el importe final del pago y el descuento aplicado (en caso de haber aplicado el descuento) junto con el ID de beneficio
- En este caso, el detalle de la respuesta:
- Campo 12: Importe total del pago 118,69
- Campo 404: Plan de pagos seleccionado VI_12
- Campo 405: ID del beneficio utilizado CP_2
- Campo 406: Importe del pago original 108,90
- Campo 407: Descuento realizado 22,87
- Es importante tener en cuenta que para que Bridge pueda procesar correctamente lo realizado en la billetera virtual, debe realizar algunos cálculos
- Importe real del pago 118,69
- Importe del recargo: 118,69 – (118,69 / 1.30) = 27,39
- Importe del descuento obtenido: 22,87
- El descuento contiene el hipotético recargo que hubiera recibido, por lo tanto debemos quitarle el 30% del plan seleccionado 22,87/1.3 = 17,60
- Informamos a Promo el beneficio externo por 17,60, Promo lo aplica, quedando el ticket de la siguiente forma
Algunas restricciones
- La condición para beneficio externo debe coincidir en el Tipo del beneficio externo a otorgar (Restricción Promo)
- Todas las opciones de planes de pago que se informan deben existir en VTOL, tanto las promocionales como las básicas (todas exclusivas de billeteras)
- Prisma no admite planes diferentes para una misma tarjeta cuya cantidad de cuotas coincida (restricción Prisma)
- Para poder informar tanto las opciones de pago como los beneficios deben estar habilitados en la configuración de medios de pago de Bridge
- Las billeteras de este tipo no responden a VTOL cuando se realiza el pago, por lo tanto, siempre el requerimiento se ir por timeout, debiendo el operador forzar la para obtener el estado del pago.
- Estas billeteras NO poseen reverso de devoluciones, por lo tanto, se inhibe desde Bridge anulaciones parciales de pago y pagos en transacciones de devolución hasta tanto esto no esté soportado por Prisma.