Abans de començar
Necessites un ID de client, una capacitat bancària preparada per al mètode i moneda previstos, i una cartera emesa preparada propietat del mateix client. Completa el treball obert mitjançant Capacitats i tasques.1. Crea o selecciona la cartera de liquidació
Crea una cartera emesa mitjançant Comptes i carteres, i després torna a llegir-la. Continua només quan el seu estat actual permeti la liquidació. Emmagatzema el seudata.id derivat de la resposta com a SETTLEMENT_WALLET_ID. No utilitzis una cartera externa per a settlement.accountId.
2. Crea el compte bancari emès
UtilitzaPOST /v3/customers/{customerId}/accounts amb aquestes capçaleres:
data.id retornat com a BANK_ACCOUNT_ID. Conserva també data.status, data.openTaskIds, data.details i la relació de liquidació.
L’ID del compte bancari i l’ID de la cartera tenen rols diferents. Llegeix el provisionament i les dades bancàries a través de l’ID del compte bancari. Utilitza l’ID de la cartera de liquidació per identificar on s’acrediten els dipòsits.
3. Monitoritza el provisionament
LlegeixGET /v3/customers/{customerId}/accounts/{accountId} després de la creació i després de cada webhook rellevant.
Manté la interfície del client pendent mentre details estigui absent. Si openTaskIds no està buit, completa les tasques més recents i torna a obtenir el compte. No infereixis la preparació a partir del temps transcorregut.
Si l’últim statusReason.code és awaiting_assignment, crea el primer cobrament per al mateix client, capacitat i cartera de liquidació mitjançant Rebre fons, i després torna a llegir el compte bancari. Segueix aquesta branca només quan el compte actual ho sol·liciti.
4. Presenta les dades bancàries de manera segura
Mostra només les dades completes retornades per l’última lectura del compte. Quandetails.referenceRequired és true, mostra la details.reference exacta i fes-la copiable. Quan és false, no inventis una referència.
Aquestes dades bancàries són reutilitzables. No les substitueixis per coordenades de finançament d’un cobrament cotitzat, que pertanyen només a aquesta transferència.
A continuació, afegeix Webhooks perquè les actualitzacions de provisionament arribin a la teva aplicació sense mantenir el client en una pantalla de sondeig.