Pāriet uz galveno saturu
Šī lapa uzskaita Swipelux API izmaiņas pēc datuma. Katrs ieraksts norāda ietekmēto versiju, izmaiņas veidu un integrētājiem nepieciešamās darbības. Lai atjauninātu esošu integrāciju no agrākas versijas, skati Migrācija uz v3.
PievienotsMainītsLabots
v3

Pievienots

  • Saņēmēju galamērķi pieņem tipus pix un pix_safe BRL izmaksām Brazīlijā. Pix galamērķis izmaksā uz Pix atslēgu. Pix Safe galamērķis izmaksā uz bankas kontu, ko identificē turētāja CPF vai CNPJ, bankas ISPB kods, filiāle un konta numurs. Abiem ir nepieciešama klienta gatava Pix iespēja (pix_pooled), un to izmaksas tiek finansētas ar USDC un tām netiek piemērota izstrādātāja komisija. Skatiet Saņēmēji un Līdzekļu sūtīšana.
  • GET /v3/customers/{customerId}/tasks/{taskId} pieņem documentCandidatesFor ar dokumenta prasības ID, kā arī documentAlternativeKey prasībai ar alternatīvām. Atbilde tad laukā data.documentCandidates uzskaita failus, ko klients jau ir augšupielādējis un kas var atbildēt uz šo prasību, ar jebkuriem missingMetadata vai conflictingMetadata. Tā vietā, lai atkārtoti augšupielādētu failu, iesniedziet kandidāta documentId ar trūkstošajiem documentMetadata. Vaicājumam nepieciešamas accounts:read un customers:read, un nederīga izvēle atgriež 400 validation_error.

Mainīts

  • GET /v3/webhooks/portal atgriež portāla URL, kura derīgums beidzas pēc vienas stundas, ar Cache-Control: no-store. Ar API atslēgu, kurai ir webhooks:write, portāls rāda galapunkta parakstīšanas noslēpumu un var pārvaldīt galapunktus, atkārtot piegādes un tās atskaņot no jauna. Ar tikai webhooks:read portāls rāda tikai piegādes. Skatiet Webhook izsaukumi.
  • Citi (citibank) tiek piedāvāta tikai biznesa klientiem. Katrs bizness saglabā kopīgo Citi, un nosaukta Citi tiek piedāvāta tikai biznesiem, kas reģistrēti ārpus ASV. Ja klientam Citi netiek piedāvāta, atbalstīto iespēju saraksts to izlaiž, tās norādīšana atgriež 422 capability_institutions_unsupported, un metode, ko piedāvā tikai Citi, tiek uzskaitīta kā disabled. Pieprasījums bez institutions izvēlas starp atlikušajām bankām. Esošie pieteikumi un konti nemainās.
  • Nosauktas CFSB (cfsb) iespējas tiek piedāvātas tikai ASV klientiem: biznesiem, kas reģistrēti ASV, un fiziskām personām, kas tur dzīvo. Citiem klientiem atbalstīto iespēju saraksts izlaiž nosaukto CFSB, un tās norādīšana atgriež 422 capability_institutions_unsupported. Pieprasījums bez institutions izvēlas starp atlikušajām bankām. Kopīgā CFSB, klienti, kuru valsts nav zināma, un esošie pieteikumi nemainās.
  • Lead Bank (lead_bank) nosauktās ACH, Wire un SWIFT iespējas tiek piedāvātas tikai klientiem, kurus Lead Bank var uzņemt, pamatojoties uz to juridisko formu un valstīm. Citiem klientiem atbalstīto iespēju saraksts izlaiž lead_bank, un tās norādīšana atgriež 422 capability_institutions_unsupported. Klienti, kurus Lead Bank jau ir uzņēmusi, un iespējas, kuru atvērtais pieprasījums jau norāda lead_bank, to saglabā. Esošie pieteikumi un konti nemainās.
  • RTP ir tikai kopīgs. Neviena banka nepiedāvā rtp_named jauniem pieprasījumiem, tāpēc atbalstīto iespēju saraksts to rāda kā disabled. Klientam, kuram nav rtp_named, šīs iespējas pieprasījums vai uzdevuma priekšskatījums, kas norāda banku, atgriež 422 capability_institutions_unsupported, un pieprasījums bez institutions atgriež 422 capability_variant_unavailable. Kopīgā RTP (rtp_pooled) tiek piedāvāta Citi, tāpēc to var pieprasīt tikai biznesa klienti.
  • Jauni identitātes dokumentu pieprasījumi fiziskām personām un patiesajiem labuma guvējiem var iestatīt constraints.identityMetadataRequired: true, tāpēc katram failam laukā documentMetadata ir nepieciešams tā ID numurs un izdevējvalsts. Jauni biznesa adreses apliecinājuma un īpašnieka dzīvesvietas apliecinājuma pieprasījumi var iestatīt constraints.maxIssueAgeDays: 90, tāpēc katram failam ir nepieciešams tā izdošanas datums. Esošie uzdevumi saglabā savas prasības, tāpēc nolasiet ierobežojumus katra uzdevuma pieprasījumā.
  • Uzdevuma atbildei uz biznesa reģistrācijas pieprasījumu, kura profilePointer ir /business/registration, ir nepieciešama jurisdikcijas valsts, reģistrācijas numurs un dibināšanas datums pirms iesniegšanas datuma, visi kopā. Pieprasījuma valueSchema publicē šo noteikumu, un daļēja atbilde atgriež 400 validation_error.
  • Pēc mitinātas verifikācijas Swipelux pieņem mitinātu atbildi uz profila prasību strukturētai vērtībai, piemēram, adresei vai nodokļu identifikatoriem, tikai tad, ja tā iziet tās pašas shēmas un ierobežojumu pārbaudes kā tieša atbilde. Pretējā gadījumā prasība paliek atvērta, un jūs iesniedzat šo vērtību ar POST /v3/customers/{customerId}/tasks/{taskId}/submissions. Prasība, ko Swipelux šī iemesla dēļ atgriež statusā action_required, satur reviewFeedback.code: hosted_profile_direct_submission_required. Uzdevumi, kas jau ir satisfied, saglabā savu statusu. Skatiet Iespējas un prasības.
  • Uzdevums, ko noraidījusi mitināta verifikācija, var iziet no statusa rejected, ja šis verifikācijas lēmums vēlāk tiek atcelts. Tad tas kļūst satisfied vai action_required ar jaunu revision, kurā no jauna atvērtas prasības, uz kurām jaunais lēmums neatbild. Agrākie iesniegumi šīm prasībām paliek rejected, tāpēc iesniedziet šīs atbildes vēlreiz. Skatiet Migrācija uz v3.
  • Saņēmēja galamērķa type tagad ir atvērts enum. Šīs references agrākās versijas to aprakstīja kā slēgtu, tāpēc atjauniniet jebkuru klientu, kas noraida vai izmet nezināmus tipus. Galamērķu atbildes un destination.status_changed notikumi tagad var saturēt pix un pix_safe, un var tikt pievienoti vēl citi tipi.
  • Saņēmēju izveides un atjaunināšanas pieprasījumi, ieskaitot ligzdoto address, ignorē laukus, ko tie nedefinē, nevis atgriež 400 validation_error. Izveides pieprasījumā otra saņēmēja tipa vārda vai nozares lauks joprojām atgriež 400, tāpat kā type un externalId pieprasījumā PATCH /v3/customers/{customerId}/recipients/{recipientId}. PATCH bez neviena tam atpazīstama lauka atgriež 400 validation_error, nevis 200.
  • Verifikācijas saite atbilstošai sesijai, kas pieprasa tikai dokumentus, tagad atver Swipelux mitinātu dokumentu augšupielādes lapu. Pati saite nemainās, un citas sesijas joprojām atver mitināto verifikācijas plūsmu.
  • employment.occupation fizisku personu klientiem un saistīto pušu personām pieņem ne vairāk kā 255 rakstzīmes.
  • POST /v3/customers, PATCH /v3/customers/{customerId}, POST /v3/customers/{customerId}/related-parties, PATCH /v3/customers/{customerId}/related-parties/{relatedPartyId} un POST /v3/customers/{customerId}/tasks/{taskId}/submissions atgriež 400 validation_error, ja profila vērtība vai uzdevuma atbilde satur Swipelux veidlapas saiti, piemēram, RFI, klienta pieprasījuma vai pārskaitījuma izsekošanas saiti. Tas neattiecas uz externalId vai metadata. Katra noraidītā vērtība parādās errors[] ar code: public_form_link un tās JSON Pointer, un atbilde nekad neatkārto saiti. Tā vietā nosūtiet pašu informāciju. Skatiet Kļūdas un atkārtoti mēģinājumi.

