Métadonnées ProAbono dans Stripe

Présentation

Un business qui encaisse via Stripe retrouve les mêmes transactions à deux endroits : les factures ProAbono d’un côté, les paiements Stripe qui les règlent de l’autre. Chaque objet créé dans Stripe 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 virement Stripe aux factures ProAbono qu’il règle ;
l’informatique décisionnelle (BI) : croiser les données Stripe et ProAbono dans les mêmes analyses ;
les contrôles : vérifier, par exemple, que chaque paiement Stripe se rattache bien à une facture ProAbono ;
l’investigation : remonter d’un paiement ou d’un client Stripe à son origine dans ProAbono, pour analyser un bug ou une situation signalée par un client.

Fonctionnement

Métadonnées d’un client Stripe

Métadonnée	Exemple	Description
`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 Stripe

Métadonnée	Exemple	Description
`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, identique à celle portée par le client.
`pa_invoice_id`	`4577651`	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`	`2487116`	Identifiant interne unique de la demande de paiement : la requête adressée à Stripe pour encaisser ce 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.

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.

Un client Stripe porte deux clés là où un paiement en porte quatre : une facture et une demande de paiement n’existent qu’à partir du moment où un paiement a été demandé.

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 : un seul virement regroupe de nombreuses transactions et apparaît sur le compte bancaire en une seule ligne de relevé, sans détail. Un virement contient des paiements, des remboursements et, selon l’opérateur, des frais qui lui sont propres, comme ses commissions.

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

Côté Stripe, le détail du virement se lit dans le tableau de bord Stripe : 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 Stripe 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 Stripe. 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 virements, en revanche, ne sont pas visibles dans ProAbono : Stripe les effectue directement vers le compte bancaire du business. Un virement entier se rapproche donc en joignant deux fichiers — la liste de ses paiements, exportée depuis Stripe, et celle des transactions automatisées — sur l’identifiant de la transaction Stripe, sans ouvrir les paiements un par un.

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