Skip to main content
Questa pagina elenca le modifiche datate all’API di Swipelux. Ogni voce indica la versione interessata, il tipo di modifica ed eventuali azioni richieste agli integratori. Per aggiornare un’integrazione esistente da una versione precedente, consulta Migrare a v3.

​
Non rilasciato

Le prossime modifiche saranno elencate qui prima del rilascio.

​
2026-09-08

Versione: v3

​
Modificato

  • POST /v3/transfers e le letture dei transfer usano checkoutMethod al posto di paymentMethod per la preselezione del checkout con carta, e accettano card, apple_pay, google_pay, cash_app, sepa e blik. L’elenco è aperto e può crescere. paymentMethod non è più riconosciuto; le richieste che lo inviano ancora vengono trattate come se fosse stato omesso. sepa e blik sono opzioni di pagamento all’interno del checkout con carta, non capability Swipelux. Consulta Ricevere fondi.

​
2026-09-07

Versione: v3

​
Aggiunto

  • POST /v3/transfers accetta un paymentMethod opzionale con valore card, apple_pay o google_pay per i quote con carta. Il checkout hosted si apre sul metodo richiesto quando è disponibile per il cliente e il suo dispositivo, le letture del transfer restituiscono la richiesta, e gli importi e le commissioni del quote restano invariati. Consulta Ricevere fondi.

​
2026-08-31

Versione: v3

​
Aggiunto

  • Richiedere una capacità per un’azienda senza titolare effettivo ora crea un’attività di acquisizione per aggiungerne uno invece di fallire con un errore 503. Le richieste che non possono procedere restituiscono 422 beneficial_owner_required con istruzioni per aggiungere una parte correlata individuale con una partecipazione dichiarata o di almeno il 25%. Consulta Azionisti, UBO e persone di controllo.
  • La tabella delle attività del pannello commerciante ora mostra il soggetto e l’ambito di capacità di ogni richiesta, così puoi vedere chi e cosa copre una richiesta di conformità. Consulta Capacità e requisiti.
  • I campi di classificazione del settore nel pannello commerciante ora offrono codici NAICS ricercabili nei profili dei clienti e nelle attività dei requisiti. Consulta Flusso KYB.

​
Modificato

  • Gli invii di coordinate bancarie in conflitto con una configurazione bancaria in corso ora restituiscono 409 ops_rail_handoff_conflict. Conserva gli ID dei documenti caricati e ripeti lo stesso invio dopo la risoluzione del conflitto invece di caricare di nuovo i documenti. Consulta Errori e nuovi tentativi.
  • Il minimo per i depositi di stablecoin non annunciati nei wallet dei clienti è ora di 1 unità invece di 10. I depositi più piccoli vengono comunque trattati come dust. Consulta Ricevere fondi.
  • La configurazione dei webhook è ora isolata per ambiente. Il portale dei webhook si apre limitato all’ambiente da cui lo richiedi, così gli endpoint sandbox e di produzione non condividono più le impostazioni. Consulta Webhook.
  • Il pannello commerciante ora deriva i metodi di pay-in disponibili dalle capacità v3 del cliente, così la configurazione del conto offre solo i metodi a cui il cliente ha diritto. Consulta Conti.
  • I moduli RFI ora raccolgono i titolari effettivi qualificati con richieste più brevi e chiare, e la cronologia RFI viene visualizzata come tappe del ciclo di vita. Consulta Requisiti dei documenti.

​
Rimosso

  • Il pannello commerciante non offre più Fedwire durante l’aggiunta di nuovi metodi di pay-in. I conti Fedwire esistenti restano leggibili. Consulta Conti.

​
Corretto

  • I depositi USDT non annunciati nei wallet dei clienti ora vengono riconosciuti e regolati invece di essere ignorati.
  • Le prove già inviate ora vengono riportate nelle altre attività che richiedono lo stesso elemento, così ai clienti non viene chiesto due volte lo stesso documento.
  • Richiedere di nuovo una capacità non scarta più le rotte bancarie già pronte, così i dettagli dei conti emessi restano stabili.
  • Le viste delle istruzioni bancarie nel pannello commerciante ora mostrano dettagli completi, inclusi gli indirizzi SWIFT e l’indirizzo del wallet di destinazione.
  • I moduli RFI ora mostrano gli errori di validazione all’invio, convalidano le descrizioni della forma giuridica prima dell’invio e accettano più siti web aziendali.
  • Ora puoi modificare le bozze delle persone correlate nei moduli RFI prima dell’invio.
  • Le richieste di conformità annullate non compaiono più nell’elenco delle attività del pannello commerciante.
  • Gli stati di revisione dei documenti vengono di nuovo visualizzati correttamente nel pannello commerciante.

​
2026-08-24

Versione: v3