Labots

  • Izmaksas kotāciju un pārvedumu atbildes saglabā USDC vai USDT avota summu ar sešām decimāldaļām, piemēram, 4009.711365, nevis 4009.71. Fiat summas saglabā divas decimāldaļas. Izmaksas izveide vai nolasīšana, kuras stabilās monētas avota summai ir vairāk nekā divas decimāldaļas, vairs neatgriež 500.
  • POST /v3/customers/{customerId}/capabilities/{capabilityId}/cancel reference tagad apraksta atcelšanu tā, kā tā darbojas. Varat atcelt ready iespēju, iespēju stablecoin_transfers nevar atcelt, un atcelšana izbeidz tikai šo iespēju, kamēr tās pieteikumi saglabā savu statusu, uzdevumus un apstiprinājumus.
  • Iespējas pieprasījums vai uzdevuma priekšskatījums, kas laukā institutions norāda bankas kodu publiska iestādes ID vietā, piemēram, citi, nevis citibank, atgriež 422 capability_institutions_unsupported, nosaucot pieejamos ID, nevis 503 kyc_configuration_unavailable.
  • Iespējas pieprasījums vai uzdevuma priekšskatījums metodei, ko klientam nepiedāvā neviena banka un ko atbalstīto iespēju saraksts rāda kā disabled, atgriež 422 capability_variant_unavailable ar retryable: false, nevis 503 kyc_configuration_unavailable, ja vien klientam jau nav šīs iespējas.
  • documentCandidates vairs neuzskaita failus, ko Swipelux saglabā no pabeigtas mitinātās verifikācijas un ko jūs nevarat nolasīt vai lejupielādēt. Uzdevuma atbilde, kas atsaucas uz kādu no tiem, atgriež 400 invalid_document_reference, tāpat kā nezināms dokuments.
PievienotsMainītsLabots
v3

Pievienots

  • GET /v3/customers pieņem include=documentRequirements. Katrs klienta kopsavilkums tad norāda, cik obligāto dokumentu vēl nav iesniegti, neatkarīgi no iespēju gatavības. Apvienojiet to kā include=capabilities,documentRequirements. Skatiet Klienti.
  • Tirgotāja paneļa Webhooks lapa galapunkta izvēlnei pievieno Replay missed events. Tā atkārtoti nosūta pēdējo 13 dienu notikumus, kurus galapunkts nekad nav saņēmis, un nekad nenosūta vienu un to pašu notikumu divreiz. Skatiet Webhook izsaukumi.
  • Tirgotāja paneļa lapā Settings ir sadaļa Compliance. Īpašnieki un administratori var iestatīt atbilstības e-pasta adresi un izvēlēties, vai saņemt e-pastus, kad Swipelux pieprasa papildu informāciju par klientu.
  • Tirgotāji var atbildēt uz saviem KYB atbilstības pieprasījumiem tieši tirgotāja paneļa KYB lapā.

