Se stai elaborando modalità di pagamento riutilizzabili nell'API Sources (addebito diretto SEPA, addebito diretto Bacs o Alipay), dovrai completare la migrazione dei dati per convertire gli oggetti Sources riutilizzabili in PaymentMethods. In questo modo potrai continuare a elaborare pagamenti ricorrenti senza interruzioni per i tuoi clienti esistenti. Per guidarti passo dopo passo in questa procedura di migrazione, abbiamo creato uno strumento di migrazione dei dati nella Dashboard di Stripe.
Come faccio ad accedere a questo strumento di migrazione?
Puoi accedere allo strumento tramite questo link alla Dashboard. Se non l'hai ancora fatto, per prima cosa ti verrà chiesto di attivare la versione beta di Workbench. Accetta selezionando "Inizia la migrazione con Workbench".
La pagina principale dello strumento è la scheda "Riepilogo", progettata per:
Una volta interrotta l'elaborazione dei pagamenti tramite l'API Sources, tutte le modalità di pagamento mostreranno dei segni di spunta verdi, a conferma del completamento della migrazione.
Accanto alla scheda "Riepilogo", vedrai un'ulteriore scheda per ciascuna modalità di pagamento riutilizzabile che richiede la migrazione dei dati. Questa scheda avrà il titolo "Esegui la migrazione di {type} Sources" dove {type} sta per "Addebito diretto SEPA", "Addebito diretto Bacs" o "Alipay".
Questa scheda ti guiderà passo dopo passo nella procedura di migrazione. Andando avanti con la procedura, ogni passaggio verrà evidenziato sulla sinistra, mentre le istruzioni corrispondenti per completare tale passaggio verranno visualizzate sulla destra.
Quando dovrei usare lo strumento di migrazione?
Ti consigliamo di eseguire la migrazione dopo aver eseguito la migrazione della tua integrazione per usare le API PaymentIntents e PaymentMethods. In questo modo non creerai ulteriori oggetti Sources riutilizzabili. Per prima cosa lo strumento si accerta che tu non abbia creato oggetti Sources nelle ultime 24 ore.
Posso eseguire lo strumento di migrazione per più volte?
Ti consigliamo di eseguire la migrazione una tantum per trasferire tutti gli oggetti Sources in una sola volta. Tuttavia, se hai bisogno di eseguire nuovamente lo strumento di migrazione, è possibile farlo in tutta sicurezza. Per prima cosa, lo strumento verifica se è già stata eseguita la migrazione di un oggetto Sources e creerà solo PaymentMethods per oggetti che non sono già stati trasferiti.
Lo strumento di migrazione è sicuro? Posso usarlo senza interruzioni al mio flusso di pagamento?
Sì, la procedura di conversione da Sources a PaymentMethods (passaggio 2) è sicura. Entrambe le serie di oggetti, la vecchia Sources e la nuova PaymentMethods, saranno attive e addebitabili (in grado di creare pagamenti), per cui la conversione non interromperà i tuoi flussi di pagamento.
Gli oggetti più nuovi non verranno usati nei flussi di pagamento finché non avrai aggiornato il tuo codice o impostato i nuovi PaymentMethods come predefiniti su Clienti, Fatture o Abbonamenti nel passaggio 4. L'unico passaggio irreversibile è il numero 6, che rimuoverà i vecchi oggetti Sources e non ne consentirà il riutilizzo. Prima di eseguire tale passaggio, verifica di aver rimosso tutti i riferimenti ai vecchi oggetti Sources dalla tua base di codice e di aver eseguito gli aggiornamenti ai riferimenti necessari affinché contengano i nuovi PaymentMethods.
Come faccio a testare lo strumento prima di eseguirlo in produzione?
Puoi usare lo strumento di migrazione in modalità di test attivando la Dashboard Stripe in modalità di test con il pulsante di attivazione/disattivazione "Modalità di test" nell'angolo in alto a destra della schermata. In alternativa, accedi alla pagina https://dashboard.stripe.com/test/dashboard. Una volta impostata la Dashboard in modalità di test, puoi eseguire la migrazione di qualsiasi oggetto di test riutilizzabile esistente (o usare l'API Stripe per creare nuovi oggetti in modalità di test da trasferire).
Come funziona lo strumento di migrazione per me che sono una piattaforma Connect?
Se tutti gli oggetti Sources sono direttamente associati al tuo account della piattaforma, puoi usare lo strumento di migrazione come illustrato e seguire la procedura di migrazione dati descritta sopra.
Tuttavia, se gli oggetti Sources sono associati ai tuoi account connessi, puoi accedere alla Dashboard Stripe di ciascun account connesso per completare la migrazione dei dati per loro conto. Comprendiamo che il completamento di tali passaggi possa essere piuttosto tedioso se hai molti account connessi. Stiamo lavorando a un approccio migliore e, una volta trovata una soluzione, informeremo le piattaforme. Nel frattempo, se è tutto pronto per effettuare la migrazione e vorresti collaborare direttamente con noi per eseguire questo passaggio per un numero elevato di account connessi, contattaci qui.