# Minta impor data pembayaran Impor data pembayaran sensitif dengan aman. Stripe memungkinkan Anda mempertahankan data pelanggan dan pembayaran yang sudah ada saat Anda bermigrasi ke Stripe. Kami akan bekerja sama dengan tim Anda dan penyedia pembayaran saat ini, jika diperlukan, untuk memigrasikan informasi Anda secara aman. Proses ini memungkinkan Anda menerima dan men-charge pelanggan baru di Stripe serta terus men-charge pelanggan yang sudah ada dengan pemroses Anda saat ini hingga migrasi selesai. Pelanggan Anda tidak mengalami downtime. Setelah proses migrasi selesai, Anda dapat memproses semua pembayaran di Stripe. Panduan ini menjelaskan cara bermigrasi ke Stripe dari pemroses pembayaran lain atau solusi pembayaran custom. Anda juga akan membangun integrasi Stripe yang dapat diuji sebelum sistem tersebut diaktifkan. Jika Anda memiliki pertanyaan mengenai proses migrasi atau integrasi dengan Stripe, silakan lihat [dukungan](https://support.stripe.com/topics/migration). Jika belum, silakan [tinjau harga Stripe](https://stripe.com/pricing). Jika Anda perlu mentransfer informasi pembayaran yang sensitif, Anda harus menyelesaikan [permintaan migrasi data](https://support.stripe.com/questions/request-a-data-migration) sebelum bermigrasi. Kami dapat membantu melakukannya dengan aman dan *sesuai dengan standar PCI* (Any party involved in processing, transmitting, or storing credit card data must comply with the rules specified in the Payment Card Industry (PCI) Data Security Standards. PCI compliance is a shared responsibility and applies to both Stripe and your business). ## Meninjau fitur integrasi Stripe Stripe menyederhanakan persyaratan keamanan Anda sehingga pelanggan Anda tidak perlu meninggalkan situs Anda untuk menyelesaikan pembayaran. Kami melakukan ini melalui kombinasi langkah-langkah di sisi client dan sisi server: 1. Dari situs web Anda yang berjalan di browser pelanggan, Stripe mengumpulkan detail pembayarannya dengan aman. 1. Stripe merespons dengan token representatif. 1. Browser mengirimkan token ke server Anda, bersama data formulir lainnya. 1. Kode sisi server Anda menggunakan token itu dalam permintaan API (misalnya, ketika [membuat charge](https://docs.stripe.com/payments/charges-api.md)). Pendekatan ini menyederhanakan alur checkout di situs web Anda, sementara informasi pembayaran yang sensitif tidak pernah menyentuh server Anda. Hal ini memungkinkan Anda untuk beroperasi sesuai dengan peraturan [kepatuhan PCI](https://docs.stripe.com/security/guide.md#validating-pci-compliance), yang dapat menghemat waktu dan memberikan manfaat finansial. ![Alur proses pembayaran Stripe](https://b.stripecdn.com/docs-statics-srv/assets/charge-workflow.6d5c025c1b1e62a53803f1908104e0a8.png) Alur proses pembayaran Stripe Dibandingkan pemroses pembayaran lainnya, integrasi Stripe dapat berbeda dalam beberapa hal berikut: - Pelanggan tidak pernah meninggalkan situs web Anda. - Pembuatan token tidak terikat dengan produk atau jumlah spesifik. - Anda tidak perlu membuat kunci sisi client sesuai permintaan. Sebagai gantinya, Anda menggunakan [kunci API](https://docs.stripe.com/keys.md) yang sudah ditetapkan dan dapat dipublikasikan. ## Membuat akun Stripe Sebelum melakukan integrasi dengan Stripe, Anda harus membuat akun Stripe. 1. [Buat Akun](https://dashboard.stripe.com/register) dengan memasukkan alamat email, nama lengkap, negara, serta membuat kata sandi. 1. Lengkapi profil bisnis Anda. 1. Di Dashboard, klik **Verifikasi email Anda**. Stripe akan mengirim email verifikasi ke alamat email Anda. 1. Verifikasi alamat email Anda. ## Membangun integrasi Stripe Untuk semua token pelanggan baru (yang tidak diimpor), implementasikan hal berikut: 1. Gunakan objek [Pelanggan](https://docs.stripe.com/api.md#create_customer) untuk menyimpan informasi kartu. 1. Kumpulkan dan tokenisasi informasi kartu pelanggan menggunakan salah satu [integrasi pembayaran](https://docs.stripe.com/payments/online-payments.md#compare-features-and-availability) yang kami rekomendasikan. Bangun integrasi Stripe Anda sebelum meminta penyedia pembayaran Anda mentransfer data ke Stripe. Untuk sebagian besar startup, kami merekomendasikan membangun integrasi [Checkout Tersemat](https://docs.stripe.com/payments/checkout/how-checkout-works.md), yaitu formulir pembayaran yang disematkan di situs web Anda. Untuk menyiapkan integrasi ini, lihat [Panduan Cepat Checkout Tersemat](https://docs.stripe.com/checkout/embedded/quickstart.md) dan terima pembayaran pembayaran satu kali maupun pembayaran langganan (jika berlaku). 1. [Buat charge](https://docs.stripe.com/api.md#create_charge-customer) untuk pelanggan baru ini. Dengan menggunakan pendekatan ini, Anda dapat menerima pembayaran dari pelanggan baru di Stripe tanpa memengaruhi pelanggan Anda saat ini di pemroses yang sudah ada selama proses migrasi. ### Pertimbangan integrasi Merancang integrasi sebelum Anda meminta pemroses pembayaran untuk mentransfer data ke Stripe adalah cara paling efisien untuk menangani data yang diimpor. Beberapa tindakan yang dapat Anda lakukan sebelum meminta impor meliputi: - [Memetakan ulang catatan pelanggan](https://docs.stripe.com/get-started/data-migrations/pan-import.md#remap-customer-ids) - [Proteksi pembaruan metode pembayaran tersimpan selama migrasi](https://docs.stripe.com/get-started/data-migrations/pan-import.md#handle-card-updates). - Aktifkan semua [optimalisasi](https://docs.stripe.com/payments/analytics/optimization.md), seperti Adaptive Acceptance, pembaru kartu (CAU), dan token jaringan. ## Optional: Petakan pelanggan ke ID Stripe Jika mau, Anda dapat mengonfigurasi integrasi Anda ke [mengimpor data metode pembayaran dari catatan sebelumnya ke objek Customer Stripe yang ada](https://docs.stripe.com/get-started/data-migrations/map-payment-data.md). Melakukannya mencegah migrasi membuat yang baru (mungkin duplikat) pelanggan di akun Stripe Anda untuk setiap ID pelanggan unik dalam file yang kami terima dari pemroses Anda sebelumnya. Setelah migrasi, Anda mungkin masih harus memperbarui beberapa catatan agar sesuai dengan pengidentifikasi [Pelanggan](https://docs.stripe.com/api/customers.md) Stripe baru, jika: - Anda membuat `Customer` Stripe sebelum migrasi, maka kami mengimpor informasi pembayaran untuk memperbaruinya catatan pelanggan ini. - Kami mengimpor informasi pembayaran sebagai catatan pelanggan baru. Misalnya, pelanggan jenny.rosen@example.com mungkin memiliki identifikasi `42` di database Anda, sesuai dengan identifikasi `1893` di sistem pemroses Anda sebelumnya, tetapi identifikasi `cus_12345` di akun Stripe Anda. Dalam hal ini, Anda sekarang harus memetakan identifikasi `42` ke identifikasi Stripe `cus_12345` di database. Stripe menyediakan [file pemetaan](https://docs.stripe.com/get-started/data-migrations/pan-import.md#update-integration) pascaimpor untuk membantu Anda mengidentifikasi pemetaan ulang yang diperlukan. ## Optional: Lindungi pembaruan pada metode pembayaran yang tersimpan Jika pelanggan memperbarui informasi pembayaran mereka dengan pemroses Anda sebelumnya di jendela antara mentransfer data dan menyelesaikan impor, perubahan tersebut akan hilang. Perbarui proses situs Anda untuk menangani update pada pembayaran tersimpan guna mencegah error atau masalah penagihan bagi pelanggan Anda. Ini termasuk persiapan untuk melakukan migrasi mandiri untuk pelanggan mana pun tanpa ID `Customer` Stripe tersimpan: 1. Buat [objek Pelanggan](https://docs.stripe.com/api/customers/object.md) baru di Stripe untuk pelanggan Anda. 1. Lampirkan metode pembayaran ke objek `Customer`. 1. Jika perlu, [migrasikan langganan](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md). Setelah migrasi selesai, Stripe [secara otomatis menangani pembaruan yang dipicu kartu](https://stripe.com/blog/smarter-saved-cards), seperti perubahan tanggal kedaluwarsa. ## Uji integrasi Stripe Anda Untuk mencoba integrasi formulir pembayaran tersemat Anda: 1. Buat Sesi Checkout tersemat dan pasang formulir pembayaran di halaman Anda. 1. Isi detail pembayaran dengan metode dari tabel di bawah ini. - Masukkan tanggal kedaluwarsa kartu di masa mendatang. - Masukkan nomor 3 angka untuk CVC. - Masukkan kode pos penagihan. 1. Klik **Bayar**. Anda akan dialihkan ke `return_url`. 1. Buka Dashboard dan cari pembayaran tersebut di [halaman Transaksi](https://dashboard.stripe.com/test/payments?status%5B0%5D=successful). Jika pembayaran Anda berhasil, pembayaran akan muncul dalam daftar tersebut. 1. Klik pembayaran Anda untuk melihat detail selengkapnya, seperti ringkasan Checkout yang berisi informasi penagihan dan daftar item yang dibeli. Anda dapat menggunakan informasi ini untuk memproses pesanan. Pelajari selengkapnya tentang [mencoba integrasi Anda](https://docs.stripe.com/testing.md). #### Kartu | Nomor kartu | Skenario | Cara mencoba | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | 4242424242424242 | Pembayaran kartu berhasil dan tidak memerlukan autentikasi. | Isilah formulir kartu kredit menggunakan nomor kartu kredit dengan sembarang tanggal kedaluwarsa, CVC, dan kode pos. | | 4000002500003155 | Pembayaran kartu memerlukan *autentikasi* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase). | Isilah formulir kartu kredit menggunakan nomor kartu kredit dengan sembarang tanggal kedaluwarsa, CVC, dan kode pos. | | 4000000000009995 | Kartu ini ditolak dengan kode penolakan seperti `insufficient_funds`. | Isilah formulir kartu kredit menggunakan nomor kartu kredit dengan sembarang tanggal kedaluwarsa, CVC, dan kode pos. | | 6205500000000000004 | Kartu UnionPay memiliki panjang variabel 13–19 angka. | Isilah formulir kartu kredit menggunakan nomor kartu kredit dengan sembarang tanggal kedaluwarsa, CVC, dan kode pos. | #### Dompet | Metode pembayaran | Skenario | Cara mencoba | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Alipay | Pelanggan Anda berhasil membayar menggunakan metode pembayaran dengan [notifikasi segera](https://docs.stripe.com/payments/payment-methods.md#payment-notification) dan berbasis pengarahan ulang. | Pilih sembarang metode pembayaran berbasis pengarahan ulang, isilah detail yang diperlukan, dan konfirmasikan pembayaran. Kemudian klik **Selesaikan pembayaran percobaan** di halaman pengarahan ulang. | #### Pengarahan ulang bank | Metode pembayaran | Skenario | Cara mencoba | | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Debit Langsung BECS | Pelanggan Anda berhasil membayar dengan Debit Langsung BECS. | Isi formulir menggunakan nomor akun `900123456` dan BSB `000000`. PaymentIntent yang telah dikonfirmasi awalnya akan berstatus `processing`, kemudian berubah menjadi status `succeeded` setelah 3 menit. | | Debit Langsung BECS | Pembayaran pelanggan Anda gagal dengan kode kesalahan `account_closed`. | Isi formulir menggunakan nomor akun `111111113` dan BSB `000000`. | | Bancontact, EPS, iDEAL, dan Przelewy24 | Pelanggan Anda gagal melakukan autentikasi di halaman pengarahan ulang untuk metode pembayaran dengan notifikasi segera dan berbasis pengarahan ulang. | Pilih sembarang metode pembayaran berbasis pengarahan ulang, isilah detail yang diperlukan, dan konfirmasikan pembayaran. Kemudian klik **Gagalkan pembayaran percobaan** di halaman pengarahan ulang. | | Pay by Bank | Pelanggan Anda berhasil membayar menggunakan metode pembayaran dengan [notifikasi tertunda](https://docs.stripe.com/payments/payment-methods.md#payment-notification) dan berbasis pengarahan ulang. | Pilih metode pembayaran, isilah detail yang diperlukan, dan konfirmasikan pembayaran. Kemudian klik **Selesaikan pembayaran percobaan** di halaman pengarahan ulang. | | Pay by Bank | Pelanggan Anda gagal melakukan autentikasi di halaman pengarahan ulang untuk metode pembayaran dengan notifikasi tertunda dan berbasis pengarahan ulang. | Pilih metode pembayaran, isilah detail yang diperlukan, dan konfirmasikan pembayaran. Kemudian klik **Gagalkan pembayaran percobaan** di halaman pengarahan ulang. | | BLIK | Pembayaran BLIK gagal dalam berbagai cara — kegagalan langsung (misalnya, kode kedaluwarsa atau tidak valid), kesalahan tertunda (bank menolak) atau waktu habis (pelanggan tidak merespons tepat waktu). | Gunakan pola email untuk [menyimulasikan berbagai kegagalan.](https://docs.stripe.com/payments/blik/accept-a-payment.md#simulate-failures) | #### Debit bank | Metode pembayaran | Skenario | Cara mencoba | | ------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Debit Langsung SEPA | Pelanggan Anda berhasil membayar dengan Debit Langsung SEPA. | Isilah formulir menggunakan nomor akun `AT321904300235473204`. Transisi PaymentIntent yang telah dikonfirmasi awalnya menjadi sedang diproses, kemudian akan berubah menjadi status berhasil setelah tiga menit kemudian. | | Debit Langsung SEPA | Transisi status maksud pembayaran pelanggan dari `processing` menjadi `requires_payment_method`. | Isilah formulir menggunakan nomor akun `AT861904300235473202`. | #### Voucher | Metode pembayaran | Skenario | Cara mencoba | | ----------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | Boleto, OXXO | Pelanggan Anda membayar dengan voucher OXXO atau Boleto. | Pilih Boleto atau OXXO sebagai metode pembayaran dan serahkan pembayaran. Tutup dialog setelah muncul. | Lihat [Pengujian](https://docs.stripe.com/testing.md) untuk mendapatkan informasi tambahan untuk menguji integrasi Anda. ## Minta dan konfirmasikan detail migrasi 1. Setelah Anda menyelesaikan integrasi dan siap memproses pembayaran di Stripe, [minta data pembayaran dari pemroses sebelumnya](https://support.stripe.com/questions/request-data-from-a-current-processor-for-a-data-import-to-stripe). Banyak pemroses mengharuskan pemilik akun untuk meminta transfer data. 1. Masuk ke akun Stripe Anda untuk mengirimkan [formulir permintaan migrasi](https://support.stripe.com/questions/request-a-data-migration) guna mengajukan permintaan impor migrasi. 1. Libatkan Stripe melalui utas email terautentikasi yang kami buat setelah menerima permintaan migrasi Anda. > Jangan pernah mengirim detail kartu kredit sensitif atau informasi pelanggan secara langsung kepada Stripe. Jika Anda memiliki data ini, beri tahu kami di formulir permintaan migrasi agar kami dapat membantu mentransfer data dengan aman. Stripe dapat mengimpor informasi alamat penagihan pelanggan dan detail pembayaran. Anda juga dapat: - [Memigrasikan jenis pembayaran tertentu](https://docs.stripe.com/get-started/data-migrations/payment-method-imports.md) - [Memigrasikan langganan](https://docs.stripe.com/billing/subscriptions/migrate-subscriptions.md) atau mengimpor menggunakan [Toolkit Migrasi Penagihan](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md). Pemroses Anda sebelumnya mungkin memerlukan waktu beberapa hari hingga beberapa minggu untuk mentransfer data akhir ke Stripe. Sertakan waktu transisi ini dalam rencana migrasi Anda. Setelah penyedia sebelumnya mentransfer data, Stripe akan meninjau data tersebut dan mengidentifikasi potensi masalah pada proses impor. Kami akan bekerja sama dengan Anda dan penyedia pembayaran sebelumnya untuk memperbaiki masalah apa pun. Selanjutnya, kami akan membagikan ringkasan hasil impor untuk ditinjau dan disetujui oleh Anda. Setelah mendapatkan persetujuan, Stripe mengimpor data ke akun Anda. Kami membuat [Pelanggan](https://docs.stripe.com/api.md#customer_object) untuk setiap pelanggan unik dalam file data yang ditransfer, serta membuat dan melampirkan kartu pelanggan sebagai objek [Kartu](https://docs.stripe.com/api.md#card_object) atau [Metode Pembayaran](https://docs.stripe.com/api/payment_methods/object.md). Jika data yang ditransfer menentukan kartu default pelanggan, kami akan menjadikannya sebagai [metode pembayaran default pelanggan](https://docs.stripe.com/api.md#customer_object-default_source) untuk charge dan pembayaran [langganan](https://docs.stripe.com/api/subscriptions/create.md). Jika akun Stripe Anda telah mengumpulkan catatan pelanggan yang signifikan pada saat Anda bermigrasi, pertimbangkan [memetakan data impor ke objek Customer Stripe yang ada](https://docs.stripe.com/get-started/data-migrations/map-payment-data.md) alih-alih membuat objek `Customer`. Stripe biasanya mengimpor data dalam waktu 10 hari kerja setelah menerima data yang benar dari pemroses Anda sebelumnya, bersama dengan file data tambahan yang ingin Anda bagikan dengan tim kami. ## Perbarui integrasi Anda Setelah menyelesaikan impor, Stripe mengirimi Anda pilihan file CSV atau JSON yang memperlihatkan hubungan yang dipetakan antara identifikasi pemroses Anda saat ini dan identifikasi objek Stripe yang diimpor. Uraikan file pemetaan ini dan perbarui database Anda. Pastikan integrasi Anda [menangani pembaruan kartu](https://docs.stripe.com/get-started/data-migrations/pan-import.md#handle-card-updates) yang terjadi selama transisi. ### File pemetaan pascaimpor Setelah memperbarui integrasi dengan file pemetaan ini, Anda dapat mulai men-charge semua pelanggan atas Stripe. ``` { "1893": { "cards": { "2600": { "id": "card_2222222222", "fingerprint": "x9yW1WE4nLvl6zjg", "last4": "4242", "exp_month": 1, "exp_year": 2020, "brand": "Visa" }, "3520": { "id": "card_3333333333", "fingerprint": "nZnMWbJBurX3VHIN", "last4": "0341", "exp_month": 6, "exp_year": 2021, "brand": "Mastercard" } }, "id": "cus_abc123def456" } } ``` Contoh pemetaan JSON di atas menunjukkan: - ID pelanggan yang diimpor 1893 sebagai Stripe baru `Customer` dengan ID `cus_abc123def456`. - ID kartu pelanggan yang diimpor 2600 sebagai Stripe baru `Card` dengan ID `card_2222222222`. - ID kartu pelanggan yang diimpor 3520 sebagai Stripe baru `Card` dengan ID `card_3333333333`. Stripe dapat mengimpor data kartu sebagai [Metode Pembayaran](https://docs.stripe.com/api.md#payment_method_object) melainkan `Card` jika Anda menentukannya dalam permintaan migrasi Anda. Contoh berikut menunjukkan file pemetaan untuk berbagai jenis impor informasi pembayaran. #### Kartu sebagai card_ CSV ```csv old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,4242,09,2024,Visa ``` #### Kartu sebagai PaymentMethod (pm_) CSV ``` old_id,source_old_id,created_customer,source_new_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand old_cus_100,old_src_100,cus_abc123def456,pm_2222222222,x9yW1WE4nLvl6zjg,4242,09,2024,Visa ``` #### ACH sebagai rekening bank (ba_) CSV ``` old_customer_id,customer_id,old_bank_account_id,bank_account_id,bank_account_fingerprint,bank_account_last4 old_cus_100,cus_abc123def456,old_src_100,ba_2222222222,x9yW1WE4nLvl6zjg,4242 ``` #### ACH sebagai PaymentMethod (pm_) CSV ``` old_customer_id,customer_id,old_bank_account_id,bank_account_id,bank_account_fingerprint,bank_account_last4 old_cus_100,cus_abc123def456,old_src_100,pm_2222222222,x9yW1WE4nLvl6zjg,4242 ``` #### BACs sebagai PaymentMethod (pm_) CSV ``` old_id,source_old_id,created_customer,source_new_id,mandate_id old_cus_100,old_src_100,cus_abc123def456,pm_2222222222,mandate_1MvojA2eZvKYlo2CvqTABjZs ``` #### SEPA sebagai PaymentMethod (pm_) CSV ``` old_customer_id,customer_id,old_source_id,source_id,type,bank_code,branch_code,country,fingerprint,last4,mandate_reference,mandate_url,mandate_id old_cus_100,cus_abc123def456,old_src_100,pm_2222222222,sepa_debit,1111,000,DE,x9yW1WE4nLvl6zjg,4242,ref_000,example.com,mandate_1MvojA2eZvKYlo2CvqTABjZs ``` ## Pantau pembayaran yang telah diimpor Setelah melakukan migrasi, pantau kinerja pembayaran Anda untuk memastikan rasio penerimaan data pembayaran yang diimpor sesuai dengan harapan Anda. Penerimaan pembayaran (atau rasio otorisasi penerbit) adalah persentase transaksi yang berhasil diotorisasi oleh penerbit dari semua transaksi yang diserahkan untuk pembayaran. Metrik ini tidak termasuk transaksi yang diblokir (misalnya karena aturan Radar) karena transaksi tersebut tidak pernah diserahkan untuk otorisasi. Baik dalam pendekatan umum maupun pascamigrasi, selaraskan sasaran [pengoptimalan otorisasi pembayaran](https://stripe.com/guides/optimizing-authorization-rates) dengan tujuan bisnis Anda. Misalnya, bisnis barang digital dengan biaya unit rendah dapat mengatur tingkat risikonya untuk memblokir lebih sedikit pembayaran. Pertimbangkan efek potensialnya: - Peningkatan rasio konversi karena berkurangnya hambatan. - Peningkatan eksposur penipuan karena pembayaran berisiko yang masuk. - Tingkat otorisasi penerbit mentah yang lebih rendah karena pemblokiran model penipuan oleh penerbit. Pastikan Anda menyediakan data yang akurat (seperti nama pemegang kartu, alamat penagihan, dan email). Mencerminkan maksud pemegang kartu akan memaksimalkan peluang otorisasi yang berhasil. ### Identifikasikan kartu tersimpan Migrasi data pembayaran melibatkan *kartu tersimpan* (kartu yang disimpan untuk pembayaran [yang diprakarsai merchant atau di luar sesi](https://support.stripe.com/questions/what-is-the-difference-between-on-session-and-off-session-and-why-is-it-important) mendatang untuk pelanggan yang sama). Pastikan Anda menyimpan data pembayaran yang diimpor dan memberi label pembayaran menggunakan kartu tersebut yang tercatat dengan parameter `off_session` yang benar. Jika Anda mengidentifikasi kartu yang tercatat dengan tidak benar: - Penerbit yang tidak dapat mengonfirmasi persetujuan pemegang kartu untuk pembayaran rutin atau mendatang dapat [menolak](https://docs.stripe.com/declines.md#issuer-declines) pembayaran. - Data pembayaran mungkin tidak memenuhi syarat untuk produk pengoptimalan Stripe tertentu, seperti Pembaru kartu (CAU) dan Token jaringan (NT). ### Pantau alasan penolakan untuk peluang optimisasi Setelah migrasi, [alasan penolakan penerbit](https://docs.stripe.com/declines/codes.md) dapat membantu Anda mengidentifikasi jika data pembayaran yang dimigrasikan bertransaksi seperti yang diharapkan. Lonjakan tipe penolakan tertentu mungkin mendapatkan manfaat dari produk pengoptimalan berikut: - Pembaru kartu: Kemitraan Stripe dengan jaringan kartu memungkinkan kami secara otomatis memperoleh pembaruan untuk kartu yang kedaluwarsa atau diganti, baik secara real-time maupun di latar belakang. - **Percobaan Ulang Otomatis** (Penagihan): Gunakan kehati-hatian karena mencoba ulang banyak kartu (seperti setelah migrasi) dapat tampak mencurigakan bagi penerbit kartu. Jika Anda menggunakan Stripe [Smart retries](https://stripe.com/guides/optimizing-authorization-rates#smart-retries) untuk pembayaran tagihan Anda, model AI kami menganalisis kode penolakan, pembaruan metode pembayaran, dan aktivitas ambang risiko bank untuk mencoba ulang pembayaran pendapatan berulang secara lebih strategis. - [Token jaringan](https://stripe.com/guides/optimizing-authorization-rates#network-tokens): Ganti nomor akun pembayaran (PAN) tertentu dengan token aman dari jaringan kartu untuk memastikan pembaruan PAN (seperti perpanjangan atau penggantian) secara otomatis tercermin dalam token. - [Penerimaan adaptif](https://stripe.com/guides/optimizing-authorization-rates#adaptive-acceptance): Stripe menggunakan AI untuk menilai dampak penyesuaian kecil (seperti format) pada permintaan otorisasi secara real-time, kemudian menyempurnakan upaya pengulangan pembayaran sebelum mengembalikan penolakan awal kepada pelanggan. - **Penjangkauan pelanggan**: Meminta pelanggan Anda untuk masuk dan memasukkan kembali atau memverifikasi kembali detail pembayaran sering kali membangun kembali kepercayaan bisnis Anda dengan pelanggan dan penyedia pembayaran. Pertimbangkan untuk memberi tahu pelanggan melalui saluran selain email, seperti pesan teks atau notifikasi dalam aplikasi. Tabel berikut menunjukkan produk pengoptimalan yang menawarkan peningkatan karena berbagai alasan penolakan. | Kode penolakan dapat mencakup | Efek migrasi | Boleh dilakukan | Jangan dilakukan | | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | --------------------------------------------- | | `incorrect_number` `invalid_number` `expired_card` | Pembaruan pada data kartu selama jeda migrasi alami dapat menyebabkan data kartu yang disimpan menjadi tidak berlaku. | - Pembaru kartu - Token jaringan - Adaptive acceptance - Hubungi pelanggan | Coba ulang | | `generic_decline` `do_not_honor` | Perubahan pada keterangan rekening koran atau penanda identifikasi lainnya dapat memicu model risiko penerbit atau membingungkan pelanggan Anda. | - Coba ulang - Token jaringan - Adaptive acceptance - Hubungi pelanggan | Pembaru kartu | | `transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc` | Beberapa data pembayaran yang dimigrasikan mungkin tidak memiliki detail validasi kartu awal, seperti token jaringan atau identifikasi transaksi asli. | - Pembaru kartu - Coba ulang - Adaptive acceptance - Hubungi pelanggan | Token jaringan | | `lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported` | Pelanggan dapat melaporkan kartu yang hilang atau dicuri selama jeda migrasi. Perhatikan keadian CONTAC khusus sehubungan dengan penolakan ini. | - Token jaringan - Hubungi pelanggan | - CAU - Coba ulang1 - Adaptive acceptance | 1 Mencoba kembali data pembayaran yang hilang atau dicuri dapat tampak mencurigakan bagi penerbit kartu. ## Optional: Memigrasikan langganan Migrasi yang melibatkan langganan biasanya melibatkan tahap-tahap ini: 1. Siapkan [integrasi tagihan](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md) Anda. 1. [Migrasikan informasi pelanggan dan pemroses pembayaran Anda](https://docs.stripe.com/get-started/data-migrations/pan-import.md#data-migration-process). 1. [Impor langganan Anda ke Stripe Billing](https://docs.stripe.com/billing/subscriptions/migrate-subscriptions.md). Anda dapat mengimpor langganan yang ada dengan menggunakan [Subscriptions API](https://docs.stripe.com/billing/subscriptions/import-subscriptions.md) atau [Toolkit migrasi penagihan](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md) di Dashboard. 1. Setelah berhenti dari pemroses pembayaran Anda, konfirmasikan bahwa pemroses telah membatalkan semua tagihan otomatis pelanggan Anda. ## Kunci PGP migrasi Jika Anda tidak paham PGP, lihat [GPG](http://gnupg.org/) dan mulai dengan [mengimpor kunci publik](http://www.gnupg.org/gph/en/manual.html#AEN84). Setelah Anda memahami dasar-dasar PGP, gunakan kunci PGP berikut untuk mengenkripsi data sensitif (seperti informasi kartu kredit) dalam rangka migrasi yang mematuhi PCI. ### Kunci migrasi PGP ``` -----BEGIN PGP PUBLIC KEY BLOCK----- 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 =+4/r -----END PGP PUBLIC KEY BLOCK----- ``` Ini membuat **FILENAME.gpg** dengan informasi berikut: - Identifikasi kunci: `9C78B7620C1E99AD` - Tipe kunci: `RSA` - Ukuran kunci: `4096 bits` - Sidik jari: `AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD` - Identifikasi pengguna: `Stripe Import Key (PCI) ` Setelah Anda mengimpor kunci kami, Anda dapat mengenkripsi file untuk dikirim dengan menjalankan perintah ini di prompt baris perintah Anda: `gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME` Untuk detail selengkapnya tentang menyediakan data terenkripsi untuk Stripe, lihat [Unggah data tambahan](https://docs.stripe.com/get-started/data-migrations/supplementary-data.md). ## Lihat juga - [Pengoptimalan pembayaran](https://docs.stripe.com/payments/analytics/optimization.md) - [Beberapa akun](https://docs.stripe.com/get-started/account/multiple-accounts.md) - [Daftar periksa akun](https://docs.stripe.com/get-started/account/checklist.md)