Accounts en wallets

Elke rekening hoort bij één klant. Kies deze aan de hand van twee dimensies: wie hem beheert en of het een wallet of bankrekening is. Bewerkingen om klantaccounts te tonen, maken, lezen, bij te werken en te archiveren vallen onder /v3/customers/{customerId}/accounts; bewerkingen voor één account voegen /{accountId} toe. Er is geen reverse lookup van accountId naar customerId. Bewaar de customerId bij elke accountId, zodat latere requests het account kunnen adresseren.

Kies een rekening

Rekening	Gebruik het voor
Uitgegeven wallet	Een custodial stablecoinsaldo aanhouden, een uitbetaling financieren, een pay-in ontvangen of een uitgegeven bankrekening afwikkelen.
Uitgegeven bankrekening	De klant herbruikbare bankgegevens geven die naar een uitgegeven wallet worden afgewikkeld.
Externe wallet	Een blockchain-adres registreren dat in bezit is van de klant.
Externe bankrekening	Een bankrekening registreren in bezit van de klant voor een first-party uitbetaling.

issued betekent dat Swipelux de resource aanmaakt en beheert. external registreert een eindpunt in bezit van de klant. Een derde-partij-eindpunt hoort onder een recipient en destination, niet onder de klantrekeningenlijst. Maak voor die klant een Polygon-wallet aan voordat je de First pay-in-wizard in het merchantpanel voor kaarten of Apple Pay start. De wizard biedt alleen die Polygon-wallet aan en kan zonder deze wallet niet doorgaan. Deze voorwaarde geldt voor de wizard in het merchantpanel; directe API-integraties mogen alleen valuta’s, netwerken, methoden en rekeningtypen gebruiken die voor de huidige klant en mogelijkheid worden geretourneerd.

Maak de rekening aan

Gebruik POST /v3/customers/{customerId}/accounts. Verstuur deze headers met een van de onderstaande request bodies:

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

Uitgegeven wallet
Uitgegeven bankrekening
Externe wallet
Externe bankrekening

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

Gebruik alleen valuta’s, netwerken, methoden en accounttypes die zijn geretourneerd voor de huidige klant en capability. Kopieer geen beschikbaarheid van een andere klant of omgeving.

Wacht tot de rekening bruikbaar is

Bewaar data.id, data.status en data.openTaskIds uit de create-respons. Lees de nieuwste rekening met GET /v3/customers/{customerId}/accounts/{accountId} voordat je een transfer quoteert of bankgegevens toont. Gebruik de rekening alleen wanneer de huidige status de volgende operation toestaat. Als er task-ID’s open zijn, voltooi je die via Capabilities en tasks. Een uitgegeven bankrekening kan details: null retourneren tijdens de provisioning. Toon bankgegevens pas nadat een huidige lees de volledige set retourneert. Als details.referenceRequired true is, toon je de exacte details.reference met de bankcoördinaten.

Houd rekeningrollen expliciet

Voor een uitbetaling is de uitgegeven wallet de bron in in.accountId. Een bankrekening in bezit van de klant is de destinationId. Voor een uitgegeven bankrekening is settlement.accountId de uitgegeven wallet die gematchte stortingen ontvangt. Gebruik vervolgens een ready rekening in Geld ontvangen, Geld versturen of Een bankrekening uitgeven.

Aan de slag

Klanten onboarden

Geldstromen bouwen

Live gaan

Accounts en wallets

Kies een rekening

Maak de rekening aan

Wacht tot de rekening bruikbaar is

Houd rekeningrollen expliciet

​Kies een rekening

​Maak de rekening aan

​Wacht tot de rekening bruikbaar is

​Houd rekeningrollen expliciet

Kies een rekening

Maak de rekening aan

Wacht tot de rekening bruikbaar is

Houd rekeningrollen expliciet