Primeros Pasos
Según el tipo de cuenta que tengas podrás acceder a tu consola Fresa o Mobbex. Desde allí podrás administrar tu cuenta y asociar una App para integrar los pagos.
Para poder acceder a nuestra API es necesario poseer un API Key y un Access Token. Para obtenerlos se deben seguir los siguientes pasos
1) Ingresar a Portal de Desarrolladores con las credenciales del comercio.
2) Crear una nueva aplicación desde el botón "+" o Gestionar una existente.
3) Llenar los campos para Crear la nueva Aplicación:
- Nombre: Colocá el nombre de tu aplicación para poder identificarla.
- Descripción: Podes colocar cualquier dato que te permita identificar en qué o para qué la utilizas.
- URL de tu Aplicación: Colocá el link del sitio web. Esto es a modo de referencia unicamente.
4) Ingresar a la aplicación desde el botón Gestionar.
5) Presiona sobre el botón + y obten el acceso a una Entidad mediante la opción Solicitar Acceso. Ingresar el CUIT de la ENTIDAD (cuenta creada en Mobbex) para pedir autorización a esa ENTIDAD. O Ver Credenciales para usar las de una Entidad ya autorizada. IMPORTANTE: en el caso de que no encuentres la Entidad mediante el CUIT puede que el alta todavía esté gestionándose. Podes probar la integración con nuestras credenciales de prueba.
6) Volver a la consola Mobbex y en el apartado de APP/E-Commerce se podrá ver que una Aplicación solicita acceso. Presionar en Autorizar. Nota: la opción Ver Aplicación no llevará a ningún sitio.
7) Ingresar nuevamente a Portal de Desarrolladores y Gestionar la aplicación deseada. Allí ahora podremos observar la ENTIDAD que fue autorizada y podremos Ver Credenciales.
Habiendo obtenido ambos keys se puede proceder a generar las solicitudes a la API descriptas en esta documentación.
Las credenciales de pruebas proporcionadas son facilitadas para que puedas realizar operaciones dentro de un ambiente de SandBox, sin tener que crear una cuenta en Fresa/Mobbex.
x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc
Todas las operaciones realizadas con estas credenciales se pueden ver reflejadas dentro de la cuenta DEMO. Los datos de acceso a la misma son:
- Entidad / Comercio: Demo Mobbex
- Usuario: [email protected]
- PIN: 0000
De igual modo, es posible realizar pruebas dentro de un ambiente sandbox utilizando las credenciales productivas del comercio y añadiendo dentro del servicio correspondiente la variable test: true
Para realizar pruebas en producción es recomendable intentar procesar montos superiores a $20 para evitar errores o rechazos de parte del procesante.
Cabeceras (Headers)
Todas las solicitudes a nuestra API deben tener 3 cabeceras que son estándar a cada uno de los recursos: x-api-key: Clave API de su aplicación. x-access-token: Token de Acceso a la entidad para la cual desea realizar la operación.
content-type: application/json
