Suscripciones
El servicio de suscripciones de Mobbex te permite gestionar el cobro recurrente de tus servicios a cada uno de tus clientes de diferentes formas. Existen básicamente 2 tipos de suscripciones: Dinámicas y Manuales. Las diferencias entre cada una de ellas se encuentran detalladas en el siguiente documento: Suscripciones Dinámicas vs Manuales.
El flujo básico de creacón de una suscripción y, en el caso de ser necesario, también del suscriptor vía API es el siguiente:
A continuación se detalla cada una de las API's disponibles para la integración de nuestro servicio con cualquier aplicación:
Ejemplos del nodo features:
- validate_id: Validate ID controlará el DNI del suscriptor contra el Tarjeta-Habiente rechazando la operación en caso de no coincidir.
- accept_no_funds: Accept No Funds aceptará los casos donde la tarjeta no posea fondos como un caso válido de tokenización.
- no_email: Desactivará los emails de aviso al Suscriptor pero no los emails de aviso al comercio.
- no_cc: Desactivará la cuenta corriente, por lo tanto si el cliente posee deuda no intentará recobrarla automáticamente.
- no_retry: Desactivará el reintento de cobro automático. Si un cobro falla deberá ejecutarlo manualmente.
Ejemplos del nodo sources:
Valores importantes en la respuesta:
- sourceUrl: URL a la que debe enviar al usuario a añadir la Tarjeta
- subscriberUrl: URL de Control del Suscriptor.
Tenga en cuenta que sólo se podrá mover un suscriptor a otra suscripción dentro de la misma entidad. Durante el proceso de mover al suscriptor la agenda del mismo será recalculada cuando la suscripción sea "dynamic"
Los webhooks siempre serán enviados en formato application/x-www-form-urlencoded
El servicio para este Webhook utiliza los webhooks estandares descriptos en la sección Webhooks de esta documentación agregando los nodos "subscription" y "subscriber"
Cuando el servicio redirige al suscriptor a la return_url definida al crear la suscripción, se agregan un conjunto de parámetros en la url para indicarle al sitio el resultado de la suscripción.
Los parámetros de tipo query que se agregan a la url definida son:
- reference: referencia asignada al suscriptor.
- status: estado de la transacción asociada a la operación de suscripción.
- uid: ID de la suscripción.
- sid: ID del suscriptor.
Cuando se cancela el proceso de suscripción, el status será 0.