​
Aggiunto

  • Le sessioni ospitate di verifica e dei Termini di servizio nell’ambito del cliente ora includono un oggetto action autorevole. Segui il relativo tipo available o unavailable; i campi piatti url ed expiresAt restano copie di compatibilità per le azioni disponibili. Consulta Capacità e requisiti.
  • Le ricariche dei wallet sandbox ora restituiscono ID di trasferimento che puoi leggere con GET /v3/transfers/{transferId} o elencare con GET /v3/transfers. Vengono visualizzate come depositi in entrata di stablecoin completati. Consulta Test nella sandbox.

​
Modificato

  • La procedura First pay-in del pannello commerciante per carte e Apple Pay ora richiede un wallet Polygon del cliente. Crea il wallet prima di iniziare la procedura. Consulta Conti.
  • Le nuove richieste e le risposte pubbliche usano sepa come nome canonico del metodo e della capacità. L’alias di input sepa_instant e le risorse memorizzate in precedenza restano compatibili, ma le risposte pubbliche usano sepa. Consulta Conti.
  • Le nuove richieste di capacità, conti emessi e preventivi Faster Payments non sono disponibili. I conti, i preventivi e i trasferimenti esistenti restano leggibili. Consulta Conti.
  • La prima pagina KYB non raccoglie più la data di nascita del rappresentante. Le date di nascita degli azionisti restano un requisito separato. Consulta Flusso KYB.
  • I riferimenti ai documenti RFI ora accettano l’alias MIME image/jpg oltre a image/jpeg. Consulta Requisiti dei documenti.
  • La cronologia delle attività nel pannello commerciante ora mostra una traccia di controllo leggibile senza contatori di revisione. Consulta Capacità e requisiti.

​
Rimosso

  • Il pannello commerciante non offre più la configurazione di nuovi conti UAEFTS. I conti UAEFTS esistenti restano leggibili. Consulta Conti.

​
Corretto

  • I moduli RFI conservano le voci esistenti quando un revisore aggiunge un nuovo caricamento di documenti, così le risposte precedenti non vengono perse al nuovo invio.
  • Il pannello commerciante riprende le sessioni di conformità ospitate dalle azioni disponibili senza scartare i link validi.
  • I link ospitati ai Termini di servizio ora funzionano per ogni ambito di attività restituito dall’API.
  • Dopo una richiesta di Payment Access nel pannello commerciante, viene aperta l’attività di acquisizione restituita da quella richiesta anziché un’attività di una richiesta precedente.
  • La demo KYB del pannello commerciante ora richiede i campi obbligatori correnti.
  • Un preventivo che riutilizza il wallet di origine come destinationId ora restituisce dettagli utilizzabili 422 quote_direction_invalid prima di avviare qualsiasi operazione del fornitore. Consulta Preventivi e trasferimenti.
  • L’API rifiuta la codifica non valida della stringa di query con un errore 400 invece di normalizzare silenziosamente la richiesta. Consulta Errori e nuovi tentativi.
  • POST /v3/customers/{customerId}/documents ora rifiuta i corpi di richiesta vuoti, non multipart o non validi con un errore 400.

​
2026-08-17

Versione: v3

​
Aggiunto

  • Pubblicato il catalogo v3 Problem Details nella specifica OpenAPI, così gli integratori possono mappare le risposte di errore direttamente dallo schema. Errors.
  • Aggiunto customerId agli eventi webhook di conto v3, permettendoti di correlare l’attività del conto al cliente proprietario senza una lettura successiva. Consulta Webhook.
  • Copertura completa dei campi del profilo individuale V3 nel pannello merchant, così gli operatori di onboarding possono rivedere e modificare ogni campo KYC raccolto tramite l’API v3. Consulta Onboarding dei clienti.
  • Pubblicata una guida di migrazione per sviluppatori v3. Consulta Migrare a v3.

​
Modificato

  • I codici paese di clienti e conti sono ora validati come valori ISO 3166-1 alpha-2 assegnati in fase di scrittura. Le letture tollerano i valori memorizzati legacy, così i record esistenti continuano a essere risolti. Consulta Conti e wallet.
  • La disponibilità di USDC su è ora limitata dalla rete di destinazione, così quote e transfer offrono USDC solo sulle reti effettivamente supportate dalla destinazione.
  • Capability.ready indica che l’abilitazione è approvata, non che esista un conto emesso. Usa accountProvisioning per seguire l’emissione del conto: not_applicable, not_started, in_progress, issued o failed.
  • I caricamenti HEIC da iPhone sono ora accettati come documenti di identità e di indirizzo.

​
Corretto

  • La riesecuzione di una quote già consumata ora restituisce 409 quote_execution_consumed invece di un errore generico. Consulta Quote e transfer.
  • Le letture della lista transfer e le letture degli importi delle quote non generano più errori 500 su grandi risultati storici.
  • Le letture delle parti correlate per clienti individuali non restituiscono più 404.
  • Le righe dei link di verifica nel pannello merchant ora mostrano un’azione Open su ogni riga, e ogni link di task di API viene renderizzato nella vista dei requisiti.