Migrasi objek yang dapat digunakan kembali dari Sources ke Payment Intents

Jika Anda memproses metode pembayaran yang dapat digunakan kembali pada Sources API (Debit Langsung SEPA, Debit Langsung Bacs, atau Alipay), Anda nantinya perlu menyelesaikan migrasi data untuk mengonversi Sources yang dapat digunakan kembali menjadi PaymentMethods. Ini akan memungkinkan Anda terus memproses pembayaran rutin tanpa gangguan kepada pelanggan yang sudah ada. Untuk memandu Anda melalui seluruh proses migrasi, kami telah membangun alat migrasi data di Dashboard Stripe. 

Bagaimana cara mengakses alat migrasi ini?

Anda dapat mengakses alat tersebut dengan mengikuti tautan ini ke Dashboard. Jika Anda belum melakukannya, pertama-tama Anda akan diminta ikut serta dalam versi beta untuk Workbench - terimalah dengan memilih “mulai bermigrasi dengan Workbench.” 

Halaman utama dari alat ini adalah tab "Ringkasan", yang dirancang untuk:

Setelah Anda berhenti memproses pembayaran lewat Sources API, semua metode pembayaran akan menampilkan tanda centang hijau, yang mengonfirmasi bahwa Anda telah menyelesaikan migrasi.

Di samping tab "Ringkasan", Anda akan melihat tab tambahan untuk setiap metode pembayaran yang dapat digunakan kembali yang memerlukan migrasi data. Tab ini akan diberi judul "Migrasikan {type} Sources” dengan {type} yang merupakan "Debit Langsung SEPA", "Debit Langsung Bacs", atau "Alipay".


Tab ini akan memandu Anda melalui seluruh proses migrasi. Saat Anda menjalankan prosesnya, setiap langkah akan disorot di sisi kiri, dengan petunjuk yang sesuai untuk menyelesaikan langkah tersebut di sisi kanan. 

Kapan saya harus menggunakan alat migrasi? 

Kami merekomendasikan Anda menjalankan migrasi setelah melakukan migrasi integrasi untuk menggunakan PaymentIntents API dan PaymentMethods API sehingga Anda tidak lagi membuat objek Source baru yang dapat digunakan kembali. Langkah pertama dari alat ini memeriksa bahwa Anda belum membuat Sources dalam 24 jam terakhir. 

Dapatkah saya menjalankan alat migrasi beberapa kali? 

Kami merekomendasikan Anda menjalankan migrasi satu kali untuk melakukan migrasi semua objek Source dalam sekali jalan. Namun, jika perlu menjalankan ulang alat migrasi, Anda dapat melakukannya dengan aman. Alat ini terlebih dahulu memeriksa apakah objek Source sudah dimigrasikan dan hanya akan membuat PaymentMethods untuk objek yang belum pernah dimigrasikan. 

Apakah alat migrasi aman digunakan? Dapatkah saya menggunakannya tanpa menyebabkan gangguan pada alur pembayaran?

Ya, mengonversi Sources ke PaymentMethods (langkah 2) adalah tindakan yang aman. Kedua set objek – Sources yang lama dan PaymentMethods yang baru – akan aktif serta dapat di-charge (dapat membuat pembayaran) sehingga konversi tidak akan mengganggu alur pembayaran Anda.

Objek yang baru tidak akan mulai digunakan dalam alur pembayaran sampai Anda memperbarui kode atau mengatur PaymentMethods yang baru sebagai default pada Customers, Invoices, atau Subscriptions di langkah 4. Satu-satunya langkah yang tidak dapat dibalikkan adalah langkah 6, yaitu melepaskan Sources lama dan mencegahnya digunakan kembali. Sebelum menjalankan langkah ini, pastikan Anda telah menghapus semua referensi ke objek Source terdahulu dari basis kode Anda dan melakukan pembaruan yang diperlukan guna mereferensikan PaymentMethods yang baru.

Bagaimana cara mencoba alat ini sebelum menjalankannya di lingkungan produksi?

Anda dapat menggunakan alat migrasi dalam mode percobaan dengan mengalihkan Dashboard Stripe ke mode percobaan menggunakan tombol “Mode percobaan” di kanan atas layar. Atau, Anda dapat membuka https://dashboard.stripe.com/test/dashboard. Setelah Dashboard berada dalam mode percobaan, Anda dapat menjalankan migrasi pada objek percobaan yang dapat digunakan kembali (atau menggunakan API Stripe untuk membuat objek mode percobaan baru guna dimigrasikan).

Bagaimana cara kerja alat migrasi bagi saya sebagai Platform Connect?

Jika semua objek Source secara langsung dikaitkan dengan akun platform, Anda dapat menggunakan alat migrasi sesuai rancangan penggunaan dan mengikuti proses migrasi data seperti yang dijelaskan di atas.

Namun, jika objek Source dikaitkan dengan akun terhubung, Anda dapat masuk ke Dashboard Stripe setiap akun terhubung untuk menyelesaikan migrasi data atas nama akun tersebut. Kami memahami bahwa cara tersebut mungkin menyusahkan jika Anda memiliki banyak akun terhubung - kami sedang mengupayakan pendekatan yang lebih baik dan akan mengabari platform setelah solusinya tersedia. Sementara itu, jika Anda sudah siap menjalankan migrasi dan ingin bekerja sama dengan kami secara langsung untuk menyelesaikan langkah ini bagi banyak akun terhubung, hubungilah kami di sini.