Mainīts

  • Klienta un saistīto pušu atjauninājumi pēc pabeigtas bankas uzņemšanas vairs neatgriež 409 field_conflicts_with_completed_intake. Atjauninājums tiek saglabāts, un katrs jauns bankas pieteikums pārbauda jaunāko profilu atbilstoši savām prasībām.
  • Iespēju pieprasījumi atgriež 409 capability_route_header_conflict, ja iespējas esošo bankas maršrutēšanu nevar droši atjaunināt. Pirms atkārtota mēģinājuma sazinieties ar Swipelux atbalstu.
  • GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview atgriež 422 capability_institutions_unsupported, ja institutions norāda banku, ko iespēja nepiedāvā, tāpat kā iespēju pieprasījumi.
  • Sandbox vidē ACH, Wire un SWIFT iespējas tiek nodrošinātas tikai JPMorgan Chase bankā. Pieprasījumi, kuros nav norādīts institutions, izvēlas jpmorgan, un citas bankas norādīšana atgriež 422 capability_institutions_unsupported. Reālās vides maršrutēšana nav mainījusies. Skatiet Testēšana sandbox vidē.
  • Sandbox iespējas statusa piespiedu iestatīšana atgriež 409 capability_status_blocked ar statusReason, ja simulētā lieta nevar sasniegt pieprasīto statusu. Jau piemērotas piespiedu iestatīšanas atkārtošana atgriež 200 bez izmaiņām. Skatiet Testēšana sandbox vidē.
  • POST /v3/sandbox/tasks/{taskId}/review atgriež 409 task_not_sandbox_reviewable uzdevumam, kas pieder Operations vai citai darbplūsmai. Uzdevumi no POST /v3/sandbox/tasks un iespēju pieņemšanas uzdevumi, ko Swipelux apkopo, joprojām ir pārskatāmi. Skatiet Testēšana sandbox vidē.
  • PATCH /v3/customers/{customerId}/accounts/{accountId} atgriež 409 account_provisioning_unresolved, ja maināt norēķinus, kamēr konts bankā vēl tiek nodrošināts. Mēģiniet vēlreiz pēc nodrošināšanas noslēgšanās. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • POST /v3/transfers var atgriezt 409 quote_execution_evidence_conflict. Izveidojiet jaunu kotāciju un izpildiet to. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Tirgotāja paneļa Pay out panelis rāda pilnus galamērķa rekvizītus, slēpj kontu numurus un maku adreses aiz pārslēga un katrai maksājuma metodei rāda paredzamo saņemšanas laiku.
  • Tirgotāja panelis iekļauj bankas kontus klienta cilnē Payment access ar uzdevumu karti, kas nosauc katru banku. Cilne Documents ir pārvietota uz Profile.
  • Nosaukta bankas konta atvēršana tirgotāja panelī tagad ir viens solis, kas uzskaita katras bankas valūtu, metodes un uzņemšanas laiku. Skatiet Konti.
  • Bankas konti, kas aizturēti pārskatīšanai, tirgotāja panelī tiek rādīti kā On hold ar konta ID un darbību Contact support.
  • pending iespēja tagad ziņo statusReason.code: preparing_submission, nevis review_in_progress, kamēr Swipelux sagatavo pieteikumu iesniegšanai un neviena pārskatīšana nenotiek. Abi kodi izmanto resolution: wait. Maiņa starp tiem saglabā statusu pending, tāpēc netiek nosūtīts notikums capability.status_changed. Esošās iespējas jauno kodu iegūst nākamajā atkārtotajā novērtēšanā. Skatiet Iespējas un prasības.
  • Tabula Shared methods klienta cilnē Payment access tirgotāja panelī rāda In preparation, nevis In review, koplietotai metodei, kuras iespēja ziņo preparing_submission.
  • Iespējas applications saraksts tagad rāda tikai tās pašreizējos pieteikumus iespēju nolasījumos (tostarp GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications), iespēju pieprasījumu atbildēs un capability.status_changed notikumos. Pieteikums, ko aizstājis jaunāks, joprojām parādās GET /v3/customers/{customerId}/applications, kur supersededByApplicationId norāda tā pēcteci. Aizstāta pieteikuma atvērtie uzdevumi joprojām tiek ieskaitīti iespējas openTaskIds. Iespējas statuss un openTaskIds nemainās, tāpēc pati izmaiņa nenosūta nevienu webhook notikumu. Skatiet Iespējas un prasības.

Labots

  • Otrs allowPending pieprasījums tam pašam izsniegtajam kontam, kas nosūtīts pirms bankas apstiprinājuma, atgriež 409, norādot gaidošo kontu laukā holder.accountId, nevis 500. Skatiet Izsniegt bankas kontu.
  • Iespējas atcelšana tagad slēdz izsniegto kontu pieprasījumus, kas vēl gaidīja bankas apstiprinājumu, tāpēc vēlāks pieprasījums tajā pašā bankā sākas no jauna.
  • Atceltas iespējas atkārtota pieprasīšana, ja visas tās bankas lietas tika noraidītas, publicē vienu capability.status_changed notikumu no canceled.
  • Bankas atkārtota pieprasīšana pēc tās iepriekšējā pieteikuma arhivēšanas tagad iesniedz jauno pieteikumu.
  • Saņēmēju galamērķus var pievienot, tiklīdz atbilstošā iespēja ir ready, nevis saņemt 409 rail_not_ready. Skatiet Saņēmēji.
  • Webhook notikumi, kas nosūtīti pirms tirgotāja paneļa Webhooks lapas pirmās atvēršanas, tagad tiek saglabāti, tāpēc tos var atkārtoti nosūtīt uz jaunu galapunktu.
  • Uzdevumu termiņi tirgotāja panelī tiek rādīti jūsu laika joslā, un bankas pārskatīšanas paneļi rāda All requirements submitted, kad nekas vairs nav atvērts.
