Administrador de suscripciones
1. Introducción
El Administrador de suscripciones le permite crear y almacenar pagos periódicos de antemano, en función del intervalo de fechas y de un índice de recurrencia.
Una aplicación normal sería una suscripción de revista, por la que el cliente deba pagar el mismo importe cada mes hasta que la cancele.
El pago de suscripción se puede crear de diversos modos:
- De forma manual, en su cuenta de Viveum
- A través de la creación de transacciones en e-Commerce, DirectLink o Batch
2. En el área de administración
Al hacer clic en el elemento “Suscripción” a través de "Avanzado" en el menú de su cuenta, irá al panel "Administración de suscripciones", que se divide en las siguientes partes:
- "Estado de la suscripción" (página predeterminada) muestra una descripción general de sus suscripciones actuales. Si hace clic en el número de suscripciones correspondiente a un determinado estado aparecerá la lista de suscripciones.
- "Parámetros globales" le permite configurar sus opciones del administrador de suscripciones.
- "Editar/Ver suscripciones" le permite buscar, ver y editar cualquier suscripción que pueda haber almacenado en su cuenta. Es posible descargar una lista de suscripciones en un archivo de texto en lugar de examinar el contenido a través del navegador.
- "Crear suscripción" le permite crear nuevas suscripciones de forma manual.
2.1 Configuración
En la pestaña “Parámetros globales”, puede definir los siguientes valores:
- "Número de reintentos cuando falla un pago". Es posible que uno de los pagos tenga un error. Nuestro sistema lo reintentará el número de veces configurado (máx. 5). El intervalo entre cada intento es de un día.
- "Qué hacer cuando se ha alcanzado el número máximo de reintentos".
- Si decide desactivar una suscripción, ya no se harán más pagos por ella.
- Si decide continuar con el siguiente caso tal como se ha definido en la suscripción, el siguiente pago se realizará en el próximo caso.
- En ambos casos, el pago fallido seguirá sin liquidarse después de que se haya alcanzado el número máximo de reintentos. En caso de que un pago haya fallado después de haber alcanzado el máximo número de reintentos, se enviará una notificación a la dirección de correo electrónico configurada en la pestaña “Correos electrónicos de transacción”, en la página “Información técnica" de su cuenta.
- "Exención de responsabilidad" (solo e-Commerce) define si mostrar o no un mensaje solicitando el consentimiento del comprador al almacenamiento de sus datos de pago para futuros pagos de suscripción. Si no desea utilizar la exención de responsabilidad predeterminada suministrada por Viveum, le recomendamos encarecidamente que solicite el consentimiento del comprador para el almacenamiento de sus datos de pago y los futuros pagos de suscripción por su parte.
2.2 Crear una suscripción
Para crear una suscripción, debe proporcionar la siguiente información:
| Campo | Descripción |
|---|---|
| ID suscripción | Un identificador único para la suscripción. No es un OrderID, ya que cada aparición de la suscripción será un pago independiente. |
| Nombre/correo electrónico/teléfono | Información del titular de la cuenta/tarjeta |
| Tarjetas de crédito/Domiciliaciones bancarias |
El método de pago y la información posterior de la tarjeta o la cuenta. Nota: Las suscripciones de Domiciliaciones bancarias DE no se pueden crear con información de cuenta IBAN; en su lugar, debe usarse Konto/BLZ. No se admite Domiciliaciones bancarias NL. |
| Recurrencia |
Puede elegir entre diario, semanal o mensual Para cada opción, puede ajustar la recurrencia (para una frecuencia semanal, puede elegir el día de la semana; para una frecuencia mensual, puede elegir el día del mes). Si desea tener una recurrencia cada pocos días, debe seleccionar “Diario” y, a continuación, establecer el número necesario de días. - Cuando el día del mes para la suscripción es mayor que el número de días disponible en el mes actual (por ejemplo, no hay 30 de febrero), la suscripción utilizará en su lugar el último día disponible del mes. - Si crea una suscripción con una fecha de inicio en el pasado, cambiaremos la fecha de inicio a una fecha futura, en función de los valores que haya especificado en Recurrencia (véase más arriba). |
| Fecha de inicio/Fecha de finalización |
Intervalo de fechas de la suscripción. Si la fecha del último pago de la suscripción es la fecha exacta de la fecha de finalización, el pago se procesará. Para asegurar el procesamiento de todos los siguientes pagos, te recomendamos no modificar la fecha de inicio hasta que se haya procesado al menos un pago. |
| OrderID | Identificador de pedido que incluirá cada pago de la suscripción. Si hace clic en el botón “añadir dd/MM/aaaa” incluirá la fecha en OrderID, para poder diferenciar con facilidad cada pago de suscripción. |
| COM | Descripción del pedido incluida en cada pago de suscripción. Si hace clic en el botón “añadir dd/MM/aaaa” incluirá la fecha en el campo COM, para poder diferenciar con facilidad cada pago de suscripción. |
| Comentario | Texto libre para almacenar un comentario sobre el comerciante |
| Estado | Si establece la suscripción en “activa”, se ejecutarán los pagos según lo configurado. |
|
Al crear una suscripción, no tiene lugar ninguna verificación de la tarjeta de crédito. La validez de la tarjeta se comprobará con el primer pago de suscripción. |
2.3 Editar una suscripción
La pantalla para editar una suscripción propone las mismas características que para su creación.
Todos los campos están sujetos a cambios, salvo ID de suscripción. Si la tarjeta del cliente caduca, se puede actualizar o cambiar y no será necesario volver a crear la suscripción.
Tenga en cuenta que si edita fechas de pago relacionadas con una suscripción, Viveum podrá procesar un pago "puesto al día" para cubrir cualquier transacción que, de otro modo, hubiese faltado como consecuencia del cambio.
Por ejemplo:
- Semana 1 – Suscripción creada para ser procesada cada miércoles. La primera transacción se procesa ese miércoles
- Semana 2 – Suscripción editada el martes para cambiar el día de procesamiento al lunes
- Semana 3 – Suscripción procesada el lunes
|
IMPORTANTE: Evita la discrepancia de horario de verano entre los usuarios y el PSPID
|
2.4 Eliminar una suscripción
Para eliminar una suscripción, debe buscarla a través del enlace “Editar/Ver suscripciones” y hacer clic en el botón “Eliminar” junto a la suscripción correspondiente.
|
La eliminación de una suscripción solo elimina la programación, pero no reembolsa ni cancela ningún pago en curso. |
2.5 Ver transacciones
Cada transacción de suscripción es un pago independiente, con su propio PAYID y estado. Puede buscarlos a través del enlace “Ver transacciones” del área de administración.
Si desea ver todas las transacciones de suscripción, es más fácil buscarlas a través del administrador de suscripciones, suministrando el ID de suscripción (solo las últimas 12 transacciones serán visibles).
3. A través de e-Commerce e DirectLink
3.1 Entrada
Para crear una suscripción a través de e-Commerce y DirectLink, debe realizarse una transacción inicial. En caso de e-Commerce, si la transacción inicial no ha sido satisfactoria, no se creará la suscripción. Tenga en cuenta que la creación de una suscripción a través de DirectLink requiere una transacción inicial sin 3D Secure.
Consejo: Si no desea realizar una transacción real en el momento de la creación de la suscripción, puede enviar un importe de €0, que luego solo validará la tarjeta. La transacción no se enviará a la entidad adquirente.
Los siguientes datos deben enviarse junto con la transacción para crear una suscripción:
| Campo / Formato | Descripción |
|---|---|
|
SUBSCRIPTION_ID AN, 50 |
Identificador único de la suscripción. El ID de suscripción se tiene que asignar de forma dinámica. |
| SUB_AMOUNT N |
Importe de la suscripción (puede ser diferente del importe de la transacción original) multiplicado por 100, ya que el formato del importe no debe contener decimales ni otros separadores. |
|
SUB_COM AN, 100 |
Descripción del pedido |
|
SUB_ORDERID AN, 40 |
OrderID para pagos de suscripción |
|
SUB_PERIOD_UNIT AN, 2 |
"d" = diariamente "ww" = semanalmente "m" = mensualmente |
|
SUB_PERIOD_NUMBER N |
Intervalo entre cada aparición de pagos de suscripción. |
|
SUB_PERIOD_MOMENT |
Dependiendo de SUB_PERIOD_UNIT (no aplicable para "diariamente" (d) ya que aquí el momento es igual a la unidad)
|
|
SUB_STARTDATE Date |
Fecha de inicio de la suscripción |
|
SUB_ENDDATE Date |
Fecha de fin de la suscripción |
|
SUB_STATUS AN, 1 |
0 = inactivo 1 = activo |
|
SUB_COMMENT AN, 200 |
Comentario para el comerciante |
|
CN AN, 35 |
Nombre del titular de la tarjeta Debe enviarse en el campo de solicitud en la página de pago de e-Commerce |
|
Si los campos EMAIL y OWNERTELNO están completos con el pedido, también se añadirán a la suscripción.
Nota: Los pagos de suscripción siempre se procesarán como ventas directas. No obstante, al utilizar e-Commerce, la primera transacción se procesará según esté configurada en la página Información técnica de su cuenta.
3.2 Comentarios
En la respuesta de postventa se devolverán los siguientes parámetros:
| Campo | Descripción |
|---|---|
| subscription_id | confirmación del identificador de suscripción único |
| creation_status | Indica si la suscripción se ha creado de forma correcta. Valores posibles: “OK” o “ERROR”. |
|
Importante
|
4. A través de Fichero de Lote
Los siguientes campos deben enviarse para operaciones de suscripción de lote:
| # / Campo (*=Obligatorio) / Formato | Detailes |
|---|---|
|
1 / OPERATION* AN, 8 |
ADDSUBS (Añadir suscripción) DELSUBS (Eliminar suscripción) |
|
2 / CN* AN, 35 |
Nombre del titular de la tarjeta |
|
3 / ACC_CARDNO* AN, 23 |
Número de cuenta bancaria o tarjeta |
|
4 / EXPDATE* AN, 4 |
Fecha de caducidad (si es aplicable) |
|
5 / BRAND* AN, 25 |
Marca del método de pago |
|
6 / PSPID* AN, 30 |
Identificador del comerciante en nuestro sistema |
|
7 / SUBSCRIPTION_ID* AN,50 |
Identificador único de la suscripción |
|
8 / AMOUNT* N |
Importe de la suscripción, multiplicado por 100 (ya que el formato del importe no puede contener decimales u otros separadores). |
|
9 / CURRENCY* AN, 3 |
Divisa (formato ISO de 3 dígitos) |
|
10 / PERIODICITY_UNIT* AN, 2 |
‘d’ = diariamente ‘ww’ = semanalmente ‘m’ = mensualmente |
|
11 / PERIODICITY_NUMBER* N |
Intervalo entre cada aparición de pagos de suscripción. |
| 12 / PERIODICITY_MOMENT* | Dependiendo del campo 10 Diariamente (d): intervalo en días Semanalmente (ww): 1=Domingo, … 7=Sábado Mensualmente (m): día del mes |
|
13 / SUBSCRIPTION_STATUS* N |
0 – Inactivo 1 – Activo |
|
14 / START_DATE* Date |
Fechas de inicio y de finalización. Observe que el formato de fecha debe ser dd-MM-aaaa Todas las fechas se convierten con el huso horario del usuario. Por ejemplo, si la START DATE es 01/05/2020 y el usuario está definido en GMT–1, la fecha/hora se convertirá a 01/05/2020 1:00:00 (CET). |
|
15 / END_DATE Date |
|
|
16 / EXTERNALREF_PATTERN AN, 40 |
Referencia del pago. Puede incluir patrones de fecha que serán reemplazados por los valores reales en la fecha de pago. Ej.: suscripción 123 [MM-AAAA] |
|
17 / COMDESC_PATTERN AN, 100 |
Descripción del pedido. Aquí también puede usar patrones de fecha, que serán reemplazados por sus valores en el momento de cada pago. Por ejemplo, su revista [AAAAddd] |
| 18 / (empty) | |
|
19 / BUYER_EMAIL AN, 50 |
Dirección de correo electrónico |
|
20 / BUYER_TELNO AN, 50 |
Número de teléfono |
|
21 / COMMENT AN, 200 |
Comentario de texto libre |
|
Ejemplo de suscripción VISA:
ADDSUBS;John Doe;4111111111111111;1012;VISA;PSPID;ID001;100;EUR;d;1;1;1;2010-08-13;2011-08-13;Cotisation [MM-YYYY];Paiement n° [YYYYddd];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs;
Ejemplo de suscripción de Domiciliaciones bancarias:
ADDSUBS;John Doe;XXXXXXXXXBLZXXXXXXXX;;DIRECT DEBITS DE;PSPID;ID002;100;EUR;d;1;1;1;2010-04-20;2010-05-15 00:00:00.000;Cotisation [MM-YYYY];Paiement n° [YYYYddd];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs;
Nota: Si copia/pega estas líneas de ejemplo para realizar una prueba en su cuenta de prueba, asegúrese de que reemplaza el PSPID y los números de cuenta.
Si desea más información, vaya a Fichero de Lote.