Prima di iniziare
Hai bisogno di un ID cliente, una capability bancaria ready per il metodo e la valuta desiderati e un wallet emesso ready di proprieta’ dello stesso cliente. Completa il lavoro aperto tramite Capability e task.1. Crea o seleziona il wallet di regolamento
Crea un wallet emesso tramite Conti e wallet, poi rileggilo. Prosegui solo quando il suo stato corrente consente il regolamento. Salva il suodata.id derivato dalla risposta come SETTLEMENT_WALLET_ID. Non usare un wallet esterno per settlement.accountId.
2. Crea il conto bancario emesso
UsaPOST /v3/customers/{customerId}/accounts con questi header:
data.id restituito come BANK_ACCOUNT_ID. Conserva anche data.status, data.openTaskIds, data.details e la relazione di settlement.
L’ID del conto bancario e l’ID del wallet hanno ruoli diversi. Leggi il provisioning e i dettagli bancari tramite l’ID del conto bancario. Usa l’ID del wallet di settlement per identificare dove vengono accreditati i depositi.
3. Monitora il provisioning
LeggiGET /v3/customers/{customerId}/accounts/{accountId} dopo la creazione e dopo ogni webhook rilevante.
Mantieni l’interfaccia cliente in stato pending finche’ details e’ assente. Se openTaskIds non e’ vuoto, completa gli ultimi task e rileggi il conto. Non dedurre la readiness dal tempo trascorso.
Se l’ultimo statusReason.code e’ awaiting_assignment, crea il primo pay-in per lo stesso cliente, capability e wallet di settlement tramite Ricevi fondi, poi rileggi il conto bancario. Segui questo ramo solo quando il conto corrente lo richiede.
4. Presenta i dettagli bancari in sicurezza
Mostra solo i dettagli completi restituiti dall’ultima lettura del conto. Quandodetails.referenceRequired e’ true, mostra l’esatto details.reference e rendilo copiabile. Quando e’ false, non inventare un reference.
Questi dettagli bancari sono riutilizzabili. Non sostituirli con coordinate di finanziamento di un pay-in con quote, che appartengono solo a quel transfer.
Successivamente, aggiungi i Webhook in modo che gli aggiornamenti di provisioning raggiungano la tua applicazione senza tenere il cliente su una schermata di polling.