Swipelux API:n muutosloki ja julkaisutiedot

​

Lisätty

• Vastaanottajan kohteet hyväksyvät tyypit pix ja pix_safe BRL-määräisiin maksuihin ulos Brasiliassa. Pix-kohde maksaa Pix-avaimeen. Pix Safe -kohde maksaa pankkitilille, joka yksilöidään tilinhaltijan CPF- tai CNPJ-numerolla, pankin ISPB-koodilla, konttorilla ja tilinumerolla. Molemmat edellyttävät asiakkaan valmista Pix-ominaisuutta (pix_pooled), ja niiden maksut ulos rahoitetaan USDC:llä eikä niihin sisälly kehittäjämaksua. Katso Vastaanottajat ja Lähetä varoja.
• GET /v3/customers/{customerId}/tasks/{taskId} hyväksyy parametrin documentCandidatesFor asiakirjavaatimuksen tunnisteella sekä parametrin documentAlternativeKey vaatimukselle, jolla on vaihtoehtoja. Tällöin vastaus listaa kentässä data.documentCandidates tiedostot, jotka asiakas on jo ladannut ja jotka voivat täyttää kyseisen vaatimuksen, sekä mahdolliset missingMetadata- tai conflictingMetadata-tiedot. Lähetä ehdokkaan documentId puuttuvien documentMetadata-tietojen kanssa sen sijaan, että lataisit tiedoston uudelleen. Kysely edellyttää oikeuksia accounts:read ja customers:read, ja virheellinen valinta palauttaa 400 validation_error -virheen.

​

Muutettu

• GET /v3/webhooks/portal palauttaa portaalin URLin, joka vanhenee tunnin kuluttua, otsakkeella Cache-Control: no-store. Kun API-avaimella on oikeus webhooks:write, portaali näyttää päätepisteen allekirjoitussalaisuuden ja sillä voi hallita päätepisteitä, uudelleenyrittää toimituksia ja toistaa niitä. Pelkällä oikeudella webhooks:read portaali näyttää vain toimitukset. Katso Webhookit.
• Citiä (citibank) tarjotaan vain yritysasiakkaille. Jokainen yritys säilyttää yhdistetyn Citin, ja nimettyä Citiä tarjotaan vain Yhdysvaltojen ulkopuolelle rekisteröidyille yrityksille. Kun asiakkaalle ei tarjota Citiä, tuettujen luettelo jättää sen pois, sen nimeäminen palauttaa 422 capability_institutions_unsupported -virheen ja menetelmä, jota vain Citi tarjoaa, näytetään tilassa disabled. Pyyntö ilman institutions-kenttää valitsee jäljellä olevista pankeista. Olemassa olevat hakemukset ja tilit pysyvät ennallaan.
• Nimettyjä CFSB-ominaisuuksia (cfsb) tarjotaan vain yhdysvaltalaisille asiakkaille: Yhdysvaltoihin rekisteröidyille yrityksille ja siellä asuville yksityishenkilöille. Muille asiakkaille tuettujen luettelo jättää nimetyn CFSB:n pois, ja sen nimeäminen palauttaa 422 capability_institutions_unsupported -virheen. Pyyntö ilman institutions-kenttää valitsee jäljellä olevista pankeista. Yhdistetty CFSB, asiakkaat, joiden maa on tuntematon, ja olemassa olevat hakemukset pysyvät ennallaan.
• Lead Bankin (lead_bank) nimettyjä ACH-, Wire- ja SWIFT-ominaisuuksia tarjotaan vain asiakkaille, jotka Lead Bank voi ottaa asiakkaakseen niiden oikeudellisen muodon ja maiden perusteella. Muille asiakkaille tuettujen luettelo jättää lead_bank-arvon pois, ja sen nimeäminen palauttaa 422 capability_institutions_unsupported -virheen. Asiakkaat, jotka Lead Bank on jo ottanut asiakkaakseen, ja ominaisuudet, joiden avoin pyyntö jo nimeää lead_bank-arvon, säilyttävät sen. Olemassa olevat hakemukset ja tilit pysyvät ennallaan.
• RTP on vain yhdistetty. Mikään pankki ei tarjoa rtp_named-ominaisuutta uusille pyynnöille, joten tuettujen luettelo näyttää sen tilassa disabled. Asiakkaalle, jolla ei ole rtp_named-ominaisuutta, sitä koskeva ominaisuuspyyntö tai tehtävien esikatselu palauttaa 422 capability_institutions_unsupported -virheen, jos se nimeää pankin, ja 422 capability_variant_unavailable -virheen, jos siinä ei ole institutions-kenttää. Yhdistettyä RTP:tä (rtp_pooled) tarjotaan Citissä, joten vain yritysasiakkaat voivat pyytää sitä.
• Uudet henkilöllisyysasiakirjapyynnöt yksityishenkilöille ja tosiasiallisille edunsaajille voivat asettaa constraints.identityMetadataRequired: true, jolloin jokainen tiedosto tarvitsee henkilötunnusnumeronsa ja myöntäjämaansa kenttään documentMetadata. Uudet yrityksen osoitetodistus- ja omistajan asuinpaikkatodistuspyynnöt voivat asettaa constraints.maxIssueAgeDays: 90, jolloin jokainen tiedosto tarvitsee myöntämispäivänsä. Olemassa olevat tehtävät säilyttävät vaatimuksensa, joten lue kunkin tehtäväpyynnön rajoitukset.
• Tehtävävastaus yrityksen rekisteröintipyyntöön, jonka profilePointer on /business/registration, tarvitsee yhdessä lainkäyttöalueen maan, rekisterinumeron ja lähetyspäivää edeltävän perustamispäivän. Pyynnön valueSchema julkaisee tämän säännön, ja osittainen vastaus palauttaa 400 validation_error -virheen.
• Isännöidyn vahvistuksen jälkeen Swipelux hyväksyy isännöidyn vastauksen rakenteista arvoa, kuten osoitetta tai verotunnisteita, koskevaan profiilivaatimukseen vain, jos se läpäisee samat skeema- ja rajoitustarkistukset kuin suora vastaus. Muuten vaatimus pysyy avoimena, ja lähetät arvon pyynnöllä POST /v3/customers/{customerId}/tasks/{taskId}/submissions. Vaatimus, jonka Swipelux palauttaa tästä syystä tilaan action_required, sisältää arvon reviewFeedback.code: hosted_profile_direct_submission_required. Tehtävät, jotka ovat jo tilassa satisfied, säilyttävät tilansa. Katso Ominaisuudet ja vaatimukset.
• Isännöidyn vahvistuksen hylkäämä tehtävä voi poistua tilasta rejected, kun kyseinen vahvistuspäätös myöhemmin kumotaan. Tällöin siitä tulee satisfied tai action_required uudella revision-arvolla, ja vaatimukset, joihin uusi päätös ei vastaa, avataan uudelleen. Näiden vaatimusten aiemmat lähetykset pysyvät tilassa rejected, joten lähetä vastaukset uudelleen. Katso Siirtyminen v3:een.
• Vastaanottajan kohteen type on nyt avoin enum. Tämän referenssin aiemmat versiot kuvasivat sen suljetuksi, joten päivitä kaikki asiakasohjelmat, jotka hylkäävät tai pudottavat tuntemattomia tyyppejä. Kohteiden vastaukset ja destination.status_changed-tapahtumat voivat nyt sisältää arvot pix ja pix_safe, ja tyyppejä voidaan lisätä.
• Vastaanottajien luonti- ja päivityspyynnöt, mukaan lukien sisäkkäinen address, ohittavat kentät, joita ne eivät määrittele, sen sijaan että palauttaisivat 400 validation_error -virheen. Luontipyynnössä toisen vastaanottajatyypin nimi- tai toimialakenttä palauttaa edelleen virheen 400, kuten myös type ja externalId pyynnössä PATCH /v3/customers/{customerId}/recipients/{recipientId}. PATCH, jossa ei ole yhtään sen tunnistamaa kenttää, palauttaa 400 validation_error -virheen eikä 200.
• Kelpoisen istunnon vahvistuslinkki, joka pyytää vain asiakirjoja, avaa nyt Swipeluxin isännöimän asiakirjojen latussivun. Itse linkki ei muutu, ja muut istunnot avaavat edelleen isännöidyn vahvistusprosessin.
• employment.occupation yksityisasiakkailla ja liittyvien osapuolten henkilöillä hyväksyy enintään 255 merkkiä.
• POST /v3/customers, PATCH /v3/customers/{customerId}, POST /v3/customers/{customerId}/related-parties, PATCH /v3/customers/{customerId}/related-parties/{relatedPartyId} ja POST /v3/customers/{customerId}/tasks/{taskId}/submissions palauttavat 400 validation_error, kun profiilin arvo tai tehtävän vastaus sisältää Swipelux-lomakelinkin, kuten RFI-, asiakaspyyntö- tai siirron seurantalinkin. Tämä ei koske kenttiä externalId tai metadata. Jokainen hylätty arvo näkyy kohdassa errors[] arvolla code: public_form_link ja omalla JSON Pointerillaan, eikä vastaus koskaan toista linkkiä. Lähetä sen sijaan itse tieto. Katso Virheet ja uudelleenyritykset.

