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:

CampoDescripció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.
La misma regla es válida para semanas y meses; por ejemplo, si la recurrencia debe ser el día 5 cada dos meses, configure Recurrencia en "Mensual" y el pago se producirá el día "5" de cada "2" meses.

Nota:
- 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

  • Cuando edites las suscripciones, asegúrate de adaptar la configuración de horario de verano de tu usuario a la configuración del PSPID
  • De lo contrario, es posible que no se activen los pagos pendientes para las suscripciones modificadas en este PSPID
  • Para cambiar la configuración de tu usuario, ve a Configuración > Usuarios > Editar en tu usuario > marca/desmarca “Ajustar automáticamente los cambios de ahorro para luz diurna”
  • Para cambiar la configuración del PSPID, ve a Configuración > Cuenta > Sus detalles administrativos > marca/desmarca “Ajustar automáticamente los cambios de ahorro para luz diurna"

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.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
N

Dependiendo de SUB_PERIOD_UNIT (no aplicable para "diariamente" (d) ya que aquí el momento es igual a la unidad)
  • Semanalmente (ww): 1=Domingo, … 7=Sábado
  • Mensualmente (m): día del mes (1-31)

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

  • Recuerde incluir estos campos en su cálculo SHA. Para obtener más información sobre SHA, vaya a e-Commerce o documentación de DirectLink.
  • Los pagos de suscripción solo se ejecutarán una vez que el estado de la suscripción sea “activo”. El estado de la suscripción no cambia de forma automática a activo en la fecha de inicio definida en la suscripción.

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

  • En la primera transacción, el feedback se devuelve mediante una llamada post-venta (pospago) de servidor a servidor. Para cada transacción posterior, el feedback se devuelve mediante una llamada post-venta (pospago) diferida. Para obtener más información, consulte el capítulo siguiente: Respuesta de servidor a servidor (pospago).
  • Recuerde incluir estos campos en su cálculo SHA-OUT. Para obtener más información sobre SHA, vaya a e-Commerce o documentación de DirectLink.

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

  • El archivo debe ser un archivo de texto ASCII
  • El archivo solo debe contener una línea por suscripción. Las líneas se separan mediante los caracteres retorno de carro o avance de línea (ASCII :13 10 – HEX : 0xD 0xA)
  • Los campos deben estar separados por un (“;”)
  • Los campos no pueden contener ningún punto y coma (“;”)

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.