Kartu Kredit & Debit

Kartu tersedia di setiap checkout Dodo Payments, di setiap negara dan mata uang yang didukung. Dodo Payments menerima jaringan kartu utama, mengganti nomor kartu dengan token, dan menjalankan pemeriksaan yang diperlukan oleh pembayaran kartu, sehingga Anda tidak perlu menangani data kartu mentah.

Jaringan Kartu yang Didukung

Dodo Payments menerima jaringan global dan beberapa jaringan regional.

Jaringan Global

Jaringan	Cakupan
Visa	Pemimpin global, lebih dari 4 miliar kartu di seluruh dunia
Mastercard	Jangkauan global, fitur keamanan yang kuat
American Express	Pemegang kartu premium, pengeluaran lebih tinggi
Discover	Berfokus di AS, berkembang secara global
JCB	Memimpin di Jepang, berekspansi di seluruh Asia
UnionPay	Dominan di Tiongkok
Diners Club	Pelancong internasional premium

Jaringan Regional

Jaringan	Wilayah
Interac	Jaringan debit Kanada
Cartes Bancaires	Jaringan nasional Prancis
Korean Local Cards	Jaringan domestik Korea
Rupay	Jaringan nasional India

Konfigurasi

Kartu menggunakan dua nilai di allowed_payment_method_types:

Jenis	Deskripsi
`credit`	Semua kartu kredit
`debit`	Semua kartu debit

Sesi ini hanya menawarkan pembayaran dengan kartu:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});

Sertakan credit dan debit kecuali Anda memiliki alasan khusus untuk mengecualikan salah satunya. Banyak pelanggan lebih suka membayar dengan kartu debit.

Autentikasi 3D Secure

3D Secure (3DS) meminta bank pemegang kartu untuk mengonfirmasi identitas pemegang kartu, misalnya dengan kode sekali pakai, pemeriksaan biometrik, atau persetujuan di aplikasi bank. Hal ini mengurangi penipuan dan chargeback.

Kapan 3DS Dipicu

Dodo Payments meminta 3DS ketika:

Jaringan kartu mewajibkannya.
Peraturan regional mewajibkannya, seperti PSD2 di Eropa.
Transaksi ditandai sebagai berisiko tinggi.

Memaksa 3DS

Untuk mewajibkan 3DS pada setiap pembayaran kartu untuk bisnis Anda, aktifkan 3D Secure di Settings → Pricing. Untuk mengganti pengaturan tersebut pada satu sesi checkout, teruskan force_3ds:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

Mewajibkan 3DS pada setiap transaksi mengurangi penipuan, tetapi dapat menurunkan konversi karena beberapa pelanggan meninggalkan checkout selama autentikasi.

Menangani Kegagalan Autentikasi

Saat pembayaran memerlukan autentikasi 3DS, pembayaran akan melalui status perantara sebelum berhasil atau gagal:

Status	Arti	Tindakan
`requires_customer_action`	Pelanggan harus menyelesaikan tantangan 3DS	Minta pelanggan menyelesaikan autentikasi selama checkout
`requires_payment_method`	Pelanggan tidak pernah memberikan metode pembayaran (tidak memasukkan detail atau meninggalkan permintaan). Ini biasanya merupakan pelanggan yang berhenti, bukan penolakan	Hubungi kembali pelanggan agar menyelesaikan checkout. Lihat Pemulihan Keranjang yang Ditinggalkan

Jika autentikasi tidak selesai, pembayaran gagal dengan salah satu kode penolakan berikut:

AUTHENTICATION_FAILURE: pelanggan tidak dapat diautentikasi.
AUTHENTICATION_REQUIRED: autentikasi diperlukan tetapi tidak dilakukan.
AUTHENTICATION_TIMEOUT: pelanggan tidak merespons tepat waktu.

Referensi Kegagalan Transaksi mencantumkan tindakan yang direkomendasikan untuk setiap kode.

Saat Checkout vs. Saat Perpanjangan

Saat checkout (pelanggan hadir): Tantangan 3DS muncul selama checkout. Jika gagal, minta pelanggan mencoba lagi atau menggunakan kartu lain.
Saat perpanjangan langganan (pelanggan tidak hadir): Tantangan 3DS tidak dapat ditampilkan secara real-time. Jika perpanjangan memerlukan autentikasi dan gagal, langganan berpindah ke on_hold, atau terlebih dahulu ke past_due jika Anda menetapkan masa tenggang. Untuk memulihkannya, minta pelanggan kembali dan memperbarui metode pembayaran mereka. Lihat Menangani Kegagalan Pembayaran dan Dunning Langganan.

Metode Pembayaran Tersimpan

Pelanggan yang kembali dapat membayar dengan kartu yang disimpan dari checkout sebelumnya.

Tokenized

Nomor kartu asli tidak pernah disimpan.

PCI Compliant

Dodo Payments menangani kepatuhan PCI.

Customer-Scoped

Setiap kartu tersimpan hanya dimiliki oleh satu pelanggan.

Mengaktifkan Kartu Tersimpan

Untuk menampilkan kartu tersimpan milik pelanggan yang kembali pada checkout, teruskan show_saved_payment_methods: true dengan customer_id yang sudah ada. Nilai defaultnya adalah false.

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

Pembelian Sekali Klik

