En este artículo se asume que actualmente dispones de una integración con nuestra API heredada.
Si no dispones de una integración existente o si ya estás utilizando la API actual, este artículo no es aplicable a tu caso. Puedes consultar la documentación de la API actual aquí.
Autorizaciones > Mandatos
Ahora, las autorizaciones son mandatos. Los mandatos son mucho más flexibles, puedes crear pagos puntuales o suscripciones con el mismo mandato y los mandatos pueden tener varias suscripciones asociadas. No hace falta que el cliente vuelva a autorizar los pagos o suscripciones nuevos de un mandato.
Facturas > Pagos
La API heredada permitía crear facturas puntuales o una serie de facturas puntuales con una autorización previa. Ahora, las facturas se denominan pagos, y un pago se puede crear con carácter puntual o como parte de una suscripción.
Creación de clientes
Anteriormente, era necesario crear un enlace de autorización, ya fuera para un pago puntual, una autorización previa o una suscripción.
Ahora, simplemente hay un flujo de redirección. El uso del flujo de redirección te permite enviar a los clientes a las páginas de pago de GoCardless y, a continuación, enviarlos de vuelta a tu sitio web para que completen el flujo. A cambio, recibirás un identificador de cliente, un identificador de la cuenta bancaria del cliente y un identificador de mandato. Después, solo necesitarás el identificador de mandato para crear un pago o una suscripción para el cliente.
Eventos y webhooks
La API heredada enviaba webhooks sobre el estado de una factura, una autorización previa o una suscripción. La API nueva crea eventos para una serie de acciones sobre todos los recursos, ya sea que se hayan creado a través de la API o del panel de control. Estos eventos se pueden consultar a través del extremo de eventos o enviar como un webhook a tu integración.
Desembolsos
La API nueva sigue permitiendo hacer consultas sobre los desembolsos que recibes de GoCardless. Además, hemos añadido algunos pasos para ayudarte a conciliar los desembolsos con los eventos, de modo que podrás obtener un listado de los pagos de un desembolso específico a través de la API.
Realización de solicitudes a la API
Los extremos de la API nueva son diferentes y la realización de solicitudes ha cambiado un poco, pero no te preocupes, ya que se explican detalladamente en la documentación para desarrolladores.