Aller au contenu

Liaison des comptes

Envoyez {institution, currency, account_selector} à POST /v1/payer/account-links, avec une session DPoP active, une nouvelle preuve et un UUID Idempotency-Key. Les institutions locales sont sim-wallet et sim-bank ; les devises CDF et USD. Les sélecteurs de test sont synthetic-{institution}-{approved|declined|pending}. Ne collectez jamais le PIN, mot de passe ou OTP de l’émetteur.

L’API payeur ne tourne que dans le bac à sable local : le bac à sable hébergé ne la sert pas encore.

PENDING confirme uniquement le consentement. Seule une preuve signée par l’émetteur configuré peut produire VERIFIED ou DECLINED. Consultez GET /v1/payer/account-links/{id} pour l’état courant ; une reprise exacte de création ou de consentement conserve son ancien résultat. Les lectures ne prolongent pas l’inactivité de la session.

Les limites persistantes sont cinq créations/appareil/minute, vingt/payeur/heure, dix essais de consentement/requête et cinquante/appareil/minute. Une expiration, un appareil révoqué ou une décision contradictoire ne crée aucun nouveau lien. Le champ approval_url du statut ouvre le canal simulé lorsque issuer_channel vaut WAITING. L’ouverture ne donne aucun consentement émetteur ; une action explicite est requise sur cette page. Revenez à Futa et consultez le statut protégé. Les scénarios réels de banque/opérateur, la récupération et la suppression d’un lien restent des étapes distinctes. Android utilise Retrofit, Room et Hilt ; iOS conserve sa propre logique native.