PievienotsMainītsLabots
v3

Pievienots

  • POST /v3/quotes pieņem neobligātu institutionId, lai izvēlētos apstiprinātu bankas maršrutu kripto uz fiat izmaksas kotācijai. Izlaidiet to, lai saglabātu automātisku maršrutēšanu. Banka, kas izmaksai nav pieejama, atgriež 422 bank_not_supported_for_customer, un institutionId nosūtīšana kopā ar jebkuru citu kotācijas veidu atgriež 400 validation_error. Skatiet Līdzekļu sūtīšana.
  • Izsniegto bankas kontu pieprasījumi uz POST /v3/customers/{customerId}/accounts pieņem institution, lai piesaistītu kontu vienai bankai bez rezerves varianta, un allowPending: true, lai saglabātu pieprasījumu, kamēr šīs bankas pieteikums vēl gaida apstiprinājumu. allowPending pieprasa institution. Saglabātie pieprasījumi norāda noteicošo applicationId. Skatiet Izsniegt bankas kontu.
  • Tirgotāja panelim ir iebūvēta Webhooks lapa galapunktu pārvaldībai. Skatiet Webhook izsaukumi.
  • Tirgotāja panelī ir pievienots Pay in panelis ar nosauktiem bankas kontiem, kripto depozītiem un pārskatīšanas soli.
  • Tirgotāja paneļa Pay out plūsma rāda maku atlikumus avota izvēlē, pievieno summas opciju Max un ietver pārskatīšanas soli.
  • Klientu profiliem tirgotāja panelī ir cilne Recipients & destinations.
  • Uzdevumu prasības var ietvert īsu title virsrakstu. Pieprasījuma prompt joprojām sniedz norādes. Skatiet Iespējas un prasības.

Mainīts

  • Wire pay-in kotācijām kopīgajos Wire maršrutos tagad nepieciešami vismaz $20. Kotācijas, kas ir zem maršruta minimuma vai pārāk mazas, lai segtu pārskaitījuma maksas, atgriež 422 amount_not_deliverable, nevis vispārīgu kotācijas kļūdu. Skatiet Līdzekļu saņemšana.
  • Webhook portāls tagad grupē v3 notikumu veidus pēc resursa un katram notikumam rāda tā datu shēmu un piemēru. Mantotie notikumu veidi parādās atsevišķā grupā Legacy un ir atzīmēti kā novecojuši. Galapunkti, kas tos jau abonē, tos joprojām saņem; jauniem abonementiem izmantojiet v3 notikumu veidus. Skatiet Webhook izsaukumi.
  • Sandbox papildinājumi tagad izsūta transfer.created un transfer.state_changed webhook notikumus. Skatiet Testēšana sandbox vidē.
  • accountProvisioning tagad ziņo issued, ja klientam jau ir aktīvs izsniegts konts. Skatiet Iespējas un prasības.
  • Bankas konta rekvizīti tirgotāja panelī atveras sānu panelī ar banku logotipiem. Skatiet Konti.
  • Tirgotāja panelis naudas kustību apzīmē kā Pay in un Pay out, saglabā jūs pierakstītu sešas stundas un nosūta palīdzības pieprasījumus Swipelux atbalstam pa e-pastu.
  • Uzņemšanas uzdevumos, kas pieņem tiešu iesniegšanu, atbilstošās prasības, kuras jau pamato klienta profils vai augšupielādētie dokumenti, automātiski pāriet uz in_review. Skatiet Iespējas un prasības.

Labots

  • Atceltas iespējas atkārtota pieprasīšana vairs neizdodas aizstātu pieteikumu ierakstu vai novecojušu prasību dēļ.
  • Iespējas, kas saglabātas zem novecojušā Fedwire ID, tagad tiek nolasītas kā wire, nevis atgriež 500.
PievienotsMainītsNoņemtsLabots
v3

Pievienots

  • GET /v3/customers/{customerId}/applications uzskaita klienta pieteikumu lietas kopā ar iespējām, kas pieprasītas katrai lietai, un iespējām, ko aptver tās apstiprinājums. Viens apstiprinājums bankā var aptvert vairākas iespējas. Saglabātās vēsturiskās lietas norāda uz savu pēcteci, izmantojot supersededByApplicationId. Saraksts atbalsta kursora lapošanu un updatedAfter. Skatiet Iespējas un prasības.
  • POST /v3/customers/{customerId}/capabilities/{capabilityId} atbildes ietver selectedApplicationId ar lietām saistītām iespējām. Tas identificē esošo pieteikuma lietu, ko pieprasījums atkārtoti izmantoja, vai lietu, ko tas atvēra. Skatiet Iespējas un prasības.
  • Iestādes, ko atgriež GET /v3/institutions un atbalstīto iespēju saraksts, ietver logoUrl, kas var būt null. Izmantojiet to, lai rādītu bankas zīmolu, ja tas pieejams, un izmantojiet iestādes nosaukumu, ja tas ir null. Skatiet Iespējas un prasības.
  • Tagad ir pieejamas USD SWIFT izmaksas. SWIFT izmaksām nepieciešami vismaz 100 USD. Tirgotāja panelis apkopo SWIFT bankas instrukcijas saņēmējiem. Skatiet Līdzekļu sūtīšana.
  • Izsniegtie bankas konti var saņemt caur SWIFT ar nosauktiem saņemšanas rekvizītiem. Skatiet Izsniegt bankas kontu.
  • USDT tagad tiek atbalstīts kā avots ACH un Wire izmaksām. Skatiet Līdzekļu sūtīšana.
  • Izsniegtie bankas konti pieņem settlement.currency ar vērtību USDC vai USDT, lai izvēlētos stablecoin, kas tiek piegādāts norēķinu makā, neatkarīgi no maka konta valūtas. Izlaidiet to, lai turpinātu norēķināties maka valūtā. Skatiet Izsniegt bankas kontu.
  • SWIFT bankas konti un saņēmēju galamērķi pieņem bankCity, bankState, bankPostalCode un bankAddressLine2, kā arī neobligātus beneficiaryTaxId, beneficiaryPhoneNumber, ifscBranchCode, paymentCode un starpniekbankas rekvizītus. Skatiet Līdzekļu sūtīšana.
  • Izsniegto bankas kontu rekvizīti ietver achRoutingNumber un wireRoutingNumber, ja banka nodrošina atsevišķus ACH un Wire maršrutēšanas numurus, un bankLogoUrl saņēmējai bankai. Skatiet Izsniegt bankas kontu.
  • capability.created webhook notikumi ietver applicationId un origin ar vērtību requested vai approval, lai jūs varētu atšķirt jūsu pieprasītās iespējas no tām, ko aptvēra apstiprinājums. Skatiet Webhook izsaukumi.
  • Prasību pieprasījumi var deklarēt validācijas constraints.format, piemēram, http_url, us_ssn, us_ein vai bank_industry_classification. Skatiet Iespējas un prasības.