​

Korjattu

• Maksu ulos -tarjousten ja -siirtojen vastaukset säilyttävät USDC- tai USDT-lähdesumman kuuden desimaalin tarkkuudella, esimerkiksi 4009.711365 eikä 4009.71. Fiat-summat säilyttävät kaksi desimaalia. Sellaisen maksun ulos luominen tai lukeminen, jonka stablecoin-lähdesummassa on yli kaksi desimaalia, ei enää palauta virhettä 500.
• POST /v3/customers/{customerId}/capabilities/{capabilityId}/cancel -referenssi kuvaa nyt peruutuksen sellaisena kuin se toimii. Voit perua ready-tilassa olevan ominaisuuden, stablecoin_transfers-ominaisuutta ei voi perua, ja peruminen päättää vain kyseisen ominaisuuden, kun taas sen hakemukset säilyttävät tilansa, tehtävänsä ja hyväksyntänsä.
• Ominaisuuspyyntö tai tehtävien esikatselu, joka listaa institutions-kentässä pankkikoodin julkisen laitostunnisteen sijaan, kuten citi eikä citibank, palauttaa 422 capability_institutions_unsupported -virheen, joka nimeää käytettävissä olevat tunnisteet, eikä 503 kyc_configuration_unavailable -virhettä.
• Ominaisuuspyyntö tai tehtävien esikatselu menetelmälle, jota mikään pankki ei tarjoa asiakkaalle ja jonka tuettujen luettelo näyttää tilassa disabled, palauttaa 422 capability_variant_unavailable -virheen arvolla retryable: false eikä 503 kyc_configuration_unavailable -virhettä, ellei asiakkaalla jo ole kyseistä ominaisuutta.
• documentCandidates ei enää listaa tiedostoja, jotka Swipelux säilyttää valmistuneesta isännöidystä vahvistuksesta ja joita et voi lukea tai ladata. Tehtävävastaus, joka viittaa sellaiseen tiedostoon, palauttaa 400 invalid_document_reference -virheen, kuten tuntematon asiakirja.

​

Lisätty

• GET /v3/customers hyväksyy parametrin include=documentRequirements. Tällöin jokainen asiakasyhteenveto kertoo, kuinka monta pakollista asiakirjaa on vielä toimittamatta, ominaisuuksien valmiudesta riippumatta. Yhdistä se muodossa include=capabilities,documentRequirements. Katso Asiakkaat.
• Kauppiaspaneelin Webhooks-sivulla päätepisteen valikkoon on lisätty Replay missed events. Se lähettää uudelleen viimeisten 13 päivän tapahtumat, joita päätepiste ei koskaan vastaanottanut, eikä lähetä samaa tapahtumaa koskaan kahdesti. Katso Webhookit.
• Kauppiaspaneelin Settings-sivulla on Compliance-osio. Omistajat ja ylläpitäjät voivat asettaa compliance-sähköpostiosoitteen ja valita, haluavatko he sähköposteja, kun Swipelux pyytää lisätietoja asiakkaasta.
• Kauppiaat voivat vastata omiin KYB-compliance-pyyntöihinsä suoraan kauppiaspaneelin KYB-sivulla.

​

Muutettu

