Dompet Digital

Terima Apple Pay, Google Pay, Amazon Pay, Cash App Pay, dan RevolutPay saat checkout. Mencakup ketersediaan, verifikasi domain Apple Pay, dan pengujian.

Digital wallets memungkinkan pelanggan membayar dengan kartu atau akun yang sudah tersimpan di perangkat mereka, tanpa mengetik detail kartu. Wallet mengirimkan token, bukan nomor kartu, dan pelanggan mengonfirmasi pembayaran dengan satu ketukan atau pemeriksaan biometrik.

​

Dompet yang Didukung

Dodo Payments hanya menampilkan setiap wallet jika checkout sesuai dengan negara, mata uang, dan jenis pembayaran yang didukung:

Wallet	Ketersediaan	Mata Uang	Langganan	Penyiapan yang Diperlukan
Apple Pay	Global, termasuk India	Semua, termasuk INR	Ya	Verifikasi domain untuk inline checkout
Google Pay	Global (kecuali India)	Semua	Ya	Tidak ada
Amazon Pay	Global (kecuali India)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	Tidak	Tidak ada
Cash App Pay	Hanya AS	USD	Ya	Tidak ada
RevolutPay	Global	GBP	Tidak	Tidak ada

PayPal sementara tidak tersedia untuk transaksi baru.

​

Apple Pay

Apple Pay memungkinkan pelanggan membayar dengan kartu yang tersimpan di Apple Wallet dan mengonfirmasi menggunakan Face ID atau Touch ID.

Apple Pay muncul untuk langganan meskipun tagihan pertama bernilai $0, seperti pada free trial, sehingga payment mandate disiapkan saat pendaftaran. Untuk pembayaran satu kali, Apple Pay hanya muncul jika jumlahnya lebih besar dari $0.

​

Persyaratan

• Perangkat: iOS 17 atau lebih baru, iPadOS 17 atau lebih baru, atau Safari 17 atau lebih baru di macOS. Di India, Apple memerlukan iPhone XR atau lebih baru dengan iOS 18 atau lebih baru.
• Protokol: Halaman harus dimuat melalui HTTPS.
• Domain: Untuk inline checkout, domain harus diverifikasi dengan Apple.

​

Apple Pay di India

Pelanggan di India dapat membayar dengan Apple Pay pada checkout yang ditagihkan dalam INR.

Apple Pay di India berfungsi dengan ketentuan berikut:

• Mata uang: Checkout ditagihkan dalam INR. Pembayaran yang ditagihkan dalam INR harus memenuhi batas minimum INR.
• Kartu: Pelanggan memiliki kartu di Apple Wallet dari bank India yang mendukung Apple Pay. Apple menentukan bank dan kartu mana yang memenuhi syarat.
• Desktop: Di browser desktop, pelanggan dapat memindai kode dengan iPhone dan mengonfirmasi pembayaran di ponsel.
• Langganan: Langganan Apple Pay dalam INR berjalan menggunakan mandat RBI. Setiap tagihan perpanjangan selesai sekitar 48 jam setelah tanggal perpanjangan, sama seperti kartu lain yang diterbitkan di India.

Untuk menagih pelanggan di India dalam INR, ikuti persyaratan India Payment Methods untuk negara penagihan dan Adaptive Currency.

​

Verifikasi Domain

Verifikasi domain hanya diperlukan untuk inline (embedded) checkout. Hosted checkout dan payment links menampilkan Apple Pay tanpa verifikasi ini.

Apple Pay tidak tersedia di overlay checkout. Untuk menawarkan Apple Pay, gunakan inline checkout, hosted checkout, atau payment link.

Untuk memverifikasi domain bagi inline checkout, ikuti langkah-langkah berikut di dashboard:

1. Open Apple Pay Domains

   Buka Settings → Payment Methods. Pada baris Apple Pay, klik Manage domains.

   

   Open Apple Pay domains from the Apple Pay row

2. Download the Domain Association File

   Di panel Apple Pay domains, klik Download file.

   

   Download the Apple Pay domain association file

3. Register Your Domain

   Klik Register domain, masukkan domain tempat Anda menyematkan checkout (misalnya, shop.example.com), lalu klik Continue.

   

   Register the domain where you embed checkout

4. Host the File on Your Domain

   Unggah file ke server Anda di jalur berikut:

   https://shop.example.com/.well-known/apple-developer-merchantid-domain-association
   

   Sajikan file melalui HTTPS, tanpa pengalihan, dengan Content-Type: application/octet-stream atau text/plain.

5. Verify the Domain

   Klik Verify domain. Dodo Payments memeriksa file yang di-host dan mengirimkan domain Anda ke Apple.

   

   Verify the hosted association file

