Voordat je begint
Je hebt een klant-ID, een ready bank-capability voor de beoogde methode en valuta en een ready uitgegeven wallet in bezit van dezelfde klant nodig. Voltooi open werk via Capabilities en tasks.1. Maak of selecteer de settlement-wallet
Maak een uitgegeven wallet via Accounts en wallets en lees hem daarna opnieuw. Ga alleen verder wanneer de huidige status settlement toestaat. Bewaar dedata.id uit de respons als SETTLEMENT_WALLET_ID. Gebruik geen externe wallet voor settlement.accountId.
2. Maak de uitgegeven bankrekening
GebruikPOST /v3/customers/{customerId}/accounts met deze headers:
data.id als BANK_ACCOUNT_ID. Behoud ook data.status, data.openTaskIds, data.details en de settlement-relatie.
De bankrekening-ID en wallet-ID hebben verschillende rollen. Lees provisioning en bankgegevens via de bankrekening-ID. Gebruik de settlement-wallet-ID om aan te geven waar stortingen worden gecrediteerd.
3. Monitor de provisioning
LeesGET /v3/customers/{customerId}/accounts/{accountId} na het aanmaken en na elke relevante webhook.
Houd de klantinterface in behandeling terwijl details afwezig is. Als openTaskIds niet leeg is, voltooi je de nieuwste taken en refetch je de rekening. Leid readiness niet af uit verstreken tijd.
Als de nieuwste statusReason.code gelijk is aan awaiting_assignment, maak dan de eerste pay-in aan voor dezelfde klant, capability en settlement-wallet via Geld ontvangen en lees de bankrekening daarna opnieuw. Volg deze branch alleen wanneer de huidige rekening erom vraagt.
4. Toon bankgegevens veilig
Toon alleen de volledige gegevens die de nieuwste rekeninglees retourneert. Wanneerdetails.referenceRequired true is, toon je de exacte details.reference en maak je die kopieerbaar. Wanneer die false is, verzin je geen referentie.
Deze bankgegevens zijn herbruikbaar. Vervang ze niet door funding-coördinaten van een gequote pay-in, die alleen bij die transfer horen.
Voeg vervolgens Webhooks toe zodat provisioning-updates je applicatie bereiken zonder de klant op een polling-scherm te houden.