Cet article suppose que vous avez actuellement une intégration avec notre ancienne API.
Si vous ne disposez pas d'une intégration existante ou si vous utilisez notre API actuelle, cet article ne vous concerne pas. Vous pouvez consulter la documentation relative à notre API actuelle ici.
Autorisations > Mandats
Les autorisations sont désormais des mandats. Les mandats sont bien plus flexibles : vous pouvez maintenant créer des paiements ponctuels ou des abonnements avec le même mandat, et les mandats peuvent être rattachés à plusieurs abonnements. Le client n'a pas besoin d'autoriser à nouveau les nouveaux paiements ou abonnements sur un mandat.
Factures > Paiements
Notre ancienne API offrait la possibilité de créer des factures ponctuelles, ou une série de factures ponctuelles ayant fait l'objet d'une pré-autorisation. Les factures sont maintenant appelées des paiements, et un paiement créé peut être soit unique, soit faire partie d'un abonnement.
Création de clients
Auparavant, vous deviez créer un lien d'autorisation pour un paiement ponctuel, une pré-autorisation ou un abonnement.
Maintenant, vous n'avez besoin que du flux de redirection. Le flux de redirection vous permet de diriger vos clients vers les pages de paiements GoCardless, puis de les rediriger vers votre site Web pour terminer l'exécution du flux. Vous recevrez en retour l'identifiant du client, l'identifiant du compte bancaire du client et l'identifiant du mandat. Vous n'aurez plus besoin que de l'identifiant du mandat pour créer un paiement ou un abonnement pour le client.
Événements et webhooks
Notre ancienne API envoyait des webhooks à propos du statut d'une facture, d'une pré-autorisation ou d'un abonnement. Notre nouvelle API créé des événements pour un certain nombre d'actions sur toutes les ressources - qu'elles aient été créées via l'API ou le tableau de bord. Ces événements peuvent être interrogés via le point de terminaison des événements ou envoyés à votre intégration sous la forme d'un webhook.
Versements
Notre nouvelle API vous permet toujours d'interroger les versements que vous recevez de GoCardless. D'autre part, nous avons ajouté quelques étapes qui vous aideront à rapprocher les versements et les événements, ce qui veut dire que vous pourrez obtenir une liste des paiements correspondant à un versement spécifique via l'API.
Envoi de requêtes à l'API
Les points de terminaison de notre nouvelle API sont différents et le processus d'envoi des requêtes à légèrement changé. Mais ne vous en faites pas, ces changements sont expliqués en détail dans notre documentation adressée aux développeurs.