Comptes et portefeuilles

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.

Choisir un compte

Compte	À utiliser pour
Portefeuille émis	Détenir un solde de stablecoin sous garde, financer un paiement, recevoir un encaissement ou régler un compte bancaire émis.
Compte bancaire émis	Fournir au client des coordonnées bancaires réutilisables qui règlent dans un portefeuille émis.
Portefeuille externe	Enregistrer une adresse blockchain détenue par le client.
Compte bancaire externe	Enregistrer un compte bancaire détenu par le client pour un paiement propre.

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.

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 :

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: account-create-001
Content-Type: application/json

Portefeuille émis
Compte bancaire émis
Portefeuille externe
Compte bancaire externe

{
  "origin": "issued",
  "type": "wallet",
  "currency": "USDC",
  "network": "base",
  "label": "Settlement wallet"
}

{
  "origin": "issued",
  "type": "bank",
  "method": "ach",
  "country": "US",
  "currency": "USD",
  "settlement": {
    "accountId": "${SETTLEMENT_WALLET_ID}"
  },
  "label": "USD account"
}

{
  "origin": "external",
  "type": "wallet",
  "currency": "USDC",
  "network": "polygon",
  "details": {
    "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
  },
  "label": "Customer Polygon wallet"
}

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

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.

Commencer

Intégrer les clients

Construire les flux monétaires

Mise en production

Comptes et portefeuilles

Choisir un compte

Créer le compte

Attendre que le compte soit utilisable

Garder les rôles de compte explicites

​Choisir un compte

​Créer le compte

​Attendre que le compte soit utilisable

​Garder les rôles de compte explicites

Choisir un compte

Créer le compte

Attendre que le compte soit utilisable

Garder les rôles de compte explicites