Mulai dengan komponen Connect yang disematkan
Pelajari cara menyematkan fungsionalitas dashboard ke situs web Anda.
Gunakan komponen tersemat Connect untuk menambahkan fungsionalitas dashboard akun terhubung ke situs web Anda. Pustaka ini dan API pendukungnya memungkinkan Anda memberikan akses ke produk Stripe secara langsung di dashboard dan aplikasi seluler.
Pratinjau pribadi
Android SDK saat ini hanya tersedia dengan ajakan saja dan memiliki batasan berikut:
- Hanya mendukung akun di mana
controller.
adalahrequirement_ collection application
, seperti akun terhubung Custom. - Autentikasi pengguna tidak didukung, jadi Anda harus mengatur features.disable_stripe_user_authentication ke
true
di endpoint server untuk segala komponen bila Anda membuat sesi akun.
Masukkan email Anda dalam formulir di bawah ini untuk meminta ajakan.
Siapkan StripeConnectSisi klienSisi server
Stripe menggunakan AccountSession untuk mengekspresikan maksud Anda guna mendelegasikan akses API ke akun terhubung Anda.
AccountSessions API mengembalikan client secret yang memungkinkan komponen tersemat mengakses sumber daya akun terhubung seolah-olah Anda yang melakukan panggilan API untuk mereka.
Buat AccountSession Server
Aplikasi Anda harus memprakarsai permintaan ke server untuk memperoleh sesi akun. Saat ini, hanya Onboarding akun yang didukung. Anda dapat membuat endpoint baru pada server yang mengembalikan client secret ke aplikasi:
Peringatan
Autentikasi pengguna tidak didukung, jadi Anda harus mengatur features.disable_stripe_user_authentication ke true
di endpoint server untuk segala komponen bila Anda membuat sesi akun.
Buat Account Session API
Create Account Session API menentukan akses komponen dan fitur untuk komponen tersemat Connect. Stripe memberlakukan parameter ini untuk setiap komponen yang sesuai dengan sesi akun. Jika aplikasi Anda mendukung beberapa peran pengguna, pastikan komponen dan fitur yang diaktifkan untuk sesi akun tersebut sesuai dengan peran pengguna saat ini. Misalnya, Anda dapat mengaktifkan manajemen pengembalian dana hanya untuk administrator situs Anda, tetapi tidak untuk pengguna lain. Untuk memastikan akses peran pengguna diberlakukan, Anda harus memetakan peran pengguna situs ke komponen sesi akun.
Instal StripeConnect SDK Client
Stripe Android SDK adalah sumber terbuka dan didokumentasikan lengkap.
Untuk menginstal SDK, tambahkan connect
ke blok
dependencies` file app/build.gradle Anda:
Catatan
Untuk detail mengenai rilis SDK terbaru dan versi sebelumnya, lihat halaman Rilis di GitHub. Untuk menerima notifikasi bila rilis baru diterbitkan, lihat rilis untuk repositori.
Inisialisasikan EmbeddedComponentManager Client
Buat instance EmbeddedComponentManager dengan kunci yang dapat dipublikasikan dan lambda yang mengambil client secret dengan memanggil endpoint baru yang Anda buat pada server. Untuk menangani perubahan konfigurasi, simpan instance EmbeddedComponentManager
di Aktivitas atau Fragmen ViewModel
.
Untuk membuat komponen, pertama-tama panggil EmbeddedComponentManager.
di metode onCreate
Aktivitas Anda. Kemudian, panggil metode buat yang sesuai pada instance EmbeddedComponentManager
yang Anda buat di atas. Ini mengembalikan pengontrol yang dapat Anda gunakan untuk menyajikan komponen dalam aplikasi.
Configure the Embedded Component ManagerSisi client
Sesuaikan tampilan komponen tersemat Connect
Toolkit Figma UI komponen tersemat berisi setiap komponen, pola umum, dan contoh aplikasi. Anda dapat menggunakannya untuk memvisualisasikan serta mendesain UI yang disematkan pada situs web Anda.
Kami menawarkan serangkaian opsi untuk menyesuaikan tampilan dan cara kerja komponen tersemat Connect. Penyesuaian ini memengaruhi tombol, ikon, dan aksen lainnya di sistem desain kami.
Popup yang diperlukan
Beberapa perilaku dalam komponen tersemat, seperti autentikasi pengguna, harus disajikan di WebView yang diautentikasi. Anda tidak dapat menyesuaikan komponen tersemat untuk menghilangkan Tampilan Web tersebut.
Anda dapat mengatur opsi ini menggunakan Appearance ketika melakukan inisialisasi EmbeddedComponentManager
.
Gunakan font custom
Jika menggunakan font custom di aplikasi (misalnya, dari file .
atau .
yang disematkan di biner aplikasi), Anda harus menentukan file font di CustomFontSource yang diteruskan ke argumen customFonts
ketika melakukan inisialisasi EmbeddedComponentManager
. Hal ini memberi komponen tersemat Connect akses ke file font untuk merender font dengan benar.
Font yang ditentukan di appearance
harus menggunakan CustomFontSource yang diteruskan ke EmbeddedComponentManager
pada inisialisasi untuk dirender dengan benar.
Konfigurasikan penampilan
Ketika menentukan ukuran font, gunakan ukuran font yang tidak diubah skalanya dan ditampilkan untuk kelas ukuran default perangkat. Komponen tersemat secara otomatis menskalakan ukuran font berdasarkan Pengaturan font aksesibilitas pengguna.
Lihat daftar lengkap opsi penampilan di Android.
Perbarui komponen tersemat Connect setelah inisialisasi
Panggil metode update
untuk mengubah tampilan komponen tersemat setelah inisialisasi:
Autentikasi
Kami menawarkan seperangkat API untuk mengelola sesi akun dan kredensial pengguna di komponen tersemat Connect.
Muat ulang client secret
Pada sesi yang berjalan lama, sesi dari client secret yang semula diberikan mungkin kedaluwarsa. Bila kedaluwarsa, kami secara otomatis menggunakan fetchClientSecret
untuk mengambil client secret baru dan memuat ulang sesi. Anda tidak perlu meneruskan parameter tambahan.
Pelokalan
Komponen tersemat Connect mendukung lokal berikut:
Bahasa | Kode lokal |
---|---|
Bahasa Bulgaria (Bulgaria) | bg-BG |
Bahasa Tionghoa (Disederhanakan) | zh-Hans |
Bahasa Tionghoa (Tradisional - Hong Kong) | zh-Hant-HK |
Bahasa Tionghoa (Tradisional - Taiwan) | zh-Hant-TW |
Bahasa Kroasia (Kroasia) | hr-HR |
Bahasa Ceko (Cheska) | cs-CZ |
Bahasa Denmark (Denmark) | da-DK |
Bahasa Belanda (Belanda) | nl-NL |
Bahasa Inggris (Australia) | en-AU |
Bahasa Inggris (India) | en-IN |
Bahasa Inggris (Irlandia) | en-IE |
Bahasa Inggris (Selandia Baru) | en-NZ |
Bahasa Inggris (Singapura) | en-SG |
Bahasa Inggris (Kerajaan Inggris) | en-GB |
Bahasa Inggris (Amerika Serikat) | en-US |
Bahasa Estonia (Estonia) | et-EE |
Bahasa Filipina (Filipina) | fil-PH |
Bahasa Finlandia (Finlandia) | fi-FI |
Bahasa Prancis (Kanada) | fr-CA |
Bahasa Prancis (Prancis) | fr-FR |
Bahasa Jerman (Jerman) | de-DE |
Bahasa Yunani (Yunani) | el-GR |
Bahasa Hungaria (Hungaria) | hu-HU |
Bahasa Indonesia (Indonesia) | id-ID |
Bahasa Italia (Italia) | it-IT |
Bahasa Jepang (Jepang) | ja-JP |
Bahasa Korea (Korea Selatan) | ko-KR |
Bahasa Latvia (Latvia) | lv-LV |
Bahasa Lituania (Lituania) | lt-LT |
Bahasa Melayu (Malaysia) | ms-MY |
Bahasa Malta (Malta) | mt-MT |
Bahasa Bokmål Norwegia (Norwegia) | nb-NO |
Bahasa Polandia (Polandia) | pl-PL |
Portugis (Brasil) | pt-BR |
Bahasa Portugis (Portugal) | pt-PT |
Bahasa Rumania (Rumania) | ro-RO |
Bahasa Slowakia (Slowakia) | sk-SK |
Bahasa Slovenia (Slovenia) | sl-SI |
Bahasa Spanyol (Argentina) | es-AR |
Bahasa Spanyol (Brasil) | es-BR |
Spanyol (Amerika Latin) | es-419 |
Bahasa Spanyol (Meksiko) | es-MX |
Bahasa Spanyol (Spanyol) | es-ES |
Bahasa Swedia (Swedia) | sv-SE |
Bahasa Thailand (Thailand) | th-TH |
Bahasa Turki (Türkiye) | tr-TR |
Bahasa Vietnam (Vietnam) | vi-VN |
Autentikasi pengguna di komponen tersemat Connect
Komponen tersemat Connect biasanya tidak memerlukan autentikasi pengguna. Dalam sejumlah skenario, komponen tersemat Connect mengharuskan akun terhubung masuk dengan akun Stripe sebelum mengakses komponen untuk menyediakan fungsionalitas yang diperlukan (misalnya, menulis informasi ke badan hukum akun dalam kasus komponen onboarding akun). Komponen lain mungkin memerlukan autentikasi dalam komponen setelah komponen tersebut ditampilkan di awal.
Autentikasi diperlukan untuk akun terhubung di mana Stripe bertanggung jawab untuk mengumpulkan informasi terbaru bila persyaratan berubah. Untuk akun terhubung tempat Anda bertanggung jawab mengumpulkan informasi terbaru bila persyaratan jatuh tempo atau berubah, seperti akun Custom, autentikasi Stripe dikontrol oleh fitur Sesi Akun disable_stripe_user_authentication. Kami merekomendasikan pengimplementasian 2FA atau tindakan keamanan yang setara sebagai praktik terbaik. Untuk konfigurasi akun yang mendukung fitur ini, seperti Custom, Anda bertanggung jawab atas akun terhubung jika akun tersebut tidak dapat membayar kembali saldo negatif.
Komponen yang memerlukan autentikasi
Akun terhubung akan ditampilkan WebView yang diautentikasi dalam aplikasi Anda. Akun terhubung harus melakukan autentikasi sebelum dapat melanjutkan alur kerjanya dalam Tampilan Web.
Alur autentikasi yang di-hosting Stripe menampilkan nama, warna, dan ikon brand Anda sebagaimana diatur di pengaturan Connect serta tidak menggunakan tampilan dan font custom dari Manajer Komponen Tersemat sampai autentikasi selesai.
Batasan Android
Karena batasan dalam Android API, komponen tersemat tidak dapat menggunakan font custom dalam Tampilan Web yang diautentikasi, bahkan setelah autentikasi selesai.
Komponen berikut mengharuskan akun terhubung melakukan autentikasi dalam skenario tertentu:
Tangani kesalahan pemuatan
Jika komponen tidak dimuat, Anda dapat bereaksi terhadap kegagalan dengan mengimplementasikan metode listener onLoadError
komponen. Tergantung penyebab kegagalan, metode onLoadError
mungkin dipanggil beberapa kali. Logika yang dipicu oleh onLoadError
harus idempoten.
Minta akses Pratinjau pribadi
Masuk untuk meminta akses ke SDK seluler komponen tersemat Connect dalam pratinjau.
Jika tidak memiliki akun Stripe, Anda dapat mendaftar sekarang.