Migrering av återanvändbara objekt från Sources till Payment Intents

Om du behandlar återanvändbara betalningsmetoder i Sources API (SEPA-autogiro, Bacs Direct Debit eller Alipay) måste du göra en datamigrering för att konvertera dessa till PaymentMethods. Därefter kan du fortsätta behandla återkommande betalningar utan avbrott för dina befintliga kunder. För att underlätta migreringsprocessen har vi tagit fram ett datamigreringsverktyg i Stripe Dashboard som hjälper dig steg för steg. 

Hur får jag åtkomst till det här verktyget?

Du får åtkomst till verktyget genom att följa den här länken till Dashboard. Om du inte redan har gjort det kommer du först att bli tillfrågad om du vill delta i en betaversion av Workbench – acceptera genom att välja Starta migreringen med Workbench. 

Verktygets startsida är fliken Sammanfattning, vars syfte är att:

När du har slutat använda Sources API för att ta emot betalningar kommer alla betalningsmetoder att ha en grön bock för att visa att du har genomfört migreringen.

Bredvid fliken Sammanfattning hittar du ytterligare en flik för varje återanvändbar betalningsmetod som kräver datamigrering. Den fliken kommer att heta Migrera Sources för {type}, där {type} är SEPA-autogiro, Bacs Direct Debit eller Alipay.


I fliken hittar du alla steg i migreringsprocessen. I takt med att du arbetar dig igenom processen markeras varje steg på vänster sida. På höger sida hittar du tillhörande instruktioner för att slutföra steget. 

När ska jag använda migreringsverktyget? 

Vi rekommenderar att du gör migreringen efter att du har migrerat din integration till att använda PaymentIntents API och PaymentMethods API så att du inte längre skapar nya återanvändbara Source-objekt. Verktygets första steg är att kontrollera att du inte har skapat några Sources de senaste 24 timmarna. 

Kan jag köra verktyget flera gånger? 

Vi rekommenderar att du gör en enda migrering så att alla Source-objekt migreras samtidigt. Om du behöver använda verktyget på nytt kan du dock göra det utan problem. Verktyget kontrollerar först om ett Source-objekt redan har migrerats och skapar enbart PaymentMethods för objekt som inte har migrerats än. 

Är verktyget säkert? Kan jag använda det utan att det blir avbrott i mitt betalningsflöde?

Ja, det är säkert att konvertera Sources till PaymentMethods (steg 2). Både gamla Source-objekt och nya PaymentMethods-objekt kommer att vara aktiva och kan användas för att skapa betalningar. Konverteringen kommer alltså inte att orsaka avbrott i dina betalningsflöden.

De nyare objekten kommer inte att användas i dina betalningsflöden förrän du har uppdaterat koden eller angett nya PaymentMethods som standard för objekten Customer, Invoice eller Subscriptions i steg 4. Det enda steget som inte kan ångras är steg 6, som kopplar bort gamla Sources och förhindrar att de används igen. Innan du genomför det här steget måste du säkerställa att du har tagit bort alla referenser till utfasade Source-objekt från din kodbas och gjort alla nödvändiga uppdateringar för att använda nya PaymentMethods i stället.

Hur kan jag testa verktyget innan jag använder det?

Du kan använda verktyget i testläge genom att växla till testläget uppe till höger i Stripe Dashboard. Alternativt kan du gå till https://dashboard.stripe.com/test/dashboard. Med Dashboard i testläge kan du köra migreringen på valfria återanvändbara testobjekt (eller använda Stripes API för att skapa nya testobjekt att migrera).

Hur kommer verktyget att fungera för någon som har en Connect-plattform?

Om alla Source-objekt är direkt kopplade till ditt plattformskonto kan du använda migreringsverktyget på samma sätt som beskrivs ovan.

Om Source-objekten däremot är kopplade till dina anslutna konton måste du logga in på varje enskilt anslutet kontos Dashboard och genomföra migreringen å deras vägnar. Vi förstår att det inte är optimalt om man har många anslutna konton och vi arbetar med att ta fram ett smidigare tillvägagångssätt. Vi meddelar plattformar så snart vi har hittat en lösning. Under tiden kan du kontakta support om du är redo att börja migreringen och vill arbeta med oss direkt för att migrera ett stort antal anslutna konton.