Siirry pääsisältöön
Käytä luotua pankkitiliä, kun asiakas tarvitsee uudelleenkäytettävät pankkitilitiedot. Kertaluontoisia rahoitusohjeita varten, jotka on sidottu tiettyyn summaan, käytä sen sijaan kohtaa Vastaanota varoja.

​
Ennen kuin aloitat

Tarvitset asiakas-ID:n, valmiin pankkikyvyn aiotulle menetelmälle ja valuutalle sekä valmiin luodun lompakon, jonka omistaa sama asiakas. allowPending-kentällä voit tallentaa pyynnön, kun valittu pankki vielä tarkistaa asiakasta. Suorita avoin työ Kyvyt ja tehtävät -kautta.

​
1. Luo tai valitse selvityslompakko

Luo luotu lompakko Tilit ja lompakot -kautta, lue se sitten uudelleen. Jatka vain, kun sen nykyinen tila sallii selvityksen. Tallenna sen vastauksesta johdettu data.id muuttujaan SETTLEMENT_WALLET_ID. Älä käytä ulkoista lompakkoa settlement.accountId-kenttänä.

​
2. Luo luotu pankkitili

Käytä POST /v3/customers/{customerId}/accounts -toimintoa näillä otsakkeilla:
Request headers
Lähetä tämä pyyntörunko:
Request body
Tallenna palautettu data.id muuttujaan BANK_ACCOUNT_ID. Säilytä myös data.status, data.openTaskIds, data.details ja selvityssuhde. Valinnaiset pyyntökentät:

​
Valitse pankki

Lähetä institution, kun asiakas tarvitsee pankkitilitiedot tietystä pankista. Swipelux varaa yhden luodun tilin asiakasta, menetelmää, valuuttaa ja laitosta kohden. Pyyntö ilman institution-kenttää palauttaa 409 conflict -virheen, jos asiakkaalla on jo luotu tili kyseiselle menetelmälle ja valuutalle missä tahansa pankissa. Pyyntö, jossa on institution-kenttä, palauttaa 409 conflict -virheen vain, jos kyseiselle pankille on jo olemassa tili. Tilin lukemiset palauttavat valitun pankin institution-kenttänä, jossa on id, name ja bic. bic voi olla null. Idempotenssi koskee valittua pankkia. Saman pyynnön toistaminen palauttaa alkuperäisen tilin. institution-kentän muuttaminen saman Idempotency-Key-arvon alla palauttaa 409 idempotency_conflict -virheen.

​
Tallenna pyyntö ennen pankin hyväksyntää

Oletuksena Swipelux hyväksyy luodun pankkitilin pyynnön vasta, kun pankkikyky on valmis. Jos haluat kerätä asiakkaan tilin asetukset aiemmin, lähetä allowPending: true yhdessä institution-kentän kanssa:
Request body with allowPending
Kun pankin hakemus on tarkistettavana, tili palauttaa status: "in_review" -arvon, ja statusReason.code on waiting_for_approval. Vastaus sisältää myös applicationId-kentän ja hakemuksen openTaskIds-arvot. Suorita nämä tehtävät Kyvyt ja tehtävät -kautta. Tallennettu pyyntö säilyttää tili-ID:nsä, selvityslompakkonsa ja tilipaikkansa. Kun hakemus ja kyky ovat valmiita, Swipelux valmistelee pankkitilitiedot saman BANK_ACCOUNT_ID-tunnisteen alle. Jatka kyseisen ID:n lukemista. Älä luo uutta pyyntöä. Kun tallennettu pyyntö odottaa, se varaa tilipaikan. Toinen allowPending-pyyntö samalle paikalle eri Idempotency-Key-avaimella palauttaa 409 conflict. Ongelman holder.accountId nimeää odottavan tilin. Lue kyseinen tili sen sijaan, että yrität uudelleen. Jos hakemus hylätään, peruutetaan tai arkistoidaan ensin, tilin tilaksi tulee rejected. Se ei enää varaa tilipaikkaa.

​
Valitse selvitysvaluutta

Oletuksena talletukset selvitetään selvityslompakon valuutassa. Aseta settlement.currency arvoon USDC tai USDT, jos haluat valita toimitettavan omaisuuserän lompakon valuutasta riippumatta:
Request body with settlement currency
USDT vaatii USD-tilin ja selvityslompakon verkossa, joka tukee USDT-toimitusta. Muuten pyyntö palauttaa 400 invalid_settlement_target -virheen. Tilin lukemiset palauttavat tallennetun valinnan myös silloin, kun tiliä vielä valmistellaan. Pankkitili-ID:llä ja lompakko-ID:llä on eri roolit. Lue valmistelu ja pankkitilitiedot pankkitili-ID:n kautta. Käytä selvityslompakon ID:tä tunnistamaan, minne talletukset hyvitetään.

​
3. Seuraa valmistelua

Lue GET /v3/customers/{customerId}/accounts/{accountId} luonnin jälkeen ja jokaisen asiaankuuluvan webhookin jälkeen. Pidä asiakasliittymä odottavana, kun details puuttuu. Jos openTaskIds ei ole tyhjä, suorita uusimmat tehtävät ja hae tili uudelleen. Älä päättele valmiutta kuluneesta ajasta. Jos tili tallennettiin allowPending: true -arvolla, se pysyy tilassa in_review ja statusReason.code on waiting_for_approval, kunnes pankki hyväksyy hakemuksen. Jos uusin statusReason.code on awaiting_assignment, luo ensimmäinen maksun vastaanotto samalle asiakkaalle, kyvylle ja selvityslompakolle Vastaanota varoja -kautta, lue sitten pankkitili uudelleen. Seuraa tätä haaraa vain, kun nykyinen tili pyytää sitä.

​
4. Esitä pankkitilitiedot turvallisesti

Näytä vain täydelliset tiedot, jotka palautettiin uusimmasta tilin lukemisesta. Kun details.referenceRequired on true, näytä tarkka details.reference ja tee siitä kopioitava. Kun se on false, älä keksi viitettä. Luoduille swift-tileille näytä details.bankName, details.swiftCode (vastaanottavan pankin BIC), details.accountNumber, details.accountHolderName ja details.accountHolderAddress, kun ne palautetaan. Lähettäjien on kopioitava edunsaajan osoite täsmälleen kansainväliseen tilisiirtoon. Näytä myös details.bankAddress ja kaikki välittäjäpankin kentät, jotka tili palauttaa. Nämä pankkitilitiedot ovat uudelleenkäytettäviä. Älä korvaa niitä tarjottuun maksun vastaanottoon liittyvillä rahoituskoordinaateilla, jotka kuuluvat vain kyseiseen siirtoon. Seuraavaksi lisää webhookit, jotta valmisteluun liittyvät päivitykset saavuttavat sovelluksesi ilman, että pidät asiakasta pollausnäytöllä.