• Asiakkaan ja liittyvän osapuolen päivitykset eivät enää palauta 409 field_conflicts_with_completed_intake -virhettä valmiin pankin vastaanoton jälkeen. Päivitys tallennetaan, ja jokainen uusi pankkihakemus tarkistaa uusimman profiilin omien vaatimustensa mukaan.
• Ominaisuuspyynnöt palauttavat 409 capability_route_header_conflict -virheen, kun ominaisuuden nykyistä pankkireititystä ei voida päivittää turvallisesti. Ota yhteyttä Swipelux-tukeen ennen uutta yritystä.
• GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview palauttaa 422 capability_institutions_unsupported -virheen, kun institutions nimeää pankin, jota ominaisuus ei tarjoa, kuten ominaisuuspyynnötkin.
• Sandboxissa ACH-, Wire- ja SWIFT-ominaisuuksia tarjotaan vain JPMorgan Chasessa. Pyynnöt, joista institutions puuttuu, valitsevat arvon jpmorgan, ja muun pankin nimeäminen palauttaa 422 capability_institutions_unsupported -virheen. Tuotantoympäristön reititys ei muutu. Katso Testaus sandboxissa.
• Sandbox-ominaisuuden tilan pakottaminen palauttaa 409 capability_status_blocked -virheen ja statusReason-arvon, kun simuloitu tapaus ei voi saavuttaa pyydettyä tilaa. Jo toteutuneen pakotuksen toistaminen palauttaa 200 ilman muutoksia. Katso Testaus sandboxissa.
• POST /v3/sandbox/tasks/{taskId}/review palauttaa 409 task_not_sandbox_reviewable tehtävälle, jonka omistaa Operations tai jokin muu työnkulku. POST /v3/sandbox/tasks -tehtävät ja Swipelux-palvelun keräämät kykyjen vastaanottotehtävät ovat edelleen tarkistettavissa. Katso Testaus sandboxissa.
• PATCH /v3/customers/{customerId}/accounts/{accountId} palauttaa 409 account_provisioning_unresolved -virheen, kun muutat selvitystä tilin provisioinnin ollessa vielä kesken pankissa. Yritä uudelleen, kun provisiointi on valmis. Katso Virheet ja uudelleenyritykset.
• POST /v3/transfers voi palauttaa 409 quote_execution_evidence_conflict -virheen. Luo uusi hintatarjous ja toteuta se. Katso Virheet ja uudelleenyritykset.
• Kauppiaspaneelin Pay out -sivupaneeli näyttää kohteen täydelliset tiedot, piilottaa tilinumerot ja lompakko-osoitteet valitsimen taakse ja näyttää arvioidun saapumisajan kullekin maksutavalle.
• Kauppiaspaneeli yhdistää pankkitilit asiakkaan Payment access -välilehteen, jossa tehtäväkortti nimeää kunkin pankin. Documents-välilehti on siirretty Profile-välilehteen.
• Nimetyn pankkitilin avaaminen kauppiaspaneelissa on nyt yksivaiheinen toiminto, joka näyttää kunkin pankin valuutan, maksutavat ja käyttöönottoajan. Katso Tilit.
• Tarkistettavaksi pidätetyt pankkitilit näkyvät kauppiaspaneelissa tilassa On hold, ja niissä näkyy tilin tunnus ja Contact support -toiminto.
• pending-tilassa oleva kyky ilmoittaa nyt statusReason.code: preparing_submission arvon review_in_progress sijaan, kun Swipelux valmistelee hakemusta lähetettäväksi eikä tarkistusta ole käynnissä. Molemmat koodit käyttävät arvoa resolution: wait. Vaihto niiden välillä pitää tilan arvossa pending, joten capability.status_changed-tapahtumaa ei lähetetä. Olemassa olevat kyvyt saavat uuden koodin seuraavassa uudelleenarvioinnissaan. Katso Ominaisuudet ja vaatimukset.
• Kauppiaspaneelin asiakkaan Payment access -välilehden Shared methods -taulukko näyttää In preparation eikä In review jaetulle menetelmälle, jonka kyky ilmoittaa preparing_submission.
• Kyvyn applications-luettelo näyttää nyt vain sen nykyiset hakemukset kyvyn luvuissa (mukaan lukien GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications), kykypyyntöjen vastauksissa ja capability.status_changed-tapahtumissa. Uudemmalla korvattu hakemus näkyy edelleen kohteessa GET /v3/customers/{customerId}/applications, jossa supersededByApplicationId nimeää sen seuraajan. Korvatun hakemuksen avoimet tehtävät lasketaan edelleen kyvyn openTaskIds-arvoon. Kyvyn tila ja openTaskIds eivät muutu, joten muutos itsessään ei lähetä webhook-tapahtumaa. Katso Ominaisuudet ja vaatimukset.

​

Korjattu

• Toinen allowPending-pyyntö samalle myönnetylle tilille ennen pankin hyväksyntää palauttaa 409-virheen, joka nimeää odottavan tilin kentässä holder.accountId, 500-virheen sijaan. Katso Luo pankkitili.
• Ominaisuuden peruminen sulkee nyt myönnettyjen tilien pyynnöt, jotka odottivat vielä pankin hyväksyntää, joten myöhempi pyyntö samassa pankissa alkaa alusta.
• Sellaisen perutun ominaisuuden uudelleenpyytäminen, jonka kaikki pankkitapaukset hylättiin, julkaisee yhden capability.status_changed-tapahtuman tilasta canceled.
• Pankin uudelleenpyytäminen sen aiemman hakemuksen arkistoinnin jälkeen lähettää nyt uuden hakemuksen.
• Vastaanottajien kohteita voi lisätä heti, kun vastaava ominaisuus on tilassa ready, sen sijaan että palautettaisiin 409 rail_not_ready -virhe. Katso Vastaanottajat.
• Webhook-tapahtumat, jotka lähetettiin ennen kuin avasit kauppiaspaneelin Webhooks-sivun ensimmäistä kertaa, säilytetään nyt, joten voit lähettää ne uudelleen uuteen päätepisteeseen.
• Tehtävien määräpäivät näkyvät kauppiaspaneelissa omalla aikavyöhykkeelläsi, ja pankkitarkistusten sivupaneelit näyttävät tekstin All requirements submitted, kun mitään ei ole enää avoinna.

​

Lisätty

