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 mengonversikan Sources yang dapat digunakan kembali menjadi PaymentMethods. Hal ini akan memungkinkan Anda melanjutkan pemrosesan pembayaran rutin tanpa gangguan kepada pelanggan yang ada. Untuk memandu Anda menjalani proses migrasi langkah demi langkah, kami telah membuat alat migrasi data di Dashboard Stripe. 

Bagaimana cara mengakses alat migrasi ini?

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

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

• Memperjelas LPM mana saja yang pernah Anda terima lewat Sources API
• Memberi tanda "x" merah pada metode pembayaran yang telah menerima pembayaran lewat Sources API dalam 24 jam terakhir, 7 hari terakhir, atau 31 hari terakhir. 

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 menjalani proses migrasi langkah demi langkah. 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 agar Anda menjalankan migrasi setelah memigrasikan 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 apakah Anda belum membuat Sources dalam 24 jam terakhir. 

Dapatkah saya menjalankan alat migrasi beberapa kali? 

Kami merekomendasikan agar Anda menjalankan migrasi satu kali untuk memigrasikan semua objek Source sekaligus. 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, aman mengonversikan Sources ke PaymentMethods (langkah 2). 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 hingga Anda memperbarui kode atau mengatur PaymentMethods yang baru sebagai default pada Pelanggan, Invoice, atau Langganan 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 sebagai ganti 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 memigrasikan).

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 menjemukan dilakukan 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 menyelesaikan migrasi dan ingin bekerja sama dengan kami secara langsung untuk menyelesaikan langkah ini bagi banyak akun terhubung, hubungi Tim CS.