Comment construire pour un switch auquel on n’est pas encore raccordé

Il y a deux façons de construire pour un système national auquel on n’est pas encore raccordé.

La courante : attendre le profil, puis écrire l’intégration contre lui. C’est prudent, cela coûte un an, et au bout de l’année on découvre les problèmes intéressants pour la première fois.

Le protocole est la partie facile

Traduire entre des formats de messages est du travail, mais c’est du travail connu. N’importe quelle équipe compétente le fait une fois la spécification disponible.

Le difficile est le comportement sur les bords, et rien de cela ne dépend du format :

• Le switch dépasse le délai — mais l’argent a bougé.
• Un paiement est signalé introuvable, provisoirement, puis retrouvé.
• Un succès en double arrive pour quelque chose déjà réglé.
• Un rejet tardif contredit un succès sur lequel vous avez déjà agi.
• Un accusé de réception arrive sans aboutissement derrière lui.

Chacune de ces situations est une décision sur de l’argent, et chacune peut être conçue, construite et testée avant que quiconque ne publie quoi que ce soit.

Un contrat interne

Les paiements sont exprimés dans une forme canonique interne qui ne présume rien du transport : ni ISO 8583, ni ISO 20022, ni REST, ni SOAP.

Un adaptateur traduit entre cette forme et ce que le système parle. Le protocole n’atteint jamais la logique métier, ce qui a deux conséquences :

1. Un changement de profil est un changement de codec.
2. Un deuxième système, dans un deuxième pays, est un deuxième adaptateur plutôt qu’une deuxième plateforme.

Le simulateur est fait pour les cas pénibles

Notre simulateur ne simule pas un paiement réussi, cas facile qui ne vous apprend rien.

Il reproduit le dépassement de délai après un effet financier. L’introuvable provisoire. Le succès en double. Le rejet tardif contradictoire. La signature invalide. L’accusé de réception sans rien derrière. L’autorisation qui n’aboutit jamais.

Ce sont les scénarios qui, rencontrés pour la première fois en production, se transforment en un mois de rapprochement et une conversation difficile avec un régulateur.

Il ne fait jamais semblant

Tout ce que le simulateur produit est étiqueté comme simulation, et il n’atteste jamais d’une certification.

C’est une ligne délibérée. Un simulateur que l’on pourrait prendre pour un raccordement certifié est un risque — pour nous, et pour quiconque lirait un rapport qui en serait issu. La certification est un état distinct et enregistré, et l’adaptateur certifié ne se charge que pour un raccordement qui l’a.

Les frais restent hors du paiement

Les frais d’agrégation sur les paiements du switch sont provisionnés par paiement abouti et facturés par période et par devise.

Ils ne sont jamais enregistrés sur le paiement lui-même. Le montant du paiement est le montant du paiement ; les frais sont une obligation distincte et visible sur un relevé. Un commerçant peut voir ce qu’on lui a facturé sans le reconstituer depuis un montant net.

Ce que vous pouvez vérifier

Ce sont des faits sur la plateforme en fonctionnement, pas des adjectifs. Chacun est visible dans le produit, dans la référence de l’API ou dans le grand livre.

• Le contrat interne ne présume rien du format de transport — ni ISO 8583, ni ISO 20022, ni REST — de sorte que le protocole n’atteint jamais la logique métier.
• Le simulateur reproduit un dépassement de délai après un effet financier, un introuvable provisoire, un succès en double, un rejet tardif contradictoire, une signature invalide et un accusé de réception sans aboutissement.
• Tout ce que le simulateur produit est étiqueté comme simulation et il n’atteste jamais d’une certification.
• Un adaptateur certifié n’est chargé que pour un raccordement dont l’état de certification le dit.
• Les frais d’agrégation sur les paiements du switch sont provisionnés par paiement abouti et facturés par période, jamais enregistrés sur le paiement lui-même.

Ce que cela coûte

Les frais de système et d’agrégation sont définis dans la console et apparaissent sur le relevé du commerçant comme leur propre ligne.

Est-ce activé ?

La disponibilité dépend des autorisations en place et de ce que l’administrateur d’un déploiement donné a activé. Cela change, un article non — la réponse vivante est donc sur la page de la fonctionnalité, qui la lit dans la plateforme elle-même : Raccordement au switch national sur la page des fonctionnalités.

À lire ensuite

• Smart Route — Le rail qui marchera, pas le rail qui vient en premier.
• Réseau de corridors — La posture réglementaire comme configuration.
• L’API de la passerelle — Trois appels et une notification.