Merchant
Estado: Producción
Las APIs del Merchant están en producción. Cada sección indica si alguna parte está en Beta o Próximamente.
El Merchant de FINORA es la plataforma de cobros para comercios: checkout web y en apps, cobro en terminales y cajas, flota de terminales y avisos firmados. Tu sistema nunca ve una tarjeta ni una clave de pago: envía el monto y una referencia, y recibe un veredicto.
¿No sabes por dónde empezar? Lee Elige tu integración: compara los cinco escenarios con un diagrama de cada recorrido.
Conceptos comunes
- Servidor:
https://pos.finoracore.com. El sandbox usa el mismo servidor. - Credenciales: la clave API (
X-API-Key) es de tu servidor; el navegador del cliente usa un token de sesión; los equipos del mostrador se enrolan con un código de un solo uso. Ver Autenticación y alcance. - Errores:
ProblemDetailcon uncodigoestable. Ver Códigos de error. - Pruebas: los céntimos del monto deciden el veredicto. Ver Sandbox.
- Veredictos:
APROBADA,RECHAZADA,EN_DUDA,CANCELADAyEXPIRADA.EN_DUDAsignifica que no se sabe si el banco cobró: no se reintenta con otra clave ni se da por rechazado.
APIs
| API | Estado | Para |
|---|---|---|
| Checkout y SDK web | Producción | Cobro en línea con página alojada o componente web |
| Pagos y cobro empujado | Producción | Intenciones de cobro desde tu ERP y envío a un terminal |
| Webhooks | Producción (suscripciones de eventos en Beta) | Avisos firmados del resultado |
| TMS | Producción | Comandos y telemetría de tus terminales |
| FINORA Pago para Windows | Producción | Cobro desde una caja de escritorio por API local |
| API ECR del terminal | Beta | Caja registradora que dispara el cobro en el terminal |
| Marketplace y licencias | Beta | Validar la licencia de una app en el terminal |
Las APIs que usan internamente el portal del comercio y las apps de FINORA en el terminal no están abiertas a terceros.