Zum Hauptinhalt springen
Verwenden Sie ein ausgegebenes Bankkonto, wenn der Kunde wiederverwendbare Bankdaten benötigt. Für einmalige, an einen bestimmten Betrag gebundene Finanzierungsanweisungen verwenden Sie stattdessen Gelder empfangen.

​
Bevor Sie beginnen

Sie benötigen eine Kunden-ID, eine bereite Bank-Fähigkeit für die beabsichtigte Methode und Währung sowie eine bereite ausgegebene Wallet, die demselben Kunden gehört. Mit allowPending können Sie die Anfrage speichern, während die ausgewählte Bank den Kunden noch prüft. Erledigen Sie offene Arbeit über Fähigkeiten und Aufgaben.

​
1. Settlement-Wallet anlegen oder auswählen

Legen Sie eine ausgegebene Wallet über Konten und Wallets an und lesen Sie sie dann erneut. Fahren Sie nur fort, wenn ihr aktueller Status Settlement erlaubt. Speichern Sie ihre aus der Antwort abgeleitete data.id als SETTLEMENT_WALLET_ID. Verwenden Sie keine externe Wallet für settlement.accountId.

​
2. Ausgegebenes Bankkonto anlegen

Verwenden Sie POST /v3/customers/{customerId}/accounts mit diesen Headern:
Request headers
Senden Sie diesen Request-Body:
Request body
Speichern Sie die zurückgegebene data.id als BANK_ACCOUNT_ID. Behalten Sie außerdem data.status, data.openTaskIds, data.details und die Settlement-Beziehung. Optionale Anfragefelder:

​
Bank auswählen

Senden Sie institution, wenn der Kunde Bankdaten von einer bestimmten Bank benötigt. Swipelux reserviert ein ausgegebenes Konto pro Kunde, Methode, Währung und Institution. Eine Anfrage ohne institution gibt 409 conflict zurück, wenn der Kunde bereits bei einer beliebigen Bank ein ausgegebenes Konto für diese Methode und Währung hat. Eine Anfrage mit institution gibt 409 conflict nur zurück, wenn für diese Bank bereits ein Konto existiert. Kontolesungen geben die ausgewählte Bank als institution mit id, name und bic zurück. bic kann null sein. Die Idempotenz bezieht sich auf die ausgewählte Bank. Das erneute Senden derselben Anfrage gibt das ursprüngliche Konto zurück. Eine Änderung von institution unter demselben Idempotency-Key gibt 409 idempotency_conflict zurück.

​
Anfrage vor der Bankgenehmigung speichern

Standardmäßig akzeptiert Swipelux eine Anfrage für ein ausgegebenes Bankkonto erst, wenn die Bank-Fähigkeit bereit ist. Um die Kontoeinrichtung des Kunden früher zu erfassen, senden Sie allowPending: true zusammen mit institution:
Request body with allowPending
Solange der Antrag bei der Bank geprüft wird, gibt das Konto status: "in_review" zurück, wobei statusReason.code auf waiting_for_approval gesetzt ist. Die Antwort enthält außerdem applicationId und die openTaskIds des Antrags. Erledigen Sie diese Aufgaben über Fähigkeiten und Aufgaben. Die gespeicherte Anfrage behält ihre Konto-ID, ihre Settlement-Wallet und ihren Konto-Slot. Sobald Antrag und Fähigkeit bereit sind, stellt Swipelux die Bankdaten unter derselben BANK_ACCOUNT_ID bereit. Lesen Sie weiterhin diese ID. Erstellen Sie keine weitere Anfrage. Solange die gespeicherte Anfrage wartet, belegt sie den Konto-Slot. Eine weitere allowPending-Anfrage für denselben Slot mit einem anderen Idempotency-Key gibt 409 conflict zurück. Das Feld holder.accountId des Problems nennt das wartende Konto. Lesen Sie dieses Konto, anstatt es erneut zu versuchen. Wenn der Antrag zuvor abgelehnt, storniert oder archiviert wird, wechselt das Konto zu rejected. Es belegt dann keinen Konto-Slot mehr.

​
Settlement-Währung auswählen

Standardmäßig werden Einzahlungen in der Währung der Settlement-Wallet abgewickelt. Setzen Sie settlement.currency auf USDC oder USDT, um das gelieferte Asset unabhängig von der Währung der Wallet zu wählen:
Request body with settlement currency
USDT erfordert ein USD-Konto und eine Settlement-Wallet auf einem Netzwerk, das die Lieferung von USDT unterstützt. Andernfalls gibt die Anfrage 400 invalid_settlement_target zurück. Kontolesungen geben die gespeicherte Auswahl zurück, auch während das Konto bereitgestellt wird. Die Bankkonto-ID und die Wallet-ID haben unterschiedliche Rollen. Lesen Sie Bereitstellung und Bankdaten über die Bankkonto-ID. Verwenden Sie die Settlement-Wallet-ID, um zu kennzeichnen, wohin Einzahlungen gutgeschrieben werden.

​
3. Bereitstellung überwachen

Lesen Sie GET /v3/customers/{customerId}/accounts/{accountId} nach der Erstellung und nach jedem relevanten Webhook. Halten Sie die Kundenoberfläche im Wartezustand, solange details fehlt. Wenn openTaskIds nicht leer ist, erledigen Sie die neuesten Aufgaben und rufen Sie das Konto erneut ab. Leiten Sie die Bereitschaft nicht aus verstrichener Zeit ab. Wenn das Konto mit allowPending: true gespeichert wurde, bleibt es im Status in_review mit statusReason.code gleich waiting_for_approval, bis die Bank den Antrag genehmigt. Wenn der neueste statusReason.code gleich awaiting_assignment ist, erstellen Sie das erste Pay-in für denselben Kunden, dieselbe Fähigkeit und dieselbe Settlement-Wallet über Gelder empfangen und lesen Sie das Bankkonto anschließend erneut. Folgen Sie diesem Zweig nur, wenn das aktuelle Konto es verlangt.

​
4. Bankdaten sicher präsentieren

Zeigen Sie nur die vollständigen Details an, die von der neuesten Kontenlesung zurückgegeben wurden. Wenn details.referenceRequired true ist, zeigen Sie die genaue details.reference an und machen Sie sie kopierbar. Wenn sie false ist, erfinden Sie keine Referenz. Zeigen Sie bei ausgegebenen swift-Konten details.bankName, details.swiftCode (die BIC der empfangenden Bank), details.accountNumber, details.accountHolderName und details.accountHolderAddress an, sofern sie zurückgegeben werden. Absender müssen die Begünstigtenadresse exakt in die internationale Überweisung übernehmen. Zeigen Sie außerdem details.bankAddress und alle Felder zu zwischengeschalteten Banken an, die das Konto zurückgibt. Diese Bankdaten sind wiederverwendbar. Ersetzen Sie sie nicht durch Finanzierungskoordinaten aus einem quotierten Pay-in, die nur zu diesem Transfer gehören. Fügen Sie als Nächstes Webhooks hinzu, damit Bereitstellungs-Updates Ihre Anwendung erreichen, ohne den Kunden auf einem Polling-Bildschirm zu halten.