• POST /v3/quotes hyväksyy valinnaisen institutionId-kentän, jolla voit valita hyväksytyn pankkireitin kryptosta fiatiin -maksun hintatarjoukselle. Jätä se pois, jos haluat säilyttää automaattisen reitityksen. Pankki, joka ei ole käytettävissä maksulle, palauttaa 422 bank_not_supported_for_customer -virheen, ja institutionId-kentän lähettäminen minkä tahansa muun hintatarjoustyypin kanssa palauttaa 400 validation_error -virheen. Katso Lähetä varoja.
• Myönnettyjen pankkitilien pyynnöt päätepisteeseen POST /v3/customers/{customerId}/accounts hyväksyvät institution-arvon, joka kiinnittää tilin yhteen pankkiin ilman varavaihtoehtoa, ja allowPending: true -arvon, joka tallentaa pyynnön, kun kyseisen pankin hakemus odottaa vielä hyväksyntää. allowPending edellyttää institution-arvoa. Tallennetut pyynnöt ilmoittavat niitä ohjaavan hakemuksen applicationId-arvon. Katso Luo pankkitili.
• Kauppiaspaneelissa on natiivi Webhooks-sivu päätepisteiden hallintaan. Katso Webhookit.
• Kauppiaspaneeliin on lisätty Pay in -sivupaneeli, jossa on nimetyt pankkitilit, kryptotalletukset ja tarkistusvaihe.
• Kauppiaspaneelin Pay out -kulku näyttää lompakoiden saldot lähteen valitsimessa, lisää Max-summavaihtoehdon ja sisältää tarkistusvaiheen.
• Kauppiaspaneelin asiakasprofiileissa on Recipients & destinations -välilehti.
• Tehtävävaatimukset voivat sisältää lyhyen title-otsikon. Pyynnön prompt sisältää edelleen ohjeistuksen. Katso Ominaisuudet ja vaatimukset.

​

Muutettu

• Wire-pay-inien hintatarjoukset jaetuilla Wire-reiteillä edellyttävät nyt vähintään 20 $. Hintatarjoukset, jotka alittavat reitin vähimmäismäärän tai ovat liian pieniä siirtomaksujen kattamiseen, palauttavat 422 amount_not_deliverable -virheen yleisen hintatarjousvirheen sijaan. Katso Varojen vastaanotto.
• Webhook-portaali ryhmittelee nyt v3-tapahtumatyypit resurssin mukaan ja näyttää kunkin tapahtuman payload-skeeman ja esimerkin. Vanhat tapahtumatyypit näkyvät erillisessä Legacy-ryhmässä, ja ne on merkitty vanhentuneiksi. Päätepisteet, jotka ovat jo tilanneet ne, saavat niitä edelleen; käytä uusissa tilauksissa v3-tapahtumatyyppejä. Katso Webhookit.
• Sandbox-lataukset lähettävät nyt transfer.created- ja transfer.state_changed-webhook-tapahtumat. Katso Testaus sandboxissa.
• accountProvisioning ilmoittaa nyt issued, kun asiakkaalla on jo aktiivinen myönnetty tili. Katso Ominaisuudet ja vaatimukset.
• Kauppiaspaneelissa pankkitilien tiedot avautuvat sivupaneeliin, jossa on pankkien logot. Katso Tilit.
• Kauppiaspaneeli nimeää rahaliikenteen nimillä Pay in ja Pay out, pitää sinut kirjautuneena kuuden tunnin ajan ja lähettää tukipyynnöt Swipeluxin tukeen sähköpostitse.
• Vastaanottotehtävissä, jotka hyväksyvät suoran lähetyksen, kelpoiset vaatimukset, joita asiakasprofiili tai ladatut asiakirjat jo tukevat, siirtyvät automaattisesti tilaan in_review. Katso Ominaisuudet ja vaatimukset.

​

Korjattu

• Perutun ominaisuuden uudelleenpyytäminen ei enää epäonnistu korvattujen hakemustietueiden tai vanhentuneiden vaatimusten vuoksi.
• Käytöstä poistetulla Fedwire-tunnuksella tallennetut ominaisuudet luetaan nyt arvona wire sen sijaan, että ne palauttaisivat 500-virheen.

​

Lisätty

• GET /v3/customers/{customerId}/applications listaa asiakkaan hakemustapaukset sekä kuhunkin tapaukseen pyydetyt ominaisuudet ja ominaisuudet, jotka sen hyväksyntä kattaa. Yksi hyväksyntä pankissa voi kattaa useita ominaisuuksia. Säilytetyt historialliset tapaukset viittaavat seuraajaansa kentän supersededByApplicationId kautta. Luettelo tukee kursoripohjaista sivutusta ja updatedAfter-suodatinta. Katso Ominaisuudet ja vaatimukset.
• POST /v3/customers/{customerId}/capabilities/{capabilityId} -vastaukset sisältävät selectedApplicationId-arvon hakemustapaukseen perustuville ominaisuuksille. Se yksilöi olemassa olevan hakemustapauksen, jota pyyntö käytti uudelleen, tai tapauksen, jonka se avasi. Katso Ominaisuudet ja vaatimukset.
• GET /v3/institutions -pyynnön ja tuettujen ominaisuuksien luettelon palauttamat laitokset sisältävät null-arvon sallivan logoUrl-kentän. Käytä sitä pankin brändin näyttämiseen, kun se on saatavilla, ja käytä laitoksen nimeä, kun arvo on null. Katso Ominaisuudet ja vaatimukset.
• USD SWIFT -maksut ovat nyt saatavilla. SWIFT-maksut edellyttävät vähintään 100 USD. Kauppiaspaneeli kerää vastaanottajien SWIFT-pankkiohjeet. Katso Lähetä varoja.
• Myönnetyt pankkitilit voivat vastaanottaa varoja SWIFTin kautta nimetyillä vastaanottotiedoilla. Katso Luo pankkitili.
• USDT:tä tuetaan nyt ACH- ja Wire-maksujen lähteenä. Katso Lähetä varoja.
• Myönnetyt pankkitilit hyväksyvät settlement.currency-arvon USDC tai USDT, jolla valitaan selvityslompakkoon toimitettava stablecoin lompakkotilin valuutasta riippumatta. Jätä se pois, jos haluat jatkaa selvitystä lompakon valuutassa. Katso Luo pankkitili.
• SWIFT-pankkitilit ja vastaanottajien kohteet hyväksyvät kentät bankCity, bankState, bankPostalCode ja bankAddressLine2 sekä valinnaiset kentät beneficiaryTaxId, beneficiaryPhoneNumber, ifscBranchCode ja paymentCode ja välittäjäpankin tiedot. Katso Lähetä varoja.
• Myönnettyjen pankkitilien tiedot sisältävät kentät achRoutingNumber ja wireRoutingNumber, kun pankki toimittaa erilliset ACH- ja Wire-reititysnumerot, sekä vastaanottavan pankin bankLogoUrl-kentän. Katso Luo pankkitili.
• capability.created-webhook-tapahtumat sisältävät applicationId-arvon ja origin-arvon requested tai approval, joten voit erottaa pyytämäsi ominaisuudet niistä, jotka hyväksyntä kattoi. Katso Webhookit.
• Vaatimuspyynnöt voivat määrittää validointimuodon constraints.format, kuten http_url, us_ssn, us_ein tai bank_industry_classification. Katso Ominaisuudet ja vaatimukset.

