Migrasi Langganan ke Dodo Payments - Dodo Payments Documentation

Apa itu migrasi langganan?

Migrasi langganan memindahkan pelanggan yang ada dari pemroses pembayaran lama Anda ke Dodo Payments, memberikan Anda satu sumber kebenaran untuk semua data pelanggan Anda. Tanpa migrasi, pelanggan yang telah Anda akuisisi hingga saat ini tetap berada di sistem lama Anda, dan hanya pelanggan baru yang akan terlihat di Dodo Payments. Proses migrasi memastikan pengalaman penagihan yang mulus bagi pelanggan Anda—mereka tidak perlu memasukkan kembali detail pembayaran mereka atau mengalami gangguan pada langganan mereka.

Saat ini, kami hanya mendukung migrasi untuk token kartu. Apple Pay, Google Pay, dan metode pembayaran dompet lainnya tidak dapat dipindahkan antara penyedia pembayaran karena pembatasan tokenisasi yang diberlakukan oleh penyedia ini.

Ikhtisar proses migrasi

Proses migrasi langganan terdiri dari tiga bagian kunci:

Transfer metode pembayaran — Transfer aman data kartu sensitif dari pemroses Anda saat ini
Transfer data pelanggan — Ekspor detail pelanggan, rencana langganan, dan jadwal penagihan
Impor dan validasi — Menyatukan metode pembayaran dan data pelanggan di Dodo Payments

Untuk memulai migrasi langganan, hubungi tim dukungan kami. Mereka akan menghubungkan Anda dengan Solutions Engineer khusus yang akan memandu Anda melalui seluruh proses.

Persyaratan

Sebelum memulai migrasi, pastikan Anda memenuhi persyaratan berikut:

PCI DSS compliance verification

Dodo Payments memenuhi standar PCI DSS Level 1. Untuk memenuhi kewajiban kepatuhan, kami hanya dapat menerima data kartu dari penyedia pembayaran lain yang juga mematuhi PCI DSS Level 1.Pemroses Anda saat ini harus menyediakan:

Attestation of Compliance (AOC) PCI mereka yang terbaru, atau daftar mereka di Global Registry of Service Providers Visa
Konfirmasi bahwa mereka mendukung ekspor data kartu yang aman

Lihat Attestation of Compliance (AOC) kami untuk dibagikan kepada penyedia Anda saat ini.

Dodo Payments integration

Selesaikan integrasi Dodo Payments Anda dan pastikan semua pelanggan baru diarahkan ke checkout Dodo Payments sebelum memulai migrasi. Ini mencegah inkonsistensi data selama periode transisi.

Data access authorization

Pastikan Anda memiliki otorisasi yang diperlukan untuk meminta ekspor data dari penyedia Anda saat ini. Ini biasanya memerlukan:

Verifikasi pemilik akun
Otorisasi tertulis untuk akses data sensitif
Penyelesaian langkah verifikasi keamanan dari penyedia Anda

Panduan migrasi langkah demi langkah

Request payment method export from your current processor

Hubungi tim dukungan penyedia pembayaran Anda saat ini dan ajukan permintaan resmi untuk ekspor lengkap token kartu pelanggan Anda.Anda perlu:

Memberikan verifikasi identitas dan otorisasi Anda
Meminta mereka untuk mengenkripsi ekspor menggunakan kunci publik PGP Dodo Payments (disediakan di bawah)
Meminta mereka untuk mentransfer file terenkripsi langsung ke server SFTP aman kami

Transfer yang aman dilakukan langsung dari server ke server melalui SFTP. Solutions Engineer Anda akan menyediakan kredensial SFTP untuk dibagikan kepada penyedia Anda saat ini.

Rata-rata, proses ini memakan waktu sekitar 2 minggu, meskipun waktu bisa bervariasi tergantung kebijakan dan waktu respons penyedia Anda saat ini.

Prepare subscriber data export

Sementara transfer metode pembayaran sedang berlangsung, ekspor data pelanggan Anda dari sistem lama. Solutions Engineer Anda akan menyediakan templat CSV dan memandu Anda melalui kolom yang dibutuhkan.

Data pelanggan yang diperlukan

Field	Description
`customer_id`	Pengidentifikasi pelanggan internal Anda
`email`	Alamat email pelanggan
`name`	Nama lengkap pelanggan
`country`	Kode negara dua huruf (ISO 3166-1 alpha-2)
`currency`	Kode mata uang tiga huruf (ISO 4217)
`payment_amount`	Jumlah langganan dalam satuan mata uang terkecil
`payment_interval`	Frekuensi penagihan (bulanan, tahunan, dll.)
`next_billing_date`	Tanggal penagihan berikutnya yang dijadwalkan (ISO 8601)
`card_token`	Token unik dari penyedia Anda saat ini

Field card_token sangat penting—digunakan untuk mencocokkan catatan pelanggan dengan metode pembayarannya selama impor. Pastikan ini sesuai persis dengan token dalam ekspor metode pembayaran.