Mainīts

  • Bankas konta izveide tirgotāja panelī tagad sākas ar bankas izvēli, un bankas konti rāda atsevišķus ACH un Wire maršrutēšanas numurus. Skatiet Konti.
  • network enum tagad ietver solana. Tas ir atvērts enum, tāpēc pieļaujiet tīkla vērtības, kuras neatpazīstat. Skatiet Konti.
  • Mitinātas verifikācijas saites atvēršana uzdevumam, kura atlikušajām prasībām nepieciešama tieša iesniegšana, atgriež 409 verification_session_not_allowed. Tā vietā iesniedziet šīs prasības kā uzdevuma iesniegumu. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Izsniegta konta arhivēšana, kura nodrošināšana vēl nav noslēgusies, atgriež 409 account_provisioning_unresolved. Mēģiniet vēlreiz pēc nodrošināšanas noslēgšanās. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Jauni nosauktu bankas kontu pieprasījumi tiek ievietoti nodrošināšanas rindā, tiklīdz konts ir izveidots, nevis gaida nākamo klienta atsvaidzināšanu. Skatiet Izsniegt bankas kontu.

Noņemts

  • Kopīgie SWIFT saņemšanas rekvizīti jauniem kontiem vairs netiek piedāvāti. Tā vietā izmantojiet nosauktus SWIFT saņemšanas rekvizītus. Skatiet Izsniegt bankas kontu.

Labots

  • Izmaksas pārskaitījumu nolasīšana tagad atgriež kotācijā norādīto saņēmēju.
  • ACH konta izveide pēc esoša konta arhivēšanas vairs neatgriež 409, un arhivēti gaidoši kontu pieprasījumi vairs neaizņem konta vietu.
  • Bankas maksas vietējās valūtas pay-in kotācijās tiek norādītas pareizajā fiat valūtā.
PievienotsMainītsLabots
v3

Pievienots

  • GET /v3/webhooks/{webhookId} nolasa vienu webhook galapunktu un tā events atlasi. Skatiet Webhook izsaukumi.
  • Uzdevumu prasības tagad publicē allowedValues un JSON Schema valueSchema profila laukiem, tostarp obligātajiem adreses laukiem. Valsts lauki norāda valueType vai itemValueType vērtību country, kas nozīmē ISO 3166-1 alpha-2 kodu. Varat attēlot ievades laukus un izvēles, tos necietkodējot. Skatiet Iespējas un prasības.
  • Esošie Tron maki tagad var sūtīt USDT uz klienta ārējo maku kontiem, un pārvedumu nolasījumi ietver bloku pārlūka saiti Tron transakcijām. Jaunus makus Tron tīklā nevar izsniegt. Skatiet Līdzekļu sūtīšana.
  • Uzdevumu prasības var deklarēt requiredWhen (atbildēt tikai tad, ja norādītā jā/nē atbilde sakrīt), profileAssertion (us_person) un ownershipPolicy, un dokumentu pieprasījumi var iestatīt identityMetadataRequired un maxIssueAgeDays. Uzdevumu atbildes pieņem documentMetadata (idNumber, issuingCountry, issuedOn) norādītajiem dokumentiem, un uzdevumu nolasījumi atgriež pārskatītās noteicošās atbildes laukā conditionValues. Skatiet Iespējas un prasības.
  • Dokumentu prasības var uzskaitīt acceptedDocumentSets, un saistīto pušu prasības papildus beneficial_owner var pieprasīt associated_person vai control_person kvalifikāciju. Skatiet Iespējas un prasības.
  • Pārveduma correction objekti tagad aptver arī neizdevušās finansētās izmaksas: kind: funding_failure ar kompensējošo darbību recover_source_funding, recoveryStatus ar vērtību unknown vai reported un USDT ieskaitītajiem rezultātiem. Skatiet Kotācijas un pārvedumi.

Mainīts

  • PATCH /v3/webhooks/{webhookId} tagad pieņem mantotos notikumu veidus, kurus galapunkts jau abonē, tāpēc varat tos saglabāt, kamēr pievienojat v3 notikumu veidus. events aizstāj visu atlasi, tāpēc iekļaujiet katru notikumu veidu, ko vēlaties saglabāt. Mantota notikumu veida pievienošana, kura galapunktam vēl nebija, atgriež 400 validation_error. Skatiet Webhook izsaukumi.
  • Bankas identifikatori saņēmējos un kontos tiek validēti pirms saglabāšanas. Skatiet Saņēmēji.
  • Iespēju pieprasījumi, uzdevumu iesniegumi un sandbox statusa izmaiņas tagad atgriež 409 capability_application_stale, nevis 500, ja iespēja tika izveidota saskaņā ar agrāku iekļaušanas modeli. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Publiskā RFI lapa tagad ir viena nepārtraukta veidlapa. Tā atbalsta saistītās personas un apkopo vienu nodokļu ID katrai personai. Skatiet Dokumentu prasības.
  • Kotācijas un pārvedumi atgriež 409 customer_bank_limit_exceeded, ja maksājums pārsniedz klienta atlikušo dienas vai mēneša limitu bankā, un 503 customer_bank_limits_unavailable, ja šo limitu nevar pārbaudīt. Pārvedumi atgriež 409 payout_execution_unavailable, ja izmaksu nevar sākt no tās kotācijas. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Klienta un saistīto pušu atjauninājumi, kas konfliktē ar pabeigtu bankas uzņemšanu, atgriež 409 field_conflicts_with_completed_intake ar taskId un fields.

