Als je herbruikbare betaalmethoden verwerkt in de Sources-API (SEPA-incasso, BACS Direct Debit of Alipay), moet je een gegevensmigratie uitvoeren om je herbruikbare Sources-objecten te converteren naar PaymentMethods-objecten. Zo kun je terugkerende betalingen blijven verwerken zonder onderbreking voor je bestaande klanten. Om je stap voor stap door dit migratieproces te begeleiden, hebben we een tool voor gegevensmigratie gemaakt in het Stripe-dashboard. 

Hoe krijg ik toegang tot deze migratietool?

Je kunt de tool openen met deze link naar het dashboard. Als je dit nog niet hebt gedaan, wordt je eerst gevraagd of je je wilt aanmelden voor een preview-versie van Workbench. Accepteer dit door de optie 'aan de slag met Workbench-migratie' te selecteren. 

De hoofdpagina van de tool bestaat uit het tabblad Overzicht. Hier kun je het volgende doen:

• Duidelijk maken welke LPM's je in het verleden hebt geaccepteerd via de Sources-API
• Met een rode 'x' aanduiden welke betaalmethoden je via de Sources-API hebt geaccepteerd in de laatste 24 uur, in de laatste 7 dagen of in de laatste 31 dagen. 

Zodra je bent gestopt met het verwerken van betalingen via de Sources-API, zijn de vinkjes van alle betaalmethoden groen om te bevestigen dat je de migratie hebt voltooid.

Naast het tabblad Overzicht vind je een extra tabblad voor elke herbruikbare betaalmethode waarvoor gegevensmigratie is vereist. Dit tabblad heet '{type}-bronnen migreren' waarbij {type} staat voor SEPA-incasso, BACS Direct Debit of Alipay.

Dit tabblad leidt je stap voor stap door het migratieproces. Tijdens dit proces wordt elke stap aan de linkerkant gemarkeerd, met de bijbehorende instructies voor het voltooien van die stap aan de rechterkant. 

Wanneer moet ik de migratietool gebruiken? 

We raden aan om de migratie uit te voeren nadat je je integratie hebt gemigreerd om de PaymentIntents-API en PaymentMethods-API te gebruiken, zodat je geen nieuwe herbruikbare Source-objecten meer maakt. Als eerste stap controleert de tool of je geen Sources-objecten hebt gemaakt in de afgelopen 24 uur. 

Kan ik de migratietool meermaals uitvoeren? 

We raden je aan om de migratie eenmalig uit te voeren en alle Source-objecten in één keer te migreren. Als je de tool opnieuw moet uitvoeren, kan dat veilig gebeuren. De tool controleert eerst of er al een Source-object is gemigreerd en maakt alleen PaymentMethods voor objecten die nog niet zijn gemigreerd. 

Is de migratietool veilig? Kan ik deze gebruiken zonder onderbrekingen in mijn betalingsstroom?

Ja, je kunt Sources veilig converteren naar PaymentMethods (stap 2). Beide sets met objecten, zowel de oude Sources-objecten en de nieuwe PaymentMethods-objecten, zijn actief en klaar om betalingen te maken. Je betalingsstromen worden dus niet onderbroken.

De nieuwere objecten worden pas gebruikt in je betalingsstromen nadat je je code hebt bijgewerkt of de nieuwe PaymentMethods als standaard hebt ingesteld voor klanten, facturen of abonnementen in stap 4. De enige stap die niet kan worden teruggedraaid is stap 6. Hierin worden de oude Sources-objecten losgekoppeld om te voorkomen dat ze opnieuw kunnen worden gebruikt. Voordat je deze stap uitvoert, moet je ervoor zorgen dat je alle verwijzingen naar oudere Sources-objecten uit je codebasis hebt verwijderd en de nodige updates hebt uitgevoerd om in plaats daarvan naar de nieuwe PaymentMethods te verwijzen.

Hoe kan ik de tool testen voordat ik deze in de productieomgeving ga toepassen?

Je kunt de migratietool gebruiken in de testmodus. Activeer de testmodus in het Stripe-dashboard via de schakeloptie Testmodus rechtsboven in het scherm. Je kunt ook naar https://dashboard.stripe.com/test/dashboard gaan. Zodra het dashboard in testmodus staat, kun je de migratie uitvoeren op alle bestaande herbruikbare testobjecten (of gebruik de Stripe-API om nieuwe objecten in de testmodus te maken om te migreren).

Hoe werkt de migratietool voor mij als Connect-platform?

Als alle Source-objecten rechtstreeks gekoppeld zijn aan je platformaccount, kun je de tool gebruiken zoals deze is ontworpen, en het gegevensmigratieproces volgen zoals hierboven beschreven.

Als de Source-objecten echter zijn gekoppeld aan je gekoppelde accounts, kun je je aanmelden op het Stripe-dashboard van elk gekoppeld account om de gegevensmigratie namens die accounts te voltooien. We begrijpen dat dit vervelend kan zijn als je veel gekoppelde accounts hebt. We werken daarom ook aan een betere aanpak en bieden platforms een update zodra er een oplossing is. In de tussentijd kun je contact opnemen met ondersteuning als je klaar bent om je migratie te voltooien en direct met ons wilt samenwerken om deze stap uit te voeren voor een groot aantal gekoppelde accounts.