​

Muutettu

• Pankkitilin luominen kauppiaspaneelissa alkaa nyt pankin valinnasta, ja pankkitileillä näytetään erilliset ACH- ja Wire-reititysnumerot. Katso Tilit.
• network-luettelotyyppi sisältää nyt arvon solana. Se on avoin luettelotyyppi, joten varaudu verkkoarvoihin, joita et tunnista. Katso Tilit.
• Isännöidyn vahvistuslinkin avaaminen tehtävälle, jonka jäljellä olevat vaatimukset edellyttävät suoraa lähetystä, palauttaa 409 verification_session_not_allowed -virheen. Lähetä nämä vaatimukset sen sijaan tehtävän lähetyksenä. Katso Virheet ja uudelleenyritykset.
• Sellaisen myönnetyn tilin arkistointi, jonka provisiointi ei ole vielä valmistunut, palauttaa 409 account_provisioning_unresolved -virheen. Yritä uudelleen, kun provisiointi on valmis. Katso Virheet ja uudelleenyritykset.
• Uudet nimettyjen pankkitilien pyynnöt asetetaan provisiointijonoon heti, kun tili luodaan, sen sijaan että ne odottaisivat asiakkaan seuraavaa päivitystä. Katso Luo pankkitili.

​

Poistettu

• Jaettuja SWIFT-vastaanottotietoja ei enää tarjota uusille tileille. Käytä sen sijaan nimettyjä SWIFT-vastaanottotietoja. Katso Luo pankkitili.

​

Korjattu

• Maksusiirtojen lukupyynnöt palauttavat nyt hintatarjouksen vastaanottajan.
• ACH-tilin luominen olemassa olevan tilin arkistoinnin jälkeen ei enää palauta 409-virhettä, eivätkä arkistoidut odottavat tilipyynnöt enää varaa tilipaikkaa.
• Paikallisvaluuttaisten pay-in-hintatarjousten pankkimaksut ilmoitetaan oikeassa fiat-valuutassa.

​

Lisätty

• GET /v3/webhooks/{webhookId} lukee yksittäisen webhook-päätepisteen ja sen events-valinnan. Katso Webhookit.
• Tehtävävaatimukset julkaisevat nyt profiilikentille allowedValues-arvot ja JSON Schema -muotoisen valueSchema-skeeman, mukaan lukien pakolliset osoitekentät. Maakenttien valueType- tai itemValueType-arvo on country, joka tarkoittaa ISO 3166-1 alpha-2 -koodia. Voit renderöidä syöttökentät ja valinnat kovakoodaamatta niitä. Katso Ominaisuudet ja vaatimukset.
• Olemassa olevat Tron-lompakot voivat nyt lähettää USDT:tä asiakkaan ulkoisille lompakkotileille, ja siirron lukupyynnöt sisältävät Tron-tapahtumille linkin lohkoketjuselaimeen. Uusia lompakoita ei voi luoda Tronissa. Katso Lähetä varoja.
• Tehtävävaatimukset voivat määrittää requiredWhen-ehdon (vastaa vain, kun nimetty kyllä/ei-vastaus täsmää), profileAssertion-arvon (us_person) ja ownershipPolicy-käytännön, ja asiakirjapyynnöt voivat asettaa identityMetadataRequired- ja maxIssueAgeDays-arvot. Tehtävävastaukset hyväksyvät viitatuille asiakirjoille documentMetadata-tiedot (idNumber, issuingCountry, issuedOn), ja tehtävien lukupyynnöt palauttavat tarkastetut ohjaavat vastaukset kentässä conditionValues. Katso Ominaisuudet ja vaatimukset.
• Asiakirjavaatimukset voivat listata acceptedDocumentSets-joukot, ja liittyvien osapuolten vaatimukset voivat pyytää associated_person- tai control_person-kelpoisuutta beneficial_owner-kelpoisuuden lisäksi. Katso Ominaisuudet ja vaatimukset.
• Siirtojen correction-objektit kattavat nyt myös epäonnistuneet rahoitetut maksut: kind: funding_failure, jossa on recover_source_funding-kompensoiva toiminto, recoveryStatus-arvo unknown tai reported sekä USDT-muodossa hyvitetyt tuotokset. Katso Tarjoukset ja siirrot.

​

Muutettu