Labots

  • Atcelto iespēju vēsture joprojām ir nolasāma.
  • Wire izmaksas tirgotāja paneļa darījumu sarakstā tiek rādītas un filtrētas pareizi.
Mainīts
v3

Mainīts

  • POST /v3/transfers un pārveduma nolasījumi kartes norēķināšanās iepriekšējai atlasei izmanto checkoutMethod, nevis paymentMethod, un pieņem card, apple_pay, google_pay, cash_app, sepa un blik. Saraksts ir atvērts un var paplašināties. paymentMethod vairs netiek atpazīts; pieprasījumi, kas to joprojām nosūta, tiek apstrādāti tā, it kā tas būtu izlaists. sepa un blik ir finansēšanas iespējas kartes norēķināšanās ietvaros, nevis Swipelux iespējas. Skati Līdzekļu saņemšana.
PievienotsMainītsLabots
v3

Pievienots

  • POST /v3/transfers kartes kotācijām pieņem neobligātu paymentMethod ar vērtību card, apple_pay vai google_pay. Mitinātā norēķināšanās atveras ar pieprasīto metodi, ja tā ir pieejama klientam un viņa ierīcei, pārveduma nolasījumi atgriež pieprasījumu, un kotācijas summas un maksas paliek nemainīgas. Skati Līdzekļu saņemšana.
  • GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview pieņem institutions, lai priekšskatītu uzdevumus konkrētām bankām, ko atgriež atbalstīto iespēju saraksts. Skatiet Iespējas un prasības.

Mainīts

  • Kartes kotācijas tagad atspoguļo norēķinu maksas un piegādāto neto USDC. Skatiet Līdzekļu saņemšana.
  • Noraidītas izmaksas kotācijas vispārīgas kļūdas vietā atgriež konkrētu problēmas kodu: quote_amount_out_of_range, quote_volume_limit_exceeded, quote_source_network_unsupported vai quote_failed, un 503 quote_temporarily_unavailable, ja kotāciju var mēģināt vēlreiz vēlāk. Skatiet Kļūdas un atkārtoti mēģinājumi.

Labots

  • Kartes kotācijas vairs neizdodas maksu noapaļošanas dēļ.
  • Mitinātas KYC saites atkārtota atvēršana vairs neatgriež 409 kyc_process_conflict, ja anketas atbildēs ir lieki atstarpes simboli.
  • Iestrēgušie passkey izņemšanas apstiprinājumi tirgotāja panelī tagad atjaunojas.
PievienotsMainītsNoņemtsLabots
v3

Pievienots

  • POST /v3/customers/{customerId}/documents tagad pieņem arī application/json ķermeni ar storageKey, fileName un type. storageKey jābūt svaigai klienta tvēruma atsaucei, kas novietota caur agrāko direct-upload plūsmu, un augšupielāde iziet to pašu izmēra un faila paraksta validāciju kā multipart augšupielādes. Skatiet Migrācija uz v3.
  • GET /v3/customers/{customerId}/documents/{documentId}/download atgriež lejupielādes url aktīvam klienta dokumentam. URL derīgums beidzas pēc vienas stundas, un fails tiek pasniegts kā pielikums. Arhivēti, nezināmi un cita klienta dokumenti atgriež 404. Skatiet Iespējas un prasības.
  • Iespējas pieprasīšana uzņēmumam bez faktiskā labuma guvēja tagad izveido uzņemšanas uzdevumu tā pievienošanai, nevis neizdodas ar 503. Pieprasījumi, kas nevar turpināties, atgriež 422 beneficial_owner_required ar norādēm pievienot individuālu saistīto pusi ar deklarētu vai vismaz 25% īpašumtiesību daļu. Skatiet Akcionāri, UBO un kontroles personas.
  • Tirgotāja paneļa uzdevumu tabula tagad rāda katra pieprasījuma subjektu un iespējas tvērumu, tāpēc varat redzēt, kuru un ko atbilstības pieprasījums aptver. Skatiet Iespējas un prasības.
  • Nozares klasifikācijas lauki tirgotāja panelī tagad piedāvā meklējamus NAICS kodus klientu profilos un prasību uzdevumos. Skatiet KYB darbplūsma.
  • Bankas pay-in instrukcijas var ietvert bankName, bankAddress, accountHolderName un accountHolderAddress. Rādiet tos kopā ar pārējiem bankas rekvizītiem. Skatiet Līdzekļu saņemšana.
  • POST /v3/transfers pieņem neobligātu redirectUrl, kas pēc kartes vai Apple Pay mitinātās norēķinu lapas atgriež klientu jūsu lietotnē. Nonākšana šajā URL neapstiprina pabeigšanu; izmantojiet pārvedumu nolasījumus vai webhook izsaukumus. Skatiet Līdzekļu saņemšana.
  • Pārvedumi, ko izveidojis v3 Rule, parādās pārvedumu nolasījumos un sarakstos ar origin: rule un izsūta transfer.state_changed notikumus tāpat kā citi pārvedumi. Filtrējiet tos ar GET /v3/transfers?origin=rule. Skatiet Kotācijas un pārvedumi.
  • Identitātes dokumenti klientiem un saistītajām pusēm pieņem sideApplicability (front_only, front_and_back vai unknown), un uzdevumi var apkopot identitātes dokumenta datus, piemēram, type, number, issuingCountry, issuingRegion, issuedOn, expiresOn un doesNotExpire, kā atbildes. Skatiet Iespējas un prasības.

