Skip to main content
Chaque compte appartient à un client. Choisissez-le selon deux dimensions : qui le gère et s’il s’agit d’un portefeuille ou d’un compte bancaire. Les opérations de liste, création, lecture, mise à jour et archivage des comptes client sont sous /v3/customers/{customerId}/accounts ; les opérations sur un compte ajoutent /{accountId}. Il n’existe pas de recherche inverse de accountId vers customerId. Conservez le customerId avec chaque accountId afin que les requêtes suivantes puissent cibler le compte.

​
Choisir un compte

issued signifie que Swipelux crée et gère la ressource. external enregistre un endpoint détenu par le client. Un endpoint tiers relève d’un destinataire et d’une destination, pas de la liste des comptes du client. Avant de démarrer le parcours First pay-in du panneau marchand pour les cartes ou Apple Pay, créez un portefeuille Polygon pour ce client. Le parcours ne propose que ce portefeuille Polygon et ne peut pas continuer sans lui. Ce prérequis s’applique au parcours du panneau marchand ; les intégrations API directes doivent utiliser uniquement les devises, réseaux, méthodes et types de compte renvoyés pour le client et la capacité actuels.

​
Créer le compte

Utilisez POST /v3/customers/{customerId}/accounts. Envoyez ces en-têtes avec l’un des corps de requête ci-dessous :
Utilisez uniquement les devises, réseaux, méthodes et types de compte renvoyés pour le client et la capacité actuels. Ne copiez pas la disponibilité d’un autre client ou environnement.

​
Attendre que le compte soit utilisable

Stockez data.id, data.status et data.openTaskIds depuis la réponse de création. Lisez le dernier compte avec GET /v3/customers/{customerId}/accounts/{accountId} avant de créer un devis de transfert ou d’afficher les coordonnées bancaires. Utilisez le compte uniquement lorsque son statut actuel autorise la prochaine opération. Si des IDs de tâche sont ouverts, complétez-les via Capacités et tâches. Un compte bancaire émis peut renvoyer details: null pendant le provisionnement. Présentez les coordonnées bancaires uniquement après qu’une lecture actuelle a renvoyé l’ensemble complet. Si details.referenceRequired est true, affichez exactement la details.reference avec les coordonnées bancaires.

​
Garder les rôles de compte explicites

Pour un paiement, le portefeuille émis est la source dans in.accountId. Un compte bancaire détenu par le client est le destinationId. Pour un compte bancaire émis, settlement.accountId est le portefeuille émis qui reçoit les dépôts appariés. Ensuite, utilisez un compte prêt dans Recevoir des fonds, Envoyer des fonds, ou Émettre un compte bancaire.