• PATCH /v3/webhooks/{webhookId} hyväksyy nyt vanhat tapahtumatyypit, jotka päätepiste on jo tilannut, joten voit säilyttää ne, kun lisäät v3-tapahtumatyyppejä. events korvaa koko valinnan, joten sisällytä jokainen tapahtumatyyppi, jonka haluat säilyttää. Sellaisen vanhan tapahtumatyypin lisääminen, jota päätepisteellä ei ennestään ollut, palauttaa 400 validation_error -virheen. Katso Webhookit.
• Vastaanottajien ja tilien pankkitunnisteet validoidaan ennen tallentamista. Katso Vastaanottajat.
• Ominaisuuspyynnöt, tehtävien lähetykset ja sandboxin tilamuutokset palauttavat nyt 409 capability_application_stale -virheen 500-virheen sijaan, kun ominaisuus on luotu aiemmassa onboarding-mallissa. Katso Virheet ja uudelleenyritykset.
• Julkinen RFI-sivu on nyt yksi yhtenäinen lomake. Se tukee liittyviä henkilöitä ja kerää yhden verotunnisteen henkilöä kohden. Katso Asiakirjavaatimukset.
• Hintatarjoukset ja siirrot palauttavat 409 customer_bank_limit_exceeded -virheen, kun maksu ylittää asiakkaan jäljellä olevan päivä- tai kuukausikohtaisen rajan pankissa, ja 503 customer_bank_limits_unavailable -virheen, kun rajaa ei voida tarkistaa. Siirrot palauttavat 409 payout_execution_unavailable -virheen, kun maksua ei voida aloittaa sen hintatarjouksesta. Katso Virheet ja uudelleenyritykset.
• Asiakkaan ja liittyvän osapuolen päivitykset, jotka ovat ristiriidassa valmiin pankin vastaanoton kanssa, palauttavat 409 field_conflicts_with_completed_intake -virheen sekä taskId- ja fields-arvot.

​

Korjattu

• Peruttujen ominaisuuksien historia pysyy luettavissa.
• Wire-maksut näkyvät ja suodattuvat oikein kauppiaspaneelin tapahtumaluettelossa.

​

Muutettu

• POST /v3/transfers ja siirron lukupyynnöt käyttävät korttikassan esivalintaan arvoa checkoutMethod arvon paymentMethod sijaan ja hyväksyvät arvot card, apple_pay, google_pay, cash_app, sepa ja blik. Luettelo on avoin ja voi kasvaa. paymentMethod-arvoa ei enää tunnisteta; pyynnöt, jotka yhä lähettävät sen, käsitellään kuin se olisi jätetty pois. sepa ja blik ovat korttikassan sisäisiä rahoitusvaihtoehtoja, eivät Swipeluxin ominaisuuksia. Katso Varojen vastaanotto.

​

Lisätty

• POST /v3/transfers hyväksyy korttitarjouksille valinnaisen paymentMethod-arvon card, apple_pay tai google_pay. Isännöity kassa avautuu pyydettyyn maksutapaan, kun se on asiakkaan ja hänen laitteensa käytettävissä, siirron lukupyynnöt palauttavat pyynnön, ja tarjouksen summat ja maksut pysyvät ennallaan. Katso Varojen vastaanotto.
• GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview hyväksyy institutions-parametrin, jolla voit esikatsella tuettujen ominaisuuksien luettelon palauttamien tiettyjen pankkien tehtävät. Katso Ominaisuudet ja vaatimukset.

​

Muutettu

• Korttihintatarjoukset huomioivat nyt kassan maksut ja toimitetun nettomäärän USDC:nä. Katso Varojen vastaanotto.
• Hylätyt maksujen hintatarjoukset palauttavat yleisen virheen sijaan tarkan ongelmakoodin: quote_amount_out_of_range, quote_volume_limit_exceeded, quote_source_network_unsupported tai quote_failed, ja 503 quote_temporarily_unavailable, kun hintatarjousta voidaan yrittää myöhemmin uudelleen. Katso Virheet ja uudelleenyritykset.

​

Korjattu

• Korttihintatarjoukset eivät enää epäonnistu maksujen pyöristyksen vuoksi.
• Isännöidyn KYC-linkin avaaminen uudelleen ei enää palauta 409 kyc_process_conflict -virhettä, kun kyselyn vastauksissa on ylimääräisiä välilyöntejä.
• Kauppiaspaneelin jumiutuneet passkey-nostovahvistukset palautuvat nyt.

​

Lisätty

• POST /v3/customers/{customerId}/documents hyväksyy nyt myös application/json-rungon, joka sisältää kentät storageKey, fileName ja type. storageKey-arvon on oltava tuore asiakaskohtainen viite, joka on pysäköity aiemman direct-upload-kulun kautta, ja lataus läpäisee saman koko- ja tiedostoallekirjoitusvalidoinnin kuin multipart-lataukset. Katso Siirtyminen v3:een.
• GET /v3/customers/{customerId}/documents/{documentId}/download palauttaa lataus-url-arvon aktiiviselle asiakasasiakirjalle. URL vanhenee tunnin kuluttua ja tarjoaa tiedoston liitteenä. Arkistoidut, tuntemattomat ja toisen asiakkaan asiakirjat palauttavat 404-virheen. Katso Ominaisuudet ja vaatimukset.
• Ominaisuuden pyytäminen yritykselle, jolla ei ole tosiasiallista edunsaajaa, luo nyt vastaanottotehtävän edunsaajan lisäämiseksi sen sijaan, että pyyntö epäonnistuisi 503-virheellä. Pyynnöt, jotka eivät voi edetä, palauttavat 422 beneficial_owner_required -virheen ja ohjeet lisätä yksityishenkilö liittyvänä osapuolena, jolla on ilmoitettu tai vähintään 25 %:n omistusosuus. Katso Osakkeenomistajat, UBO:t ja määräysvaltaa käyttävät henkilöt.
• Kauppiaspaneelin tehtävätaulukko näyttää nyt jokaisen pyynnön kohteen ja ominaisuuslaajuuden, joten näet, ketä ja mitä vaatimustenmukaisuuspyyntö koskee. Katso Ominaisuudet ja vaatimukset.
• Kauppiaspaneelin toimialaluokituskentät tarjoavat nyt haettavat NAICS-koodit asiakasprofiileissa ja vaatimustehtävissä. Katso KYB-työnkulku.
• Pankin pay-in-ohjeet voivat sisältää kentät bankName, bankAddress, accountHolderName ja accountHolderAddress. Näytä ne muiden pankkitietojen kanssa. Katso Varojen vastaanotto.
• POST /v3/transfers hyväksyy valinnaisen redirectUrl-kentän, joka palauttaa asiakkaan sovellukseesi isännöidyn kortti- tai Apple Pay -kassan jälkeen. URL-osoitteeseen saapuminen ei vahvista siirron valmistumista; käytä siirron lukupyyntöjä tai webhookeja. Katso Varojen vastaanotto.
• v3-säännön luomat siirrot näkyvät siirtojen lukupyynnöissä ja luetteloissa arvolla origin: rule ja lähettävät transfer.state_changed-tapahtumia kuten muutkin siirrot. Suodata ne pyynnöllä GET /v3/transfers?origin=rule. Katso Tarjoukset ja siirrot.
• Asiakkaiden ja liittyvien osapuolten henkilöllisyysasiakirjat hyväksyvät sideApplicability-arvon (front_only, front_and_back tai unknown), ja tehtävät voivat kerätä vastauksina henkilöllisyysasiakirjan tietoja, kuten type, number, issuingCountry, issuingRegion, issuedOn, expiresOn ja doesNotExpire. Katso Ominaisuudet ja vaatimukset.

