Als je herbruikbare betaalmethoden verwerkt op 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 hulpprogramma voor gegevensmigratie ingebouwd in het Stripe-dashboard. 

Hoe krijg ik toegang tot dit hulpprogramma voor migratie?

Je kunt dit hulpprogramma openen via de volgende link naar je dashboard. Als je dit nog niet hebt gedaan, wordt je eerst gevraagd of je je wilt aanmelden voor een bètaversie van Workbench. Accepteer dit door de optie “aan de slag met Workbench-migratie” te selecteren. 

De hoofdpagina van het hulpprogramma bestaat uit het tabblad “Overzicht”. Hiermee 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 het hulpprogramma voor migratie 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 het hulpprogramma dat je geen Sources-objecten hebt gemaakt in de afgelopen 24 uur. 

Kan ik het hulpprogramma voor migratie meermaals uitvoeren? 

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

Is het hulpprogramma voor migratie veilig? Kan ik het 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 het hulpprogramma testen voordat ik het in de productieomgeving ga toepassen?

Je kunt het hulpprogramma gebruiken in de testmodus. Activeer de testmodus in het Stripe-dashboard via de schakeloptie “Testmodus” rechtsboven in het scherm. Als alternatief ga je naar https://dashboard.stripe.com/test/dashboard. 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 het hulpprogramma voor migratie voor mij als een Connect-platform?

Als alle Source-objecten rechtstreeks gekoppeld zijn aan je platformaccount, kun je het hulpprogramma gebruiken zoals het 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 hier contact opnemen als je klaar bent om je migratie te voltooien en direct met ons wilt samenwerken om deze stap te voltooien voor een groot aantal gekoppelde accounts.