Abans de començar
Necessites una capacitat de cobrament preparada i una cartera de destinació emesa preparada per al mateix client. Completa qualsevol treball obert mitjançant Capacitats i tasques, i després torna a obtenir els dos recursos.1. Crea una cotització
Crea el preu ambPOST /v3/quotes. Envia aquestes capçaleres:
data.id com a QUOTE_ID. Presenta els imports i les comissions retornats en lloc de reconstruir-los a partir de la taxa.
2. Executa la cotització
Executa la cotització actual abans que expiri ambPOST /v3/transfers. Utilitza una nova clau per a aquesta transferència prevista:
data.id de la transferència com a TRANSFER_ID i conserva el seu estat actual.
3. Recupera les instruccions de finançament
LlegeixGET /v3/transfers/{transferId}/instructions. Renderitza la variant data.instructions retornada sense assumir el seu tipus.
Aquests detalls són específics de la transferència. No reutilitzis mai les coordenades bancàries, el codi, la URL allotjada, l’import, la referència o la data de caducitat d’una transferència per a un altre cobrament.
Per a instruccions bancàries, quan reference.required és true, mostra el reference.value exacte al costat de les coordenades bancàries i fes-lo copiable. Mostra l’import i la moneda retornats del mateix conjunt d’instruccions.
Un compte bancari emès és diferent: proporciona dades reutilitzables per a dipòsits posteriors. Consulta Emet un compte bancari quan aquesta sigui l’experiència prevista.
4. Fes el seguiment de la liquidació
LlegeixGET /v3/transfers/{transferId} després de l’execució i després de cada esdeveniment. Impulsa l’estat mostrat al client a partir de l’últim data.state.
Utilitza data.stateDetail i data.openTaskIds quan la transferència necessiti una altra acció. No la marquis com a completada a partir d’un calendari previst.
A continuació, afegeix Webhooks i manté l’estat de la transferència sincronitzat fins que arribi a un resultat que el teu producte gestioni.