FINORA Merchant · Guía

Cobrar con la Tarjeta FINORA por NFC

PilotoImplementadoBásico10 min

Objetivo

Cobrar con la Tarjeta FINORA, el medio prepago del comercio, sin el lector de tarjetas bancarias: el cliente acerca su teléfono con el pase (o muestra su QR) y teclea su PIN de miembro.

Qué necesitas

FINORA Pago 0.16.0 o superior en el teléfono del motorizado, con NFC. Sin NFC, el cliente muestra su QR y FINORA Pago lo lee con la cámara.
El cobro con Tarjeta FINORA encendido por el comercio para ese terminal. Compruébalo: FinoraPago.estado(context) .medios incluye TARJETA_FINORA.

Pasos

Pide la Tarjeta FINORA en la solicitud:

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

O deja que el cliente elija: sin medio, y con la Tarjeta FINORA encendida, FINORA Pago pregunta «¿Cómo quieres pagar?» entre tarjeta bancaria (si el lector está listo) y Tarjeta FINORA. No se crea nada hasta que elige.
El cliente paga: abre su pase (en la app FINORA o en su billetera) o su QR, acerca el teléfono desbloqueado a la espalda del equipo del motorizado y teclea su PIN de miembro en FINORA Pago.
Tu app recibe el resultado como en cualquier cobro, con medio = TARJETA_FINORA y marca = FINORA.

Ejemplo de resultado

Campo	Valor
`estado`	`APROBADA`
`medio`	`TARJETA_FINORA`
`marca`	`FINORA`
`ultimos4`	Los últimos 4 dígitos de la tarjeta prepago
`autorizacion`, `rrn`, `referenciaFinora`, `sucursalCodigo`	Como en cualquier cobro

Tu app nunca recibe la credencial del pase ni el PIN. La anulación es la misma de la lección 6.

Si algo no sale

Ves	Qué significa	Qué haces
`NO_LISTO` · `MEDIO_NO_DISPONIBLE`	El comercio no tiene la Tarjeta FINORA encendida en ese terminal. No se creó nada	Pide al comercio que la encienda, o cobra con tarjeta bancaria
`CANCELADA` · `SIN_ELECCION_DE_MEDIO`	El cliente no eligió (canceló o pasaron 120 s). No hubo orden ni dinero	Reintenta con la misma referencia
El teléfono del cliente no se lee	Pantalla bloqueada o el NFC del motorizado apagado	Desbloquear, encender NFC o usar el QR

Verificación

estado().medios contiene TARJETA_FINORA.
Cobra un pedido con .medio(Contrato.Medio.TARJETA_FINORA) y un pase de prueba: APROBADA con marca = FINORA.
Cobra otro sin medio: aparece la pregunta de medio; cancela y comprueba CANCELADA con SIN_ELECCION_DE_MEDIO.
Con el lector Bluetooth apagado, la Tarjeta FINORA cobra igual.

Qué está y qué no

Pieza	Estado
Pase en el teléfono del cliente por NFC (app FINORA)	Beta
Pase en la billetera del teléfono por NFC	Beta; depende de la configuración de lectura de pases del comercio
QR del pase	Disponible
Tarjeta FINORA física por el lector Bluetooth	Hoja de ruta

Siguiente: Lección 8 · Lector precalentado y medición de tiempos