Kontoer og lommebøker

Hver konto tilhører én kunde. Velg den ut fra to dimensjoner: hvem som administrerer den og om det er en lommebok eller bankkonto.

Velg en konto

Konto	Bruk den til
Utstedt lommebok	Ha en depotforvaltet stablecoin-saldo, finansiere en payout, motta en pay-in eller gjøre opp en utstedt bankkonto.
Utstedt bankkonto	Gi kunden gjenbrukbare bankopplysninger som gjøres opp til en utstedt lommebok.
Ekstern lommebok	Registrer en blokkjedeadresse eid av kunden.
Ekstern bankkonto	Registrer en bankkonto eid av kunden for en førsteparts payout.

issued betyr at Swipelux oppretter og administrerer ressursen. external registrerer et endepunkt eid av kunden. Et tredjepartsendepunkt hører under mottaker og destinasjon, ikke under kundens kontoliste.

Opprett kontoen

Bruk POST /v3/customers/{customerId}/accounts. Send disse headerne sammen med én av forespørsel-bodyene nedenfor:

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

Utstedt lommebok
Utstedt bankkonto
Ekstern lommebok
Ekstern bankkonto

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

Bruk kun valutaer, nettverk, metoder og kontotyper som returneres for gjeldende kunde og capability. Ikke kopier tilgjengelighet fra en annen kunde eller et annet miljø.

Vent på at kontoen er klar til bruk

Lagre data.id, data.status og data.openTaskIds fra create-responsen. Les den nyeste kontoen med GET /v3/customers/{customerId}/accounts/{accountId} før du priser en overføring eller viser bankopplysninger. Bruk kontoen kun når gjeldende status tillater neste operasjon. Hvis oppgave-ID-er er åpne, fullfør dem via Capabilities og oppgaver. En utstedt bankkonto kan returnere details: null under provisjonering. Presenter bankopplysninger først etter at en gjeldende lesing returnerer det komplette settet. Hvis details.referenceRequired er true, vis den nøyaktige details.reference sammen med bankkoordinatene.

Hold kontorollene eksplisitte

For en payout er den utstedte lommeboken kilden i in.accountId. En kundeeid bankkonto er destinationId. For en utstedt bankkonto er settlement.accountId den utstedte lommeboken som mottar samsvarende innskudd. Deretter, bruk en klar konto i Motta midler, Send midler eller Utsted en bankkonto.

Kom i gang

Kundeombording

Bygg pengestrømmer

Lansering

Kontoer og lommebøker

Velg en konto

Opprett kontoen

Vent på at kontoen er klar til bruk

Hold kontorollene eksplisitte

​Velg en konto

​Opprett kontoen

​Vent på at kontoen er klar til bruk

​Hold kontorollene eksplisitte

Velg en konto

Opprett kontoen

Vent på at kontoen er klar til bruk

Hold kontorollene eksplisitte