Curso: cobro a domicilio y SDK de FINORA Pago

Audiencia: Tecnología e integración de una empresa de reparto, y su jefe de operaciones para las lecciones 1, 4, 6 y 8.

Estado: Beta (piloto)

El SDK de cobro (1.0.0-beta.3), FINORA Pago para Android 0.16.0 y la parte del servidor están desplegados en el entorno de demostración y se probaron de punta a punta, también con un lector físico por Bluetooth en un teléfono real. El banco adquirente todavía es simulado y falta la certificación: no cobres dinero real con lo que aprendas aquí hasta que la documentación para desarrolladores indique que el cobro con dinero real está disponible.

Quién eres

Trabajas en una empresa de reparto que cobra en la puerta del cliente. Tu app ya sabe qué pedido entrega el motorizado, de qué tienda salió y cuánto cuesta. Quieres que el cliente pague con su tarjeta (bancaria o Tarjeta FINORA) sin que tu app toque nunca un dato de tarjeta, que cada venta quede en la tienda correcta y que nadie pague dos veces.

Lo que vas a lograr

• Explicar el recorrido de un cobro a domicilio, del pedido al veredicto del emisor y de vuelta.
• Cobrar y anular desde tu app Android con el SDK de FINORA Pago, en diez minutos.
• Cobrar sin SDK, desde tu servidor, con el cobro en la nube y recibir el resultado por webhook.
• Declarar la sucursal de origen de cada venta y conciliar el día.
• Dar de alta tu app en la lista de integradores con la huella de su certificado.
• Tratar cada estado del cobro, en especial EN_DUDA, sin cobrar dos veces.
• Cobrar con la Tarjeta FINORA por el NFC del teléfono.
• Precalentar el lector y medir cuánto tarda cada tramo del cobro.

Antes de empezar

• Intención, intento y veredicto: el vocabulario del cobro.
• Un proyecto Android (Kotlin, API 23 o superior) y acceso a un comercio de pruebas de FINORA.
• La referencia técnica completa está en el portal de desarrolladores de FINORA, secciones «SDK de cobro Android» y «Pagos y cobro en la nube». Este curso no la reemplaza: la recorre con práctica.

Las ocho lecciones

En este orden. Cada lección tiene objetivo, pasos, ejemplo y verificación.

1. 1

   1. El cobro a domicilio de punta a punta12 min

   Actores, los dos caminos (app a app y en la nube) y los ocho pasos de un cobro.

2. 2

   2. Integra el SDK en una app Android en 10 minutos15 min

   Dependencia Maven, un cobro, el estado previo y la variante de demostración.

3. 3

   3. Cobro en la nube por API y webhooks20 min

   Crear la venta desde tu servidor, enviarla a un datáfono y recibir el resultado firmado.

4. 4

   4. Sucursal de origen, conciliación y portal en vivo15 min

   A qué tienda va cada venta, qué guardar y cómo cuadrar el día.

5. 5

   5. Seguridad: lista de integradores y huella del certificado15 min

   Cómo te reconoce FINORA Pago y cómo te autoriza el comercio.

6. 6

   6. Estados, EN_DUDA y anulaciones15 min

   Qué hacer con cada estado sin cobrar dos veces, y cómo anular.

7. 7

   7. Tarjeta FINORA por NFC10 min

   Cobrar con el pase del cliente en su teléfono o con su QR.

8. 8

   8. Operación: lector precalentado y medición de tiempos15 min

   Que el cliente no espere al lector y saber dónde se va cada segundo.

Ejercicio final

Con la app de ejemplo de FINORA (o la tuya) y la variante de demostración de FINORA Pago:

1. Cobra un pedido de la tienda CENTRO, anúlalo y repite la referencia: debes ver APROBADA, ANULADA y CONFLICTO con REFERENCIA_USADA.
2. Envía una venta a un datáfono por la API de pagos y recibe el webhook intencion.resultado con la firma verificada.
3. En el portal del comercio, encuentra ambas ventas en el monitor de transacciones, bajo su sucursal.
4. Mide cinco cobros con el lector frío y cinco con el lector precalentado y compara la mediana del tramo SOLICITUD ⇒ LECTOR_LISTO.

Errores frecuentes

Lo que pasa	Por qué	Qué hacer
Volver a cobrar tras un EN_DUDA	Parece un rechazo	No lo es: repite con la misma referencia o consulta por referenciaFinora
NO_AUTORIZADO en el primer cobro	La huella del certificado no es la de lo que se instala	Usa la huella de la llave que firma el APK instalado (con Play App Signing, la de Google)
Ventas en la tienda equivocada	No se declaró la sucursal o se usó otra	Envía siempre sucursalCodigo o sucursalId desde el pedido
La clave de API dentro de la app	Comodidad	La clave de API vive solo en tu servidor; la app usa el SDK
Ventas de demostración en la conciliación	No se filtró simulado	Descarta los resultados con simulado = true

Videos y capturas

Este curso todavía no tiene capturas ni videos grabados: los ejemplos son de código y de API. Las grabaciones se agregarán cuando el SDK salga de Beta.