Comptes i carteres

Cada compte pertany a un client. Escull-lo utilitzant dues dimensions: qui el gestiona i si és una cartera o un compte bancari.

Escull un compte

Compte	Utilitza’l per
Cartera emesa	Mantenir un saldo custodial en stablecoin, finançar un pagament, rebre un cobrament o liquidar un compte bancari emès.
Compte bancari emès	Donar al client dades bancàries reutilitzables que liquiden en una cartera emesa.
Cartera externa	Registrar una adreça de blockchain propietat del client.
Compte bancari extern	Registrar un compte bancari propietat del client per a un pagament propi.

issued significa que Swipelux crea i gestiona el recurs. external registra un punt final propietat del client. Un punt final de tercers pertany a un destinatari i destinació, no a la llista de comptes del client.

Crea el compte

Utilitza POST /v3/customers/{customerId}/accounts. Envia aquestes capçaleres amb un dels cossos de sol·licitud següents:

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

Cartera emesa
Compte bancari emès
Cartera externa
Compte bancari extern

{
  "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"
}

Utilitza només monedes, xarxes, mètodes i tipus de compte retornats per al client i la capacitat actuals. No copiïs la disponibilitat d’un altre client o entorn.

Espera que el compte sigui utilitzable

Emmagatzema data.id, data.status i data.openTaskIds de la resposta de creació. Llegeix l’últim compte amb GET /v3/customers/{customerId}/accounts/{accountId} abans de cotitzar una transferència o mostrar dades bancàries. Utilitza el compte només quan el seu estat actual permeti la següent operació. Si hi ha IDs de tasca oberts, completa’ls mitjançant Capacitats i tasques. Un compte bancari emès pot retornar details: null mentre es provisiona. Presenta les dades bancàries només després que una lectura actual retorni el conjunt complet. Si details.referenceRequired és true, mostra la details.reference exacta amb les coordenades bancàries.

Manté els rols de compte explícits

Per a un pagament, la cartera emesa és l’origen a in.accountId. Un compte bancari propietat del client és el destinationId. Per a un compte bancari emès, settlement.accountId és la cartera emesa que rep els dipòsits coincidents. A continuació, utilitza un compte preparat a Rebre fons, Enviar fons o Emetre un compte bancari.

Comença aquí

Incorpora clients

Construeix fluxos de diners

Llança

Comptes i carteres

Escull un compte

Crea el compte

Espera que el compte sigui utilitzable

Manté els rols de compte explícits

​Escull un compte

​Crea el compte

​Espera que el compte sigui utilitzable

​Manté els rols de compte explícits

Escull un compte

Crea el compte

Espera que el compte sigui utilitzable

Manté els rols de compte explícits