Mainīts

  • Bankas rekvizītu iesniegumi, kas konfliktē ar notiekošu bankas iestatīšanu, tagad atgriež 409 ops_rail_handoff_conflict. Saglabājiet augšupielādēto dokumentu ID un pēc konflikta atrisināšanas atkārtojiet to pašu iesniegumu, nevis augšupielādējiet dokumentus no jauna. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • Minimums nepieteiktiem stablecoin depozītiem klientu makos tagad ir 1 vienība 10 vietā. Mazāki depozīti joprojām tiek uzskatīti par putekļiem. Skatiet Līdzekļu saņemšana.
  • Webhook konfigurācija tagad ir izolēta katrai videi. Webhook portāls atveras tās vides tvērumā, no kuras to pieprasāt, tāpēc sandbox un produkcijas galapunkti vairs nekopīgo iestatījumus. Skatiet Webhook izsaukumi.
  • Tirgotāja panelis tagad pieejamās pay-in metodes atvasina no klienta v3 iespējām, tāpēc konta iestatīšana piedāvā tikai tās metodes, uz kurām klientam ir tiesības. Skatiet Konti.
  • RFI veidlapas tagad apkopo kvalificējošos faktiskā labuma guvējus ar īsākiem, skaidrākiem jautājumiem, un RFI vēsture tiek rādīta kā dzīves cikla atskaites punkti. Skatiet Dokumentu prasības.
  • Atvērtiem uzdevumiem bez skaidri norādīta izpildes termiņa dueAt tagad pēc noklusējuma ir 31 diena pēc izveides. Skatiet Iespējas un prasības.

Noņemts

  • Tirgotāja panelis vairs nepiedāvā Fedwire, pievienojot jaunas pay-in metodes. Esošie Fedwire konti joprojām ir nolasāmi. Skatiet Konti.

Labots

  • Nepieteikti USDT depozīti klientu makos tagad tiek atpazīti un norēķināti, nevis ignorēti.
  • Jau iesniegtie pierādījumi tagad tiek pārnesti uz citiem uzdevumiem, kam nepieciešams tas pats vienums, tāpēc klientiem viens un tas pats dokuments netiek prasīts divreiz.
  • Iespējas atkārtota pieprasīšana vairs neatmet jau gatavus bankas maršrutus, tāpēc izsniegtie konta rekvizīti paliek stabili.
  • Bankas instrukciju skati tirgotāja panelī tagad rāda pilnīgu informāciju, tostarp SWIFT adreses un mērķa maka adresi.
  • RFI veidlapas tagad parāda iesniegšanas validācijas kļūdas, pirms iesniegšanas validē juridiskās formas aprakstus un pieņem vairākas uzņēmuma tīmekļa vietnes.
  • Tagad varat rediģēt saistīto personu melnrakstus RFI veidlapās pirms iesniegšanas.
  • Atceltie atbilstības pieprasījumi vairs neparādās tirgotāja paneļa uzdevumu sarakstā.
  • Dokumentu pārskatīšanas statusi tirgotāja panelī atkal tiek rādīti pareizi.
PievienotsMainītsNoņemtsLabots
v3

Pievienots

  • Klienta tvēruma mitinātās verifikācijas un Pakalpojuma noteikumu sesijas tagad ietver autoritatīvu action objektu. Sekojiet tā veidam available vai unavailable; augšējā līmeņa url un expiresAt lauki pieejamām darbībām paliek kā saderības spoguļi. Skatiet Iespējas un prasības.
  • Sandbox maka papildināšana tagad atgriež pārveduma ID, ko varat nolasīt ar GET /v3/transfers/{transferId} vai uzskaitīt ar GET /v3/transfers. Tas tiek parādīts kā pabeigts ienākošs stablecoin depozīts. Skatiet Testēšana sandbox vidē.
  • Pārvedumu nolasījumi ietver correction objektu, ja pārveduma līdzekļi tiek atgriezti vai stornēti pēc tā pabeigšanas. Tas norāda korekcijas kind, normalizēto providerStatus, jebkādu providerShortfall un compensatingIntent, ko piemēro Swipelux. Skatiet Piedāvājumi un pārvedumi.

Mainīts

  • Tirgotāja paneļa karšu un Apple Pay First pay-in vednis tagad pieprasa klientam Polygon maku. Izveidojiet maku pirms vedņa sākšanas. Skatiet Konti.
  • Jaunie pieprasījumi un publiskās atbildes izmanto sepa kā metodes un iespējas kanonisko nosaukumu. Ievades aizstājvārds sepa_instant un iepriekš saglabātie resursi paliek saderīgi, bet publiskās atbildes izmanto sepa. Skatiet Konti.
  • Jauni Faster Payments iespēju, izsniegto kontu un piedāvājumu pieprasījumi nav pieejami. Esošie konti, piedāvājumi un pārvedumi joprojām ir nolasāmi. Skatiet Konti.
  • KYB pirmā lapa vairs neapkopo pārstāvja dzimšanas datumu. Akcionāru dzimšanas datumi paliek atsevišķa prasība. Skatiet KYB darbplūsma.
  • RFI dokumentu atsauces tagad papildus image/jpeg pieņem arī MIME aizstājvārdu image/jpg. Skatiet Dokumentu prasības.
  • Uzdevumu vēsture tirgotāja panelī tagad rāda lasāmu audita pierakstu bez revīziju skaitītājiem. Skatiet Iespējas un prasības.
  • Piedāvājumi un pārvedumi tagad pārbauda iespējas atbalstītos virzienus, pirms tiek pārvietota nauda. Iespējas izmantošana virzienā, ko tā neatbalsta, atgriež 422 capability_direction_unsupported, un pārvietojumiem starp makiem nepieciešama stablecoin_transfers iespēja. Skatiet Kļūdas un atkārtoti mēģinājumi.

