Para crear una suscripción a través de la API, tienes que hacer una solicitud POST al extremo /subscriptions.
Al crear una suscripción, puedes personalizar los parámetros siguientes:
- Cantidad: la cantidad se tiene que enviar en peniques o céntimos y no puede contener ningún carácter especial
- Divisa: en la actualidad, las únicas admitidas son GBP y EUR.
- Nombre: nombre opcional de la suscripción, que también establecerá la descripción de cada pago.
- Interval_unit: la unidad de tiempo entre fechas de cargo, ya sea semanal, mensual o anual.
- Intervalo: la cantidad de interval_units entre cada fecha de cargo. Debe suponer, como mínimo, un cargo al año. Si no se especifica, se asigna un valor predeterminado de 1.
- Recuento: la cantidad total de pagos que se van a aceptar por la suscripción.
- Day_of_month: el día del mes (1-28) en el que deseas que se efectúe el cargo al cliente. También puedes utilizar -1 para indicar el último día del mes.
- Mes: el nombre del mes en el que se efectúa el cargo al cliente.
- Start_date: la fecha en la que se debe cargar el primer pago. Esta fecha debe estar dentro del plazo de un año desde la creación de la suscripción y en la fecha next_possible_charge_date del mandato o en una fecha posterior. Si no se incluye este parámetro, el primer pago se cargará lo antes posible.
- Payment_reference: este parámetro está restringido únicamente a cuentas Pro. Una referencia de pago opcional que se establecerá para todos los pagos y que aparecerá en el extracto bancario de tu cliente.
Por ejemplo, para crear una suscripción que efectúa un cargo
- de 25 £
- el día 5 de cada mes
- a partir del 01/02/2018
- durante 12 meses
tienes que enviar la siguiente solicitud POST al extremo /subscriptions, con un enlace al identificador de mandato que desees modificar: