Métadonnées ProAbono dans GoCardless

Présentation

Un business qui encaisse via GoCardless retrouve les mêmes transactions à deux endroits : les factures ProAbono d’un côté, les paiements GoCardless qui les règlent de l’autre. Chaque objet créé dans GoCardless par ProAbono porte des métadonnées préfixées pa_ — pa_ pour ProAbono — qui le rattachent aux objets ProAbono dont il découle : facture, client, paiement. Ce sont elles qui assurent la traçabilité des opérations entre les deux plateformes.

Cette traçabilité a plusieurs usages :

le rapprochement bancaire : relier un versement GoCardless aux factures ProAbono qu’il règle ;
l’informatique décisionnelle (BI) : croiser les données GoCardless et ProAbono dans les mêmes analyses ;
les contrôles : vérifier, par exemple, que chaque paiement GoCardless se rattache bien à une facture ProAbono ;
l’investigation : remonter d’un paiement ou d’un client GoCardless à son origine dans ProAbono, pour analyser un bug ou une situation signalée par un client.

Fonctionnement

Métadonnées d’un client GoCardless

Métadonnée	Exemple	Description
`pa_request_id`	`2334264`	Identifiant interne unique de la demande de paiement : la requête adressée à GoCardless pour encaisser un paiement, aussi appelée tentative de paiement. Une tentative peut réussir ou échouer, et chacune porte son propre identifiant. Réservé à un usage technique.
`pa_customer_id`	`133700`	Identifiant interne unique du client ProAbono. Réservé à un usage technique.
`pa_customer_ref`	`cust-42`	Référence du client dans ProAbono. Elle identifie le client de façon unique et figure sur les factures qui lui sont envoyées.

Métadonnées d’un paiement GoCardless

Métadonnée	Exemple	Description
`pa_invoice_id`	`4574980`	Identifiant interne unique de la facture ProAbono, distinct du numéro de facture imprimé sur le document. Il suffit pour retrouver la facture, numéro compris, avec l’API ProAbono.
`pa_request_id`	`2482873`	Identifiant interne unique de la demande de paiement — la tentative de paiement — dont ce paiement est issu. Réservé à un usage technique.
`pa_customer_ref`	`cust-42`	Référence du client dans ProAbono, identique à celle portée par le client.

Deux clés méritent d’être distinguées : pa_customer_ref est publique — elle figure sur les factures du client — tandis que tout identifiant terminé par _id reste interne à ProAbono et n’apparaît sur aucun document.

Rapprochement bancaire

Un opérateur de paiement ne reverse pas chaque transaction séparément. Les paiements sont encaissés, puis reversés en bloc sous forme de versement : un seul virement qui regroupe de nombreuses transactions et qui apparaît sur le compte bancaire en une seule ligne de relevé, sans détail. Un versement contient des paiements, des remboursements et, selon l’opérateur, des frais qui lui sont propres, comme ses commissions.

Le rapprochement d’un versement avec les factures ProAbono peut partir de l’un ou l’autre côté.

Côté GoCardless, le détail du versement se lit dans le tableau de bord GoCardless : les paiements qu’il regroupe s’affichent, et chaque paiement porte ses métadonnées ProAbono. Le numéro de chaque facture s’obtient alors par une simple requête à l’API ProAbono, à partir de pa_invoice_id ; la référence lue dans pa_customer_ref se recherche telle quelle dans Abonnés. Ce chemin s’automatise entièrement, puisque l’API GoCardless renvoie les mêmes métadonnées dans l’objet metadata d’un paiement ou d’un client.

Côté ProAbono, le rapprochement s’appuie sur la liste Transactions automatisées : chaque transaction y figure avec la référence du client, le numéro de facture et, dans la dernière colonne, l’identifiant de la transaction chez l’opérateur de paiement — ici GoCardless. Comme toutes les listes de ProAbono, la liste des transactions automatisées s’exporte en fichier CSV ou JSON, ou s’extrait par l’API BackOffice. Distincte de l’API Live, cette API sert avant tout à l’extraction de données.

Les versements, en revanche, ne sont pas visibles dans ProAbono : GoCardless les effectue directement vers le compte bancaire du business. Un versement entier se rapproche donc en joignant deux fichiers — la liste de ses paiements, exportée depuis GoCardless, et celle des transactions automatisées — sur l’identifiant de la transaction GoCardless, sans ouvrir les paiements un par un.

Les deux chemins s’automatisent par les API : voir Comment automatiser le rapprochement bancaire.