Integrasi SDK React Native
SDK React Native Dodo Payments memungkinkan Anda untuk membangun pengalaman pembayaran yang aman di aplikasi Android dan iOS asli Anda. SDK kami menyediakan komponen UI dan layar yang dapat disesuaikan untuk mengumpulkan detail pembayaran.- 📦 Instal SDK kami dari NPM
- 📚 Lihat repositori demo kami untuk contoh implementasi lengkap
- 🎥 Tonton video demo kami untuk melihat SDK Dodo Payments beraksi
Fitur
Keamanan Sederhana
Kumpulkan data pembayaran sensitif dengan aman sambil tetap mematuhi PCI
Berbagai Metode Pembayaran
Terima berbagai metode pembayaran untuk memperluas jangkauan global
UI Native
Layar dan elemen native untuk Android dan iOS
Saat ini, Apple Pay, Google Pay, Cash App, dan UPI tidak didukung dalam SDK React Native. Kami sedang bekerja untuk menambahkan dukungan untuk metode pembayaran ini di rilis mendatang.
Instalasi
1
Instal SDK
Instal SDK Dodo Payments menggunakan manajer paket pilihan Anda:
- npm
- yarn
2
Pengaturan spesifik platform
- iOS
- Android
Jalankan pod install di folder iOS Anda:
Pengaturan Sisi Klien
1
Dapatkan Kunci Publik
Dapatkan kunci publik Anda dari dasbor Dodo Payments. (Berbeda untuk mode uji dan langsung)
https://app.dodopayments.com/developer/others
2
Siapkan Penyedia Pembayaran
Bungkus aplikasi Anda dengan
DodoPaymentProvider:App.tsx
Anda perlu menghasilkan kunci API dari dasbor Dodo Payments Anda. Lihat panduan generasi kunci API kami untuk instruksi rinci.
3
Buat fungsi utilitas pembayaran
Buat fungsi utilitas untuk mengambil parameter pembayaran dari API backend Anda:
utils/fetchPaymentParams.ts
Fungsi ini mengasumsikan Anda memiliki endpoint API backend yang membuat niat pembayaran dan mengembalikan rahasia klien. Pastikan backend Anda dikonfigurasi dengan benar untuk menangani pembuatan pembayaran. Lihat Tutorial Integrasi API kami untuk contoh pengaturan backend.
4
Implementasikan layar pembayaran
Buat layar pembayaran Anda menggunakan hook
useCheckout. Berikut adalah implementasi lengkap:PaymentScreen.tsx
Untuk contoh lengkap dengan styling, penanganan kesalahan, dan opsi kustomisasi, lihat repositori demo kami:
Opsi Konfigurasi
Parameter Sesi
Rahasia klien dari niat pembayaran Anda, diperoleh dari API pembayaran satu kali atau langganan.
Mode sesi pembayaran (uji atau langsung).
Opsi kustomisasi untuk penampilan lembar pembayaran
Mode tema:
'light' atau 'dark'Kustomisasi Penampilan
Anda dapat menyesuaikan React Native Unified Checkout agar sesuai dengan desain aplikasi Anda dengan memodifikasi warna, font, dan lainnya melalui parameter penampilan saat memanggilinitPaymentSession().
Kustomisasi Warna
Setiap kategori warna menentukan warna satu atau lebih komponen di UI. Misalnya,primary mendefinisikan warna tombol Bayar.
| Kategori Warna | Penggunaan |
|---|---|
primary | Warna utama untuk tombol Bayar dan item yang dipilih |
background | Warna latar belakang halaman pembayaran |
componentBackground | Warna latar belakang untuk input, tab, dan komponen lainnya |
componentBorder | Warna batas eksternal untuk input, tab, dan komponen lainnya |
componentDivider | Warna batas internal (batas bersama) untuk komponen |
primaryText | Warna teks header |
secondaryText | Warna teks label untuk bidang input |
componentText | Warna teks input (misalnya, nomor kartu, kode pos) |
placeholderText | Warna teks placeholder untuk bidang input |
icon | Warna untuk ikon (misalnya, tombol tutup) |
error | Warna untuk pesan kesalahan dan tindakan destruktif |
Kustomisasi Bentuk
Anda dapat menyesuaikan radius batas, lebar batas, dan bayangan yang digunakan di seluruh antarmuka pembayaran:Kustomisasi Spesifik Komponen
Anda dapat menyesuaikan komponen UI tertentu seperti tombol utama (tombol Bayar). Pengaturan ini memiliki prioritas lebih tinggi daripada pengaturan penampilan global:Penanganan Kesalahan
Tangani berbagai status pembayaran dalam fungsi checkout Anda:Skenario Kesalahan Umum
Skenario Kesalahan Umum
- Masalah konektivitas jaringan: Pastikan koneksi internet stabil
- Rahasia klien tidak valid: Verifikasi backend menghasilkan niat pembayaran yang valid
- Ketergantungan peer yang hilang: Instal semua ketergantungan yang diperlukan
- Pengaturan spesifik platform: Selesaikan langkah konfigurasi iOS dan Android
- Kesalahan API: Periksa Referensi Kode Kesalahan kami untuk penanganan kesalahan yang rinci
Tips Debugging
Tips Debugging
- Aktifkan logging debug dalam pengembangan
- Periksa permintaan jaringan ke backend Anda
- Verifikasi kunci API dikonfigurasi dengan benar
- Uji di kedua platform iOS dan Android
- Tinjau FAQ Teknis kami untuk masalah umum
- Gunakan Mode Uji vs Langsung dengan tepat