FINORA Pago SDK para Android
El SDK (versión 1.0.0-beta.3), FINORA Pago 0.16.0 y la parte del servidor del Merchant FINORA están desplegados. El cobro, la idempotencia, la sucursal, la firma del integrador y la anulación se probaron de punta a punta, con el lector simulado y con un lector físico por Bluetooth (chip y sin contacto) en un teléfono real. El SDK se descarga del repositorio Maven de FINORA. Versión mínima de FINORA Pago: 0.16.0 para preparar el lector y cobrar con la Tarjeta FINORA; con la 0.15.3 el SDK 1.0.0-beta.3 sigue cobrando y anulando, sin esas dos funciones. Sigue en Beta: falta la certificación. No lo uses con dinero real hasta que esta página diga «Disponible».
El FINORA Pago SDK para Android permite que tu app (de reparto, un ERP móvil, un kiosco) cobre con tarjeta app a app: tu app le pide el cobro a FINORA Pago, instalado en el mismo equipo; FINORA Pago abre su pantalla encima, cobra con su flujo de siempre (lector de tarjetas, clave, firma, recibo) y te devuelve el resultado.
Tu app nunca recibe datos de tarjeta: solo últimos 4 dígitos y marca.
Cómo funciona
FINORA Pago responde una sola vez y solo cuando el cobro terminó del todo (veredicto, firma si aplica y recibo).
El Merchant FINORA hace sus propios pasos para el SDK: vuelve a verificar al integrador, valida y atribuye la sucursal declarada, devuelve el total de la orden y controla al integrador en la anulación. Si FINORA Pago habla con un servidor que no los tiene, responde NO_LISTO con el código MERCHANT_SIN_SOPORTE y no lee ninguna tarjeta.
Cuándo usarlo
| Tu situación | Integración |
|---|---|
| Tu app corre en el mismo equipo Android que cobra | Este SDK |
| Tu caja está en otro equipo de la misma red local | API ECR del terminal |
| Tu sistema está en un servidor y el terminal en la calle | Cobro en la nube |
| Tu caja es un PC con Windows | FINORA Pago para Windows |
Guías
- Inicio rápido: la dependencia y un cobro en diez líneas.
- Tutorial: de cero a tu primer cobro: la app de ejemplo, la huella, la lista de integradores y tu primer cobro aprobado y anulado, paso a paso.
- Cobrar: la solicitud, el resultado y la idempotencia.
- Tarjeta FINORA: cobrar con el pase del cliente en su teléfono o su QR, o dejar que elija.
- Anular: deshacer un cobro aprobado desde tu app.
- Seguridad y alta del integrador: huella del certificado, lista de integradores y qué hace el comercio.
- Estados y errores: qué hacer con cada estado, en especial
EN_DUDA. - Sucursal y conciliación: a qué tienda se atribuye la venta y cómo cuadrarla.
- Rendimiento: preparar el lector antes del cobro y medir cada tramo.
- App de ejemplo: una app de reparto completa que cobra y anula.
Qué está disponible hoy
| Pieza | Estado |
|---|---|
SDK com.dcgeeks.finora:pago-sdk:1.0.0-beta.3 (contrato v1) | Beta, en el repositorio Maven https://developers.finoracore.com/maven/ (la 1.0.0-beta.2 y la 1.0.0-beta.1 siguen publicadas) |
| FINORA Pago 0.16.0 con el SDK (versión mínima) | Beta, en el canal beta del marketplace y entregado bajo acuerdo |
Lector preparado antes del cobro (prepararLector) y medición por tramo | Beta, FINORA Pago 0.16.0; medición en el equipo en curso |
| Tarjeta FINORA por el NFC del teléfono o QR, y elección del medio | Beta, FINORA Pago 0.16.0 |
| Tarjeta FINORA física por el lector Bluetooth | Próximamente |
| Verificación del integrador en el servidor (cobro y anulación) | Beta, desplegada |
| Sucursal declarada, medio y total de la orden en el servidor | Beta, desplegada y probada |
| Lista de integradores entregada por el servidor y editable en la consola | Beta, desplegada y probada |
| Cobro con lector físico por Bluetooth: chip y sin contacto, firma y anulación | Probado en un teléfono real con lector (2026-10-21) |
| Banda magnética y débito con PIN aprobado de punta a punta | Pendiente de prueba |
| Certificación | Pendiente |
Enlace al comprobante digital (comprobanteUrl) | Próximamente (interruptor aún no activo; primer cobro por el webhook intencion.resultado, en la app solo al consultar o repetir) |