Migrasi token kartu

Jika Anda pindah ke Xendit dari penyedia pembayaran sebelumnya dan ingin memigrasikan data kartu pelanggan yang tersimpan, kami menawarkan cara yang aman dan sesuai dengan PCI-DSS untuk melakukannya melalui layanan Migrasi Token Kartu kami. Panduan ini memandu Anda melalui prosesnya, termasuk cara menyiapkan data, mentransfernya ke Xendit, dan memahami hasilnya.

Overview

Apa itu migrasi token kartu?
Migrasi token kartu memungkinkan Anda untuk mengimpor data kartu pelanggan Anda dari penyedia sebelumnya ke dalam sistem API Kartu & Pembayaran Xendit. Ini berarti pelanggan Anda tidak perlu memasukkan kembali detail kartu mereka — membuat transisi lebih lancar.

Untuk siapa ini?
Merchant yang bermigrasi dari PSP (penyedia layanan pembayaran) lain, terutama yang memiliki fungsi penagihan berulang atau kartu tersimpan.

Cara migrasi

1. Key exchange

Anda dapat menemukan kunci publik PGP di akhir dokumen ini. Anda akan menggunakan ini untuk mengenkripsi file kartu sebelum mengirimkannya kepada kami. Ini menjaga keamanan data selama transmisi.

2. Siapkan file Anda

Kami akan membagikan contoh templat file yang menguraikan bidang mana yang akan disertakan dan format yang kami harapkan.

Card Token Migration File Format - sample input

1.93 KB

Anda mungkin perlu meminta data ini dari penyedia sebelumnya. Setelah file Anda siap, enkripsi menggunakan kunci PGP yang disediakan di Langkah 1.

3. Transfer file

Anda dapat mengirimkan file terenkripsi kepada kami menggunakan salah satu metode berikut:

Opsi 1: Unggah SFTP

Bagikan kunci publik SSH dan alamat IP Anda kepada kami
Kami akan menyediakan akses untuk unggahan SFTP yang aman

Opsi 2: Unggahan S3 yang Ditandatangani Sebelumnya

Kami akan menyediakan URL yang aman dan terbatas waktu
Mengupload file terenkripsi menggunakan link satu kali ini

4. Mulai migrasi

Setelah file diunggah, Xendit akan:

Memvalidasi struktur file
Mulai memproses migrasi di latar belakang

Jika file salah bentuk atau rusak, kami akan memberi tahu Anda dan menghentikan prosesnya.

5. Lacak progres

Xendit akan memantau migrasi dan melacak:

Jumlah total baris yang diproses
Kesalahan yang ditemui (jika ada)
Status pekerjaan migrasi

Anda akan diberi tahu jika ada tindakan yang diperlukan dari pihak Anda.

6. Dapatkan file

Setelah pemrosesan selesai, Anda akan menerima:

File yang berisi token kartu yang berhasil dimigrasikan:

Card Token Migration File Format - sample output

486 Byte

File yang berisi baris yang gagal, dengan alasan

Card Token Migration File Format - sample error output

216 Byte

Anda akan menerima email dengan link untuk mengunduh file hasil

Input file format

Setiap baris mewakili satu kartu pelanggan.

Kolom	Diperlukan?	Deskripsi
`business_id`	Ya	ID Bisnis Xendit Anda. Diperlukan untuk mendukung subakun.
`card_number`	Ya	Nomor kartu lengkap. Akan dienkripsi selama pemrosesan.
`card_expiry_month`	Ya	Format dua digit, misalnya `09`
`card_expiry_year`	Ya	Format empat digit, misalnya `2026`
`network_transaction_id`	Tidak	Fakultatif. Membantu meningkatkan tingkat keberhasilan tagihan di masa mendatang.
`reference_id`	Ya	Pengidentifikasi unik untuk kartu. Tidak boleh diduplikasi.
`card_holder_first_name`	Tidak	Informasi pemegang kartu opsional
`card_holder_last_name`	Tidak
`card_holder_email`	Tidak
`card_holder_phone_number`	Tidak
`billing_details_first_name`	Tidak	Detail penagihan opsional
`billing_details_last_name`	Tidak
`billing_details_email`	Tidak
`billing_details_phone_number`	Tidak

Penting: reference_id harus unik untuk setiap entri. ID duplikat akan menghasilkan kesalahan.

File output

Setelah migrasi selesai, Anda akan menerima dua file CSV:

1. Migrasi yang berhasil

Kolom	Deskripsi
`business_id`	ID Bisnis Xendit Anda
`masked_card_number`	Versi masked dari nomor kartu (misalnya `4111********1111`)
`card_expiry_month`	Bulan kedaluwarsa
`card_expiry_year`	Tahun kedaluwarsa
`reference_id`	Referensi asli Anda untuk kartu ini
`card_token_id`	Token yang dihasilkan di Cards API Xendit
`payments_api_token_id`	Token yang dihasilkan di Payments API Xendit
`status`	Seharusnya `SUCCESS`

2. Migrasi yang gagal

Hanya baris yang gagal dimigrasikan yang akan muncul dalam file ini.

Kolom	Deskripsi
Kolom yang sama dengan file sukses
`status`	`FAILED`
`error_code`	Kode kesalahan yang dihasilkan sistem
`error_message`	Penjelasan masalah yang dapat dibaca manusia

Kemungkinan alasan kegagalan

Error	Deskripsi
`INVALID_CARD`	Nomor kartu salah (cek Luhn) atau kedaluwarsa. Kami tidak memeriksa apakah kartu sudah kedaluwarsa, tetapi kami memeriksa apakah kedaluwarsa berlaku (misalnya bulan tidak boleh 13)
`EXTERNAL_ID_ALREADY_USED_ERROR`	Dilemparkan ketika ada id referensi duplikat, baik dalam file yang sama atau pada token yang ada yang digunakan di bawah 1 acccount.
`MISSING_DATA`	Ketika baris tidak memiliki data wajib (kolomwajib): `card_number`, `card_expiry_month` `card_expiry_year` `reference_id`)
`BUSINESS_NOT_FOUND`	Kapan `business_id` ditentukan (bidang opsional) tetapi tidak valid.
`INTERNAL_ERROR`	Kesalahan umum, menangkap kesalahan lain, seharusnya tidak terjadi. Perlu dukungan untuk menyelesaikan masalah jika terjadi.

Keamanan dan jepatuhan

Semua file harus dienkripsi menggunakan kunci publik PGP yang disediakan oleh Xendit
Data Anda tidak pernah disimpan dalam teks biasa
Proses ini sesuai dengan standar PCI-DSS dari ujung ke ujung

Kunci PGP Publik:

Butuh Bantuan?

Tim Manajemen Akun dan Kesuksesan Pelanggan kami tersedia untuk:

Membantu memformat file Anda
Memperjelas persyaratan lapangan
Memandu Anda melalui proses pengunggahan dan migrasi
Membantu mengatasi kesalahan apa pun