Solicitud pago recurrente suscripcion

Cuando se desee realizar un nuevo cobro con determinada periodicidad, sobre una tarjeta o cuenta previamente guarda por un cliente de su organismo, deberá invocar a este método.
A continuación, se visualizan la lista de parámetros que recibe y la información que devuelve:

Este método no está disponible para todos los organismos. Consulte a su ejecutivo comercial


Parámetros recibidos

Nombre Tipo Descripción
version Texto Versión del protocolo:
- Valor fijo “2.0”
tipo_operacion Set Tipo de la operación. Valor fijo “op_pago_recurrente”
credenciales Estructura Credenciales Contiene la información para generar el token
operacion Estructura DatosOperacionPago Los datos de la operación a realizar
suscripcion Array de Estructura DatosSuscripcion Contiene los datos de cada una de las planificaciones de los cobros recurrentes. Al menos deberá tener un elemento
suscripción_modalidad Set La modalidad de la suscripción deberá ser uno de los siguientes valores:
  • P=Personalizada
  • M=Mensual
  • S=Semanal
  • A=Anual
descripcion Texto El nombre de la descripción
convenio Numérico entero El número de convenio asignado por ePagos
medio Set Establece la forma de pago por la que se realizarán los cobros
  • op_pago_recurrente_medio_tarjeta
  • op_pago_recurrente_medio_debin
  • op_pago_recurrente_medio_debito_directo
clientes Array de Estructura SuscripcionCliente Contiene cada uno de los clientes incluidos en esta suscripción


Credenciales
Nombre Tipo Descripción
id_organismo Numérico entero Código de organismo
token Texto El token devuelto por obtener_token


DatosSuscripcion
Nombre Tipo Descripción
fecha Fecha (AAAA-MM-DD) Fecha en que se realizará el cobro. Deberá ser mayor a la fecha actual.
monto Numérico decimal Permite indicar un monto diferencial sobre el pago en esta fecha.
Si no se define, se usa el valor definido en la estructura operacion


SuscripcionCliente
Nombre Tipo Descripción
identificador_cliente Texto El identificador de cliente que se usó para la solicitud en donde se registraron las tarjetas
identificador_tarjeta Texto El identificador de tarjeta de cliente a utilizar para el pago.
Debe haber sido previamente guardada en una solicitud de pago y obtenido con el método obtener_tarjetas_cliente
identificador_cuenta Texto El identificador de cuenta de cliente a utilizar para el pago.
Debe haber sido previamente guardada en una solicitud de pago y obtenido con el método obtener_cuentas_cliente

Respuesta

Nombre Tipo Descripción
id_resp Numérico entero El código de respuesta
respuesta Texto La descripción de la respuesta
token Texto El token con el que se hizo la consulta
id_organismo Numérico entero El código de organismo


Respuestas posibles

id_resp Tipo Respuesta
11001 Correcta Pago recurrente con suscripción planificado
11002 Error Error al validar el token.
11003 Error Error interno al intentar procesar el pago recurrente con suscripción
11004 Error Error al validar el parámetro: [_parametro_]
11005 Error No coinciden los montos y los detalles
11006 Error La fecha de planificación es inválida
11007 Error No existe una tarjeta guardada con dichos datos
11008 Error No existe una cuenta guardada con dichos datos
11009 Error Versión inválida del protocolo
15002 Error Método no autorizado para su organismo