Noņemts

  • Tirgotāja panelis vairs nepiedāvā jaunu UAEFTS kontu iestatīšanu. Esošie UAEFTS konti joprojām ir nolasāmi. Skatiet Konti.

Labots

  • RFI veidlapas saglabā esošos ierakstus, kad pārskatītājs pievieno jaunu dokumenta iesniegšanas lauku, tādēļ iepriekšējās atbildes atkārtotas iesniegšanas laikā netiek zaudētas.
  • Tirgotāja panelis atsāk mitinātās atbilstības sesijas no pieejamām darbībām, neatmetot derīgas saites.
  • Mitinātās Pakalpojuma noteikumu saites tagad darbojas katram API atgrieztajam uzdevuma tvērumam.
  • Pēc Payment Access pieprasīšanas tirgotāja panelī tas atver šā pieprasījuma atgriezto uzņemšanas uzdevumu, nevis agrāka pieprasījuma uzdevumu.
  • Tirgotāja paneļa KYB demonstrācija tagad pieprasa pašreiz obligātos laukus.
  • Piedāvājums, kas avota maku atkārtoti izmanto kā destinationId, tagad pirms pakalpojuma sniedzēja darba sākšanas atgriež izmantojamu 422 quote_direction_invalid informāciju. Skatiet Piedāvājumi un pārvedumi.
  • API noraida nepareizi kodētu vaicājuma virkni ar 400 kļūdu, nevis klusām normalizē pieprasījumu. Skatiet Kļūdas un atkārtoti mēģinājumi.
  • POST /v3/customers/{customerId}/documents tagad ar 400 kļūdu noraida tukšus, ne-multipart vai nepareizi formatētus pieprasījuma ķermeņus.
PievienotsMainītsLabots
v3

Pievienots

  • OpenAPI specifikācijā publicēts v3 Problem Details katalogs, lai integrētāji varētu kartēt kļūdu atbildes tieši no shēmas. Skati Kļūdas.
  • v3 konta webhook izsaukumu notikumiem pievienots customerId, ļaujot korelēt konta darbību ar īpašnieka klientu bez papildu nolasīšanas. Skati Webhook izsaukumi.
  • Pilnīgs V3 individuālā profila lauku pārklājums tirgotāja panelī, lai iekļaušanas operatori varētu pārskatīt un rediģēt katru KYC lauku, kas savākts caur v3 API. Skati Klientu iekļaušana.
  • Publicēts v3 izstrādātāju migrācijas ceļvedis. Skati Migrācija uz v3.

Mainīts

  • Klientu un kontu valstu kodi ierakstīšanas laikā tagad tiek validēti kā piešķirti ISO 3166-1 alpha-2 vērtības. Nolasījumi pieļauj mantotās saglabātās vērtības, lai esošie ieraksti joprojām tiktu atrisināti. Skati Konti un maki.
  • USDC pieejamība tagad ir noteikta pēc galamērķa tīkla, tāpēc kotācijas un pārvedumi piedāvā USDC tikai tajos tīklos, ko galamērķis patiešām atbalsta.
  • Katra iekļaušanas plūsma tagad pieprasa Swipelux Pakalpojuma noteikumus. Esošās sesijas paliek atsākamas. Skati Klientu iekļaušana.
  • Capability.ready turpina ziņot par tiesību apstiprinājumu. Izmantojiet accountProvisioning, lai sekotu konta izsniegšanai kā not_applicable, not_started, in_progress, issued vai failed. Skati Iespējas un prasības.
  • HEIC augšupielādes no iPhone tagad tiek pieņemtas kā identitātes un adreses dokumenti.
  • Klienta vai saistītās puses lauka notīrīšana, ko atvērts uzdevums joprojām pieprasa, tagad atgriež 409 field_required_by_open_task ar bloķējošo taskId un fields, nevis atkārtojamu konfliktu. Pabeidziet vai atceliet uzdevumu, pirms maināt šos laukus. Skati Kļūdas un atkārtoti mēģinājumi.

Labots

  • Patērētas kotācijas atkārtota izpildīšana tagad atgriež 409 quote_execution_consumed, nevis vispārīgu kļūdu. Skati Kotācijas un pārvedumi.
  • Pārvedumu saraksta nolasījumi un kotācijas summu nolasījumi vairs neatgriež 500 pie lieliem vēsturiskiem rezultātiem.
  • Vienlaicīgas KYC pāradresācijas tagad atgriež konfliktu, nevis 404, tāpēc atkārtoti mēģinājumi tiek atrisināti korekti. Mitinātās pāradresācijas vairs netiek atsauktas pusceļā, un KYC saites paliek atsākamas.
  • Saistīto pušu nolasījumi individuāliem klientiem vairs neatgriež 404.
  • KYB iesniegumi ar nederīgiem maka laukiem tiek noraidīti pirms iesniegšanas, un neizdevusies sinhronizācija tirgotāja panelī vairs netiek ziņota kā veiksmīga.
  • Prasību uzdevumi tirgotāja panelī tagad rāda iesniegtās atbildes kā pabeigtas, atsevišķi seko noteikumu darbībām, noņem dublēto dokumentu tekstu, patur sāktās KYC sesijas gaidīšanā līdz pabeigšanai un apstrādā novecojušus uzdevumus, nesabojājot prasību skatu.
  • Verifikācijas saišu rindas tirgotāja panelī tagad rāda Open darbību katrā rindā, un katra uzdevuma saite tiek renderēta prasību skatā.