6. Confirm It's Active

   Saat status menampilkan Active, Apple Pay telah aktif di domain tersebut. Untuk mengaktifkan atau menonaktifkan Apple Pay pada satu domain, gunakan toggle Enabled.

   

   Verified domains show an Active status

7. Test the Integration

   1. Buka checkout di perangkat Apple.
   2. Pastikan tombol Apple Pay muncul.
   3. Selesaikan transaksi pengujian.

​

Konfigurasi

Untuk membatasi sesi checkout ke Apple Pay dan kartu, teruskan allowed_payment_method_types:

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

​

Google Pay

Google Pay memungkinkan pelanggan membayar menggunakan kartu yang tersimpan di akun Google mereka.

​

Persyaratan

• Browser: Chrome di desktop dan Android, serta Firefox di desktop. Checkout tidak menampilkan Google Pay di Safari atau browser apa pun di iOS. Di browser tersebut, pelanggan dapat membayar dengan Apple Pay atau kartu.
• Perangkat: Perangkat Android dengan aplikasi Google Pay.
• Pengaturan: Di Chrome, Allow sites to check if you have payment methods saved harus diaktifkan.

​

Konfigurasi

Untuk membatasi sesi checkout ke Google Pay dan kartu, teruskan allowed_payment_method_types:

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

Google Pay tidak memerlukan verifikasi domain.

​

Amazon Pay

Amazon Pay memungkinkan pelanggan menyelesaikan checkout dengan metode pembayaran yang tersimpan di akun Amazon mereka.

​

Ketersediaan

• Wilayah: Global, kecuali India.
• Mata uang: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. Mata uang yang ditawarkan checkout bergantung pada processor yang melayaninya.
• Langganan: Tidak didukung.

​

Konfigurasi

Untuk membatasi sesi checkout ke Amazon Pay dan kartu, teruskan allowed_payment_method_types:

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

​

Cash App Pay

Cash App Pay memungkinkan pelanggan di AS membayar dari akun Cash App mereka.

​

Ketersediaan

• Wilayah: Hanya AS. Negara penagihan harus AS.
• Mata uang: Hanya USD.
• Langganan: Didukung.

​

Konfigurasi

Untuk membatasi sesi checkout ke Cash App Pay dan kartu, teruskan allowed_payment_method_types:

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

​

RevolutPay

RevolutPay memungkinkan pengguna Revolut membayar dari saldo akun Revolut atau kartu tertaut mereka.

​

Ketersediaan

• Wilayah: Global.
• Mata uang: Hanya GBP.
• Langganan: Tidak didukung.

​

Konfigurasi

Untuk membatasi sesi checkout ke RevolutPay dan kartu, teruskan allowed_payment_method_types:

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

​

Pengujian

Dalam test mode, pembayaran wallet menggunakan alur checkout yang sama tanpa memindahkan uang sungguhan.

​

Pengujian Apple Pay

1. Use Test Mode

   Nonaktifkan switch Live Mode di sidebar dashboard, lalu gunakan API keys yang dibuat dalam test mode.

2. Add a Card to Apple Wallet

   Tambahkan kartu sungguhan ke Apple Wallet. Dalam test mode, kartu tidak akan ditagih.

3. Complete a Test Purchase

   Buka checkout di perangkat Apple dan selesaikan alur Apple Pay.

Apple Pay memerlukan HTTPS. Apple Pay tidak muncul di localhost kecuali halaman disajikan melalui HTTPS.

​

Pengujian Google Pay

1. Join the Test Card Group

   Gabung ke grup kartu pengujian Google Pay agar kartu pengujian ditambahkan ke wallet Anda.

2. Enable Test Mode

   Gunakan API keys yang dibuat dalam test mode.

3. Complete a Test Purchase

   Pilih salah satu kartu pengujian di Google Pay untuk menyelesaikan transaksi.

​

Amazon Pay & Cash App Pay

Gunakan API keys test mode Anda dan ikuti alur checkout standar. Transaksi pengujian disimulasikan dan tidak ada tagihan sungguhan yang terjadi.

​

Dukungan SDK

Ketersediaan wallet bergantung pada cara Anda menampilkan checkout.

​

Web SDKs

Wallet digital berfungsi di:

• Overlay Checkout, kecuali Apple Pay.
• Inline Checkout. Apple Pay memerlukan verifikasi domain.
• Integrasi Direct API dengan hosted checkout.

​

Mobile SDKs (Checkout)

SDK checkout Android, iOS, React Native, dan Flutter membuka hosted checkout Dodo Payments di system browser platform (SFSafariViewController di iOS, Chrome Custom Tabs di Android), bukan di WebView. Apple Pay dan Google Pay berfungsi di sana dengan cara yang sama seperti di web. Lihat Mobile Integration Guide untuk penyiapan.

​

Praktik Terbaik

Prioritize wallets on mobile

Pelanggan seluler mengharapkan Apple Pay dan Google Pay. Tampilkan opsi ini secara menonjol pada checkout seluler.

Complete domain verification early

Jika Anda menggunakan inline checkout, verifikasi domain untuk Apple Pay selama pengembangan, bukan pada hari peluncuran.

Always include card fallbacks

Tidak semua pelanggan memiliki wallet digital. Sertakan credit dan debit dalam allowed_payment_method_types.

Test on real devices

Simulator tidak sepenuhnya meniru perilaku wallet. Uji pada perangkat iOS dan Android sungguhan sebelum peluncuran.

Handle wallet unavailability

Wallet tidak muncul pada perangkat yang tidak didukung atau ketika pelanggan tidak memiliki kartu tersimpan. Tetap tampilkan metode pembayaran lain untuk pelanggan tersebut.

​

Pemecahan Masalah

Apple Pay button not appearing

Periksa:

1. Untuk inline checkout, apakah domain telah diverifikasi di Manage domains?
2. Apakah halaman dimuat melalui HTTPS?
3. Apakah perangkat menggunakan iOS 17, iPadOS 17, atau Safari 17 atau lebih baru?
4. Apakah pelanggan memiliki kartu di Apple Wallet?
5. Apakah apple_pay disertakan dalam allowed_payment_method_types?
6. Apakah checkout berupa overlay? Apple Pay tidak tersedia di overlay checkout.

Solusi: Selesaikan verifikasi domain dan sajikan halaman melalui HTTPS. Uji pada perangkat Apple sungguhan.

Apple Pay domain stuck on Pending

Setelah Anda mengeklik Verify domain, Dodo Payments mengambil file asosiasi dari domain Anda dan mengirimkan domain tersebut ke Apple. Domain yang tetap berstatus Pending biasanya memiliki file yang tidak dapat diambil Dodo Payments sebagaimana mestinya.

Periksa:

1. File dapat diakses di https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
2. File disajikan melalui HTTPS dengan sertifikat yang valid.
3. File terselesaikan tanpa pengalihan. Pengalihan ke www, host lain, atau halaman error akan membuat pemeriksaan gagal.
4. File disajikan sebagai Content-Type: application/octet-stream atau text/plain, bukan text/html.
5. File tersebut adalah file yang diunduh dari Manage domains untuk bisnis ini, bukan file yang digunakan ulang dari akun atau provider lain.

Untuk memastikan file dapat diakses secara publik, minta URL dari luar jaringan Anda sendiri, misalnya melalui jendela private browsing. Kata sandi staging, authentication walls, dan aturan firewall sering kali membuat permintaan berhasil untuk Anda tetapi gagal untuk Dodo Payments.

Solusi: Perbaiki masalah hosting, lalu klik Verify domain lagi. Jika domain tidak menjadi Active setelah pemeriksaan berhasil, hubungi [e-mail] dengan menyertakan nama domain.

Google Pay button not appearing

Periksa:

1. Apakah pelanggan menggunakan browser yang didukung? Google Pay tidak muncul di Safari atau browser apa pun di iOS.
2. Apakah pelanggan memiliki kartu di Google Pay?
3. Apakah pengaturan Chrome Allow sites to check if you have payment methods saved diaktifkan?
4. Apakah google_pay disertakan dalam allowed_payment_method_types?

Solusi: Periksa browser dan penyiapan Google Pay pelanggan.

Wallet payment failed

Penyebab umum:

• Kartu di wallet telah kedaluwarsa atau tidak valid.
• Bank menolak transaksi.
• Masalah koneksi jaringan mengganggu pembayaran.

Solusi: Minta pelanggan memeriksa kartu di wallet mereka atau menggunakan metode pembayaran lain.

Wrong device type

Wallet digital hanya muncul pada perangkat yang kompatibel:

• Apple Pay: Hanya perangkat Apple.
• Google Pay: Perangkat Chrome atau Android.

Solusi: Hal ini memang diharapkan. Tetap sediakan pembayaran kartu sebagai opsi cadangan.

​

Halaman Terkait

Payment Methods Overview

Semua metode pembayaran yang didukung.

Overlay Checkout

Buka checkout sebagai overlay di halaman Anda.

Testing Process

Data pengujian untuk setiap metode pembayaran.

Mobile Integration Guide

Buka hosted checkout di system browser, tempat Apple Pay dan Google Pay berfungsi seperti di web.