Format data contoh

{
  "customers": [
    {
      "customer_id": "cus_abc123",
      "email": "jane.doe@example.com",
      "name": "Jane Doe",
      "country": "US",
      "currency": "USD",
      "payment_amount": 2999,
      "payment_interval": "monthly",
      "next_billing_date": "2025-01-15T00:00:00Z",
      "card_token": "tok_xyz789",
      "metadata": {
        "plan": "pro",
        "signup_source": "website"
      }
    }
  ]
}

Validation and testing

Sebelum tanggal impor, tim kami akan:

Memverifikasi integritas file dan enkripsi data metode pembayaran
Memvalidasi CSV pelanggan Anda untuk format yang benar
Melakukan impor uji di lingkungan sandbox kami
Mengidentifikasi dan menyelesaikan masalah pemetaan data apa pun

Anda akan menerima laporan validasi yang mengonfirmasi semuanya siap untuk impor produksi.

Production import

Pada tanggal impor yang disepakati, tim engineering kami akan:

Mengimpor data metode pembayaran ke dalam Card Vault kami yang compliant PCI
Mengimpor data pelanggan Anda
Mencocokkan pelanggan dengan metode pembayaran mereka menggunakan token kartu
Mengaktifkan semua langganan yang dimigrasi

Waktu pemrosesan tipikal adalah 2-3 hari kerja untuk migrasi standar, tergantung pada volume pelanggan.

Post-migration verification

Setelah impor selesai, Anda akan menerima:

Laporan migrasi yang komprehensif
CSV yang memetakan ID langganan lama Anda ke ID Dodo Payments baru
Akses ke semua pelanggan yang dimigrasi di dasbor Dodo Payments Anda

Kami merekomendasikan:

Memverifikasi sampel langganan yang dimigrasikan di dashboard Anda
Menguji beberapa pembaruan langganan dalam mode sandbox
Memperbarui referensi basis data internal dengan ID baru
Menjalankan pemantauan paralel untuk siklus penagihan pertama

Data yang dapat dimigrasi

Data berikut dapat dipindahkan selama migrasi langganan:

Tipe data	Didukung	Catatan
Nomor kartu kredit/debit	✅	Terenkripsi melalui PGP
Tanggal kedaluwarsa kartu	✅
Nama pemegang kartu	✅
Alamat penagihan	✅
Alamat email pelanggan	✅
Metadata pelanggan	✅	Pasangan kunci-nilai kustom
Detail langganan	✅	Rencana, jumlah, interval
Token Apple Pay	❌	Tidak dapat dipindahkan
Token Google Pay	❌	Tidak dapat dipindahkan
Token dompet lainnya	❌	Tidak dapat dipindahkan
Riwayat pembayaran	❌	Ekspor dari pemroses Anda saat ini

Riwayat pembayaran dan catatan transaksi tidak dapat dimigrasikan. Kami menyarankan mengekspor data ini dari penyedia Anda saat ini untuk arsip Anda sebelum menyelesaikan transisi.

Enkripsi PGP

Untuk keamanan maksimum saat mentransfer data kartu sensitif, semua file harus dienkripsi menggunakan kunci publik PGP kami. Ini memberikan lapisan perlindungan tambahan di luar enkripsi tingkat transport. Bagikan kunci ini dengan pemroses pembayaran Anda saat ini untuk mengenkripsi ekspor data kartu:

Dodo Payments PGP Public Key

Harapan timeline

Fase	Durasi
Pengaturan awal dan perencanaan	1-2 hari
Transfer metode pembayaran	~2 minggu
Persiapan data pelanggan	3-5 hari (paralel)
Validasi dan pengujian	2-3 hari
Impor produksi	2-3 hari kerja
Verifikasi pasca-migrasi	1-2 hari

Total migrasi biasanya memakan waktu 3-4 minggu dari awal hingga selesai. Memulai persiapan data pelanggan saat transfer metode pembayaran sedang berlangsung membantu meminimalkan keseluruhan waktu.

Mulai

Siap untuk memigrasi langganan Anda ke Dodo Payments? Hubungi tim kami untuk memulai proses:

Contact Support

Hubungi kami untuk memulai migrasi Anda dan terhubung dengan Solutions Engineer.

API Documentation

Jelajahi API kami untuk memahami cara kerja langganan di Dodo Payments.

​Apa itu migrasi langganan?

​Ikhtisar proses migrasi

​Persyaratan

​Panduan migrasi langkah demi langkah

​Data pelanggan yang diperlukan

​Format data contoh

​Data yang dapat dimigrasi

​Enkripsi PGP

​Harapan timeline

​Mulai

Contact Support

API Documentation

Apa itu migrasi langganan?

Ikhtisar proses migrasi

Persyaratan

Panduan migrasi langkah demi langkah

Data pelanggan yang diperlukan

Format data contoh

Data yang dapat dimigrasi

Enkripsi PGP

Harapan timeline

Mulai