Untuk menagih kartu tersimpan tanpa menampilkan checkout, teruskan payment_method_id bersama confirm: true dan customer_id yang sudah ada. Sesi ini menagih kartu secara langsung dan tidak mengembalikan checkout_url, jadi gunakan webhook untuk mengetahui hasil pembayaran.

// `client` is an initialized DodoPayments client.
// Get the customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Charge the first saved card
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});

Pengujian

Gunakan kartu berikut dalam mode test. Untuk data test lainnya, lihat Proses Pengujian.

Successful Payments
Declined Payments

Wilayah	Merek	Nomor Kartu	Kedaluwarsa	CVV
AS	Visa	`4242424242424242`	06/32	123
AS	Mastercard	`5555555555554444`	06/32	123
India	Visa	`4576238912771450`	06/32	123
India	Mastercard	`5409162669381034`	06/32	123

Wilayah	Merek	Nomor Kartu	Skenario
AS	Visa	`4000000000000002`	Penolakan umum
AS	Visa	`4000000000009995`	Dana tidak mencukupi
India	Visa	`4706131211212123`	Penolakan umum
India	Mastercard	`5105105105105100`	Penolakan umum

Kartu test hanya berfungsi dalam mode test. Dalam mode live, pembayaran yang dilakukan dengan kartu test akan gagal.

Keamanan & Kepatuhan

Dodo Payments menerapkan perlindungan berikut pada pembayaran kartu:

Fitur	Deskripsi
PCI DSS Level 1	Tingkat sertifikasi PCI DSS tertinggi
Tokenisasi	Nomor kartu ditokenisasi saat dimasukkan
Penilaian Penipuan	Penilaian risiko secara real-time
Validasi CVV	Verifikasi kode keamanan
3D Secure	Autentikasi pemegang kartu

Praktik Terbaik

Accept all major networks

Jangan membatasi jenis kartu kecuali diperlukan. Pelanggan berharap kartu pilihan mereka dapat digunakan.

Display card logos

Tampilkan logo Visa, Mastercard, dan Amex di situs Anda untuk membangun kepercayaan.

Handle declines gracefully

Tampilkan pesan error yang jelas. Jangan tampilkan kode error mentah kepada pelanggan.

Enable saved cards for returning customers

Metode pembayaran tersimpan membuat pembelian berulang menjadi lebih cepat bagi pelanggan yang kembali.

Pemecahan Masalah

Card declined

Penyebab: Dana tidak mencukupi, kartu kedaluwarsa, CVV salah, atau perlindungan penipuan dari bank.Solusi: Minta pelanggan memeriksa detail mereka atau mencoba kartu lain. Cari kode error penolakan dan tindakan yang direkomendasikan di referensi Kegagalan Transaksi. Lihat Menangani Kegagalan Pembayaran untuk menangani penolakan dalam kode.

3DS authentication failed

Penyebab: Pelanggan meninggalkan tantangan, sistem bank tidak tersedia, atau waktu tantangan habis.Solusi: Coba lagi, atau minta pelanggan menghubungi bank mereka. Lihat Menangani Kegagalan Autentikasi untuk status pembayaran dan kode penolakan yang terkait.

Card not supported

Penyebab: Jaringan regional tidak didukung, atau kartu merupakan kartu prabayar yang dibatasi.Solusi: Minta pelanggan mencoba kartu dari jaringan utama.

Halaman Terkait

Payment Methods Overview

Semua metode pembayaran yang didukung.

Upsells & Downsells

Pembelian sekali klik dengan kartu tersimpan.

Testing Process

Data test untuk setiap metode pembayaran.

Subscriptions

Penagihan berulang dengan kartu.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Jaringan Kartu yang Didukung

Jaringan Global

Jaringan Regional

Konfigurasi

Autentikasi 3D Secure

Kapan 3DS Dipicu

Memaksa 3DS

Menangani Kegagalan Autentikasi

Saat Checkout vs. Saat Perpanjangan

Metode Pembayaran Tersimpan

Tokenized

PCI Compliant

Customer-Scoped

Mengaktifkan Kartu Tersimpan

Pembelian Sekali Klik

Pengujian

Keamanan & Kepatuhan

Praktik Terbaik

Pemecahan Masalah

Halaman Terkait

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

​Jaringan Kartu yang Didukung

​Jaringan Global

​Jaringan Regional

​Konfigurasi

​Autentikasi 3D Secure

​Kapan 3DS Dipicu

​Memaksa 3DS

​Menangani Kegagalan Autentikasi

​Saat Checkout vs. Saat Perpanjangan

​Metode Pembayaran Tersimpan

Tokenized

PCI Compliant

Customer-Scoped

​Mengaktifkan Kartu Tersimpan

​Pembelian Sekali Klik

​Pengujian

​Keamanan & Kepatuhan

​Praktik Terbaik

​Pemecahan Masalah

​Halaman Terkait

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

Jaringan Kartu yang Didukung

Jaringan Global

Jaringan Regional

Konfigurasi

Autentikasi 3D Secure

Kapan 3DS Dipicu

Memaksa 3DS

Menangani Kegagalan Autentikasi

Saat Checkout vs. Saat Perpanjangan

Metode Pembayaran Tersimpan

Mengaktifkan Kartu Tersimpan

Pembelian Sekali Klik

Pengujian

Keamanan & Kepatuhan

Praktik Terbaik

Pemecahan Masalah

Halaman Terkait