​

Muutettu

• Pankkitietojen lähetykset, jotka ovat ristiriidassa käynnissä olevan pankkimäärityksen kanssa, palauttavat nyt 409 ops_rail_handoff_conflict -virheen. Säilytä lataamiesi asiakirjojen tunnukset ja yritä samaa lähetystä uudelleen ristiriidan ratkettua sen sijaan, että lataisit asiakirjat uudelleen. Katso Virheet ja uudelleenyritykset.
• Ilmoittamattomien stablecoin-talletusten vähimmäismäärä asiakaslompakoihin on nyt 1 yksikkö aiemman 10:n sijaan. Pienemmät talletukset käsitellään edelleen pölynä. Katso Varojen vastaanotto.
• Webhook-määritykset on nyt eriytetty ympäristöittäin. Webhook-portaali avautuu rajattuna siihen ympäristöön, josta sitä pyydät, joten sandbox- ja tuotantopäätepisteet eivät enää jaa asetuksia. Katso Webhookit.
• Kauppiaspaneeli johtaa nyt käytettävissä olevat pay-in-menetelmät asiakkaan v3-ominaisuuksista, joten tilin määritys tarjoaa vain menetelmiä, joihin asiakkaalla on oikeus. Katso Tilit.
• RFI-lomakkeet keräävät nyt kelpoisuusvaatimukset täyttävät tosiasialliset edunsaajat lyhyemmillä ja selkeämmillä kysymyksillä, ja RFI-historia näytetään elinkaaren virstanpylväinä. Katso Asiakirjavaatimukset.
• Avoimien tehtävien, joilla ei ole erikseen määritettyä eräpäivää, dueAt on nyt oletuksena 31 päivää luomisesta. Katso Ominaisuudet ja vaatimukset.

​

Poistettu

• Kauppiaspaneeli ei enää tarjoa Fedwireä uusia pay-in-menetelmiä lisättäessä. Olemassa olevat Fedwire-tilit ovat edelleen luettavissa. Katso Tilit.

​

Korjattu

• Ilmoittamattomat USDT-talletukset asiakaslompakoihin tunnistetaan ja selvitetään nyt sen sijaan, että ne ohitettaisiin.
• Jo toimittamasi todisteet siirtyvät nyt muihin tehtäviin, jotka vaativat samaa kohdetta, joten asiakkailta ei pyydetä samaa asiakirjaa kahdesti.
• Ominaisuuden uudelleenpyytäminen ei enää hylkää jo valmiita pankkireittejä, joten myönnetyt tilitiedot pysyvät vakaina.
• Kauppiaspaneelin pankkiohjenäkymät näyttävät nyt täydelliset tiedot, mukaan lukien SWIFT-osoitteet ja kohdelompakon osoitteen.
• RFI-lomakkeet näyttävät nyt lähetyksen validointivirheet, validoivat oikeudellisen muodon kuvaukset ennen lähetystä ja hyväksyvät useita yrityksen verkkosivustoja.
• Voit nyt muokata liittyvien henkilöiden luonnoksia RFI-lomakkeissa ennen lähettämistä.
• Perutut vaatimustenmukaisuuspyynnöt eivät enää näy kauppiaspaneelin tehtäväluettelossa.
• Asiakirjojen tarkastustilat näkyvät jälleen oikein kauppiaspaneelissa.

​

Lisätty

• Asiakaskohtaiset isännöidyt vahvistus- ja käyttöehtoistunnot sisältävät nyt ensisijaisen action-objektin. Toimi sen available- tai unavailable-tyypin mukaan; ylimmän tason url- ja expiresAt-kentät säilyvät yhteensopivuuspeileinä käytettävissä oleville toiminnoille. Katso Ominaisuudet ja vaatimukset.
• Sandbox-lompakon täydennykset palauttavat nyt siirtotunnukset, jotka voit lukea komennolla GET /v3/transfers/{transferId} tai listata komennolla GET /v3/transfers. Ne näkyvät valmistuneina saapuvina stablecoin-talletuksina. Katso Testaus sandboxissa.
• Siirtojen lukupyynnöt sisältävät correction-objektin, kun siirron varat palautetaan tai peruutetaan sen valmistumisen jälkeen. Se ilmoittaa korjauksen kind-tyypin, normalisoidun providerStatus-tilan, mahdollisen providerShortfall-vajeen ja compensatingIntent-toimenpiteen, jota Swipelux soveltaa. Katso Tarjoukset ja siirrot.

​

Muutettu

• Kauppiaspaneelin korttien ja Apple Payn First pay-in -ohjattu toiminto vaatii nyt asiakkaalle Polygon-lompakon. Luo lompakko ennen toiminnon aloittamista. Katso Tilit.
• Uudet pyynnöt ja julkiset vastaukset käyttävät sepa-arvoa menetelmän ja ominaisuuden kanonisena nimenä. Syötealias sepa_instant ja aiemmin tallennetut resurssit säilyvät yhteensopivina, mutta julkiset vastaukset käyttävät sepa-arvoa. Katso Tilit.
• Uudet Faster Payments -ominaisuus-, tilinluonti- ja tarjouspyynnöt eivät ole käytettävissä. Olemassa olevat tilit, tarjoukset ja siirrot ovat edelleen luettavissa. Katso Tilit.
• KYB:n ensimmäinen sivu ei enää kerää edustajan syntymäaikaa. Osakkeenomistajien syntymäajat ovat edelleen erillinen vaatimus. Katso KYB-työnkulku.
• RFI-asiakirjaviittaukset hyväksyvät nyt MIME-aliaksen image/jpg arvon image/jpeg lisäksi. Katso Asiakirjavaatimukset.
• Kauppiaspaneelin tehtävähistoria näyttää nyt helppolukuisen kirjausketjun ilman versiolaskeja. Katso Ominaisuudet ja vaatimukset.
• Hintatarjoukset ja siirrot tarkistavat nyt ominaisuuden tuetut suunnat ennen kuin rahaa liikkuu. Ominaisuuden käyttäminen suuntaan, jota se ei tue, palauttaa 422 capability_direction_unsupported -virheen, ja lompakoiden väliset siirrot edellyttävät stablecoin_transfers-ominaisuutta. Katso Virheet ja uudelleenyritykset.

​

Poistettu

• Kauppiaspaneeli ei enää tarjoa uusien UAEFTS-tilien määritystä. Olemassa olevat UAEFTS-tilit ovat edelleen luettavissa. Katso Tilit.

​

Korjattu

• RFI-lomakkeet säilyttävät olemassa olevat tiedot, kun tarkastaja lisää uuden asiakirjakentän, joten aiemmat vastaukset eivät katoa uudelleenlähetyksessä.
• Kauppiaspaneeli jatkaa isännöityjä vaatimustenmukaisuusistuntoja käytettävissä olevista toiminnoista hylkäämättä kelvollisia linkkejä.
• Isännöidyt käyttöehtolinkit toimivat nyt kaikilla API:n palauttamilla tehtäväalueilla.
• Kun pyydät Payment Access -käyttöoikeutta kauppiaspaneelissa, se avaa pyynnön palauttaman vastaanottotehtävän aiemman pyynnön tehtävän sijaan.
• Kauppiaspaneelin KYB-esittely pyytää nyt nykyiset pakolliset kentät.
• Tarjous, joka käyttää lähdelompakkoa uudelleen destinationId-arvona, palauttaa nyt toimintaohjeita sisältävät 422 quote_direction_invalid -tiedot ennen palveluntarjoajatyön aloittamista. Katso Tarjoukset ja siirrot.
• API hylkää virheellisesti koodatun kyselymerkkijonon 400-virheellä sen sijaan, että pyyntö normalisoitaisiin hiljaisesti. Katso Virheet ja uudelleenyritykset.
• POST /v3/customers/{customerId}/documents hylkää nyt tyhjät, muut kuin multipart-muotoiset tai virheellisesti muotoillut pyyntörungot 400-virheellä.

​

Lisätty

• Julkaistiin v3 Problem Details -luettelo OpenAPI-määrittelyssä, jotta integraattorit voivat kartoittaa virhevastaukset suoraan skeemasta. Katso Virheet.
• Lisättiin customerId v3-tilin webhook-tapahtumiin, jolloin voit yhdistää tilitapahtumat omistavaan asiakkaaseen ilman lisälukua. Katso Webhookit.
• Täysi V3-yksilöprofiilikenttien kattavuus kauppiaspaneelissa, jotta onboarding-operaattorit voivat tarkastella ja muokata jokaista v3 API:n kautta kerättyä KYC-kenttää. Katso Asiakkaat.
• Julkaistiin v3 -kehittäjän migraatio-opas. Katso Siirtyminen v3:een.

​

Muutettu

• Asiakkaiden ja tilien maakoodit validoidaan nyt kirjoitushetkellä määritettyinä ISO 3166-1 alpha-2 -arvoina. Luvut sietävät vanhoja tallennettuja arvoja, jotta olemassa olevat tietueet ratkeavat edelleen. Katso Tilit ja lompakot.
• USDC:n saatavuus on nyt rajattu kohdeverkon mukaan, joten tarjoukset ja siirrot tarjoavat USDC:tä vain niissä verkoissa, joita kohde todella tukee.
• Jokainen onboarding-virta vaatii nyt Swipeluxin käyttöehdot. Olemassa olevat istunnot säilyvät jatkettavina. Katso Asiakkaat.
• Capability.ready kertoo edelleen käyttöoikeuden hyväksynnästä. Käytä accountProvisioning-kenttää tilin myöntämisen seuraamiseen arvoilla not_applicable, not_started, in_progress, issued tai failed. Katso Ominaisuudet ja vaatimukset.
• HEIC-lataukset iPhonesta hyväksytään nyt henkilöllisyys- ja osoiteasiakirjoiksi.
• Sellaisen asiakkaan tai liittyvän osapuolen kentän tyhjentäminen, jota avoin tehtävä yhä edellyttää, palauttaa nyt 409 field_required_by_open_task -virheen sekä estävän tehtävän taskId- ja fields-arvot uudelleenyritettävän ristiriidan sijaan. Suorita tehtävä loppuun tai peru se ennen kuin muutat näitä kenttiä. Katso Virheet ja uudelleenyritykset.

​

Korjattu

• Kulutetun tarjouksen uudelleensuorittaminen palauttaa nyt 409 quote_execution_consumed yleisen virheen sijaan. Katso Tarjoukset ja siirrot.
• Siirtoluettelon luvut ja tarjoussummalukemat eivät enää anna 500-virhettä suurilla historiallisilla tuloksilla.
• Samanaikaiset KYC-uudelleenohjaukset palauttavat nyt konfliktin 404:n sijaan, joten uudelleenyritykset ratkeavat siististi. Isännöidyt uudelleenohjaukset eivät enää peruunnu kesken, ja KYC-linkit säilyvät jatkettavina.
• Yksittäisten asiakkaiden liittyvien osapuolten luvut eivät enää palauta 404:ää.
• KYB-lähetykset, joissa on virheellisiä lompakkokenttiä, hylätään ennen lähettämistä, eikä epäonnistunutta synkronointia enää raportoida onnistumisena kauppiaspaneelissa.
• Kauppiaspaneelin vaatimustehtävät näyttävät nyt lähetetyt vastaukset valmiina, seuraavat käyttöehtotoimia erikseen, poistavat päällekkäisen asiakirjatekstin, pitävät aloitetut KYC-istunnot odottavina valmistumiseen asti ja käsittelevät vanhentuneet tehtävät rikkomatta vaatimusnäkymää.
• Vahvistuslinkkirivit kauppiaspaneelissa näyttävät nyt Open-toiminnon jokaisella rivillä, ja jokainen tehtävälinkki renderöityy vaatimusnäkymässä.