Konten und Wallets

Jedes Konto gehört zu einem Kunden. Wählen Sie es anhand zweier Dimensionen aus: wer es verwaltet und ob es eine Wallet oder ein Bankkonto ist.

Ein Konto wählen

Konto	Verwenden für
Ausgegebene Wallet	Verwahrten Stablecoin-Bestand halten, einen Payout finanzieren, ein Pay-in empfangen oder ein ausgegebenes Bankkonto abwickeln.
Ausgegebenes Bankkonto	Dem Kunden wiederverwendbare Bankdaten geben, die in eine ausgegebene Wallet abgewickelt werden.
Externe Wallet	Eine Blockchain-Adresse aufzeichnen, die dem Kunden gehört.
Externes Bankkonto	Ein Bankkonto aufzeichnen, das dem Kunden für einen Erstpartei-Payout gehört.

issued bedeutet, dass Swipelux die Ressource anlegt und verwaltet. external zeichnet einen Endpunkt auf, der dem Kunden gehört. Ein Drittparteien-Endpunkt gehört unter einen Empfänger und Ziel, nicht in die Kontenliste des Kunden.

Das Konto anlegen

Verwenden Sie POST /v3/customers/{customerId}/accounts. Senden Sie diese Header mit einem der unten stehenden Request-Bodies:

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

Ausgegebene Wallet
Ausgegebenes Bankkonto
Externe Wallet
Externes 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"
}

Verwenden Sie nur Währungen, Netzwerke, Methoden und Kontotypen, die für den aktuellen Kunden und die Fähigkeit zurückgegeben wurden. Kopieren Sie die Verfügbarkeit nicht von einem anderen Kunden oder aus einer anderen Umgebung.

Warten, bis das Konto nutzbar ist

Speichern Sie data.id, data.status und data.openTaskIds aus der Erstellungs-Antwort. Lesen Sie das aktuelle Konto mit GET /v3/customers/{customerId}/accounts/{accountId}, bevor Sie einen Transfer quotieren oder Bankdaten anzeigen. Verwenden Sie das Konto nur, wenn sein aktueller Status die nächste Operation zulässt. Wenn Aufgaben-IDs offen sind, erledigen Sie sie über Fähigkeiten und Aufgaben. Ein ausgegebenes Bankkonto kann während der Bereitstellung details: null zurückgeben. Zeigen Sie Bankdaten erst an, nachdem eine aktuelle Leseoperation den vollständigen Satz zurückgibt. Wenn details.referenceRequired true ist, zeigen Sie die genaue details.reference mit den Bankkoordinaten an.

Kontenrollen explizit halten

Für einen Payout ist die ausgegebene Wallet die Quelle in in.accountId. Ein kundeneigenes Bankkonto ist die destinationId. Für ein ausgegebenes Bankkonto ist settlement.accountId die ausgegebene Wallet, die passende Einzahlungen empfängt. Verwenden Sie als Nächstes ein bereites Konto in Gelder empfangen, Gelder senden oder Bankkonto ausgeben.

Erste Schritte

Kunden onboarden

Geldflüsse aufbauen

Livegang

Konten und Wallets

Ein Konto wählen

Das Konto anlegen

Warten, bis das Konto nutzbar ist

Kontenrollen explizit halten

​Ein Konto wählen

​Das Konto anlegen

​Warten, bis das Konto nutzbar ist

​Kontenrollen explizit halten

Ein Konto wählen

Das Konto anlegen

Warten, bis das Konto nutzbar ist

Kontenrollen explizit halten