Cobrar con la Tarjeta FINORA

Beta

Requiere FINORA Pago 0.16.0 y el SDK 1.0.0-beta.3. La lectura del pase por el NFC del teléfono está probada con pruebas automáticas y un emulador; la prueba con el teléfono del cliente está en curso. La Tarjeta FINORA física sin contacto por el lector Bluetooth todavía no está disponible.

La Tarjeta FINORA es el medio prepago del comercio: el cliente la lleva como un pase en su teléfono (la app FINORA o la billetera de Google) o como un código QR, y paga con su saldo tecleando su PIN de miembro. Para tu app es un medio más: misma solicitud, mismo resultado, misma idempotencia.

Requisitos

• FINORA Pago 0.16.0 o superior en el mismo equipo, enrolado.
• El comercio tiene encendido el cobro con Tarjeta FINORA para ese terminal (lo hace el comercio en su consola). Compruébalo con FinoraPago.estado(context).medios, que incluye TARJETA_FINORA.
• Un teléfono con NFC para leer el pase. Sin NFC, el cliente muestra su QR y FINORA Pago lo lee con la cámara del equipo.

No hace falta el lector de tarjetas bancarias: con el lector apagado o sin vincular, FINORA Pago cobra igual con la Tarjeta FINORA.

Pedir la Tarjeta FINORA

cobrar.launch(
    SolicitudCobro.Builder()
        .montoCentavos(12_500).moneda("VES")
        .referenciaExterna("PED-1001")
        .sucursalCodigo("0001")
        .medio(Contrato.Medio.TARJETA_FINORA)
        .build()
)

FINORA Pago abre su pantalla, el cliente acerca su teléfono (desbloqueado) a la espalda del equipo o muestra su QR, teclea su PIN de miembro y recibes el resultado.

Si el terminal no cobra con la Tarjeta FINORA, recibes NO_LISTO con el código MEDIO_NO_DISPONIBLE sin que se cree nada en el servidor.

Dejar que el cliente elija

Si no indicas medio y el comercio tiene la Tarjeta FINORA encendida, FINORA Pago pregunta al cliente cómo quiere pagar:

Opción	Disponible cuando
Tarjeta de débito o crédito	El lector está listo (si no, aparece deshabilitada con el motivo)
Tarjeta FINORA	Siempre que el comercio la tenga encendida

Nada se crea en el servidor hasta que el cliente elige. Si cancela, o pasan 120 segundos sin elegir, recibes CANCELADA reintentable con el código SIN_ELECCION_DE_MEDIO: no hubo dinero ni orden, reintenta con la misma referencia.

Con la Tarjeta FINORA apagada no se pregunta nada: el cobro sigue como siempre.

El resultado

Es el de cualquier cobro (Cobrar), con estos valores propios:

Campo	Valor
medio	TARJETA_FINORA
marca	FINORA
ultimos4	Los últimos 4 dígitos del número de la tarjeta prepago
autorizacion, rrn, stan	Los de la autorización
sucursalCodigo, referenciaFinora, referenciaExterna	Como en cualquier cobro

Tu app nunca recibe la credencial del pase ni el PIN. La anulación es la de siempre: Anular un cobro.

Si repites la referencia de una venta aprobada con la Tarjeta FINORA sin indicar medio, FINORA Pago consulta esa venta con el medio con que se pagó, igual que con la tarjeta bancaria.

Qué hace el cliente

1. Abre su pase de la Tarjeta FINORA (en la app FINORA o en su billetera) o muestra su QR.
2. Acerca el teléfono desbloqueado a la espalda del equipo del comercio.
3. Teclea su PIN de miembro en FINORA Pago.

Qué todavía no está

Pieza	Estado
Pase en el teléfono del cliente por NFC (app FINORA)	Beta, FINORA Pago 0.16.0
Pase en la billetera de Google por NFC	Beta; depende de que el comercio tenga configurada la lectura de pases
QR del pase	Disponible
Tarjeta FINORA física sin contacto por el lector Bluetooth	Próximamente