# Rancang integrasi Connect lanjutan menggunakan Accounts v1 API Pelajari kombinasi konfigurasi alternatif untuk integrasi Connect berdasarkan Accounts v1 API. > #### Integrasi Accounts v2 API > > Panduan ini hanya berlaku bagi platform Connect yang sudah ada yang menggunakan Accounts v1 API. Jika Anda adalah pengguna baru Connect, gunakan Accounts v2 API sebagai gantinya. Lihat [Panduan platform interaktif](https://docs.stripe.com/connect/interactive-platform-guide.md) untuk informasi tentang cara mengonfigurasi platform Connect menggunakan Accounts v2 API. Gunakan panduan ini untuk menjelajahi integrasi Connect yang berbeda dan membuat daftar langkah-langkah integrasi yang dipersonalisasi. Sebelum memulai integrasi di lingkungan *sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), Anda harus [membuat Akun Stripe atau masuk](https://dashboard.stripe.com) dan [mengintegrasikan platform ke Connect](https://dashboard.stripe.com/settings/connect/platform-profile). ## Pilih properti ### Buat dan lakukan onboarding akun Strip memungkinkan Anda membuat akun atas nama pengguna, yang disebut akun terhubung. Ketika menggunakan Connect, Anda membuat akun terhubung untuk setiap pengguna yang menerima uang pada platform Anda. #### Item 1 Kirim akun terhubung ke alur onboarding yang di-hosting Strip. Onboarding yang di-hosting Stripe memungkinkan Anda mengalihkan pengguna ke Stripe untuk menyelesaikan proses onboarding di antarmuka yang bermerek bersama. ![Cuplikan layar formulir Connect Onboarding](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) Yang terbaik bila Anda ingin meluncurkan secara cepat dengan upaya integrasi terendah: - Akun terhubung meninggalkan situs Anda dan dialihkan ke Stripe untuk menyelesaikan alur. - Branding bersama Stripe dan opsi terbatas untuk menyesuaikan. - Stripe menangani semua logika alur onboarding. - Secara otomatis mendukung 46+ negara dan 14 bahasa. #### Item 2 Sematkan UI onboarding berfitur banyak tema dengan branding Stripe terbatas secara langsung ke aplikasi Anda. Pengguna akun terhubung berinteraksi dengan komponen tersemat tanpa pernah meninggalkan aplikasi. Anda dapat mengintegrasikan onboarding tersemat di beberapa baris kode. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Yang terbaik bila Anda ingin mempertahankan pengguna pada situs dengan pengalaman yang lebih terintegrasi dan upaya integrasi rendah: - Akun terhubung tetap ada pada situs Anda. - Berfitur banyak tema. Terbatas pada tanpa branding Stripe. - Stripe menangani seluruh logika alur onboarding. - Secara otomatis mendukung 46+ negara dan 14 bahasa. #### Item 3 Bangun setiap aspek alur onboarding dengan memanggil API Stripe yang sesuai. Anda perlu membangun logika custom di integrasi untuk memenuhi semua informasi verifikasi yang diperlukan. > #### Rekomendasi Stripe > > Membangun dan memelihara alur onboarding API memerlukan banyak sumber daya serta memerlukan pembaruan rutin. Jika Anda ingin mengimplementasikan alur onboarding yang disesuaikan, Stripe sangat merekomendasikan Anda menggunakan [onboarding tersemat](https://docs.stripe.com/connect/embedded-onboarding.md). (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [Lakukan onboarding akun terhubung baru] --> [Tampilkan UI untuk mengumpulkan requirements dari akun terhubung Anda] [Tampilkan UI untuk mengumpulkan requirements dari akun terhubung Anda] --> [Buat akun terhubung] [Buat akun terhubung] --> [Jika requirements.currently_due tidak kosong] [Ambil akun terhubung] --> [Jika requirements.currently_due tidak kosong] [Sajikan formulir untuk mengumpulkan informasi dan memvalidasi bidang] --> [Perbarui akun terhubung dengan informasi yang dikumpulkan] [Lakukan onboarding ulang akun terhubung yang ada] --> [Ambil akun terhubung] [Perbarui akun terhubung dengan informasi yang dikumpulkan] --> [Jika requirements.currently_due tidak kosong] [Jika requirements.currently_due tidak kosong] --> [Sajikan formulir untuk mengumpulkan informasi dan memvalidasi bidang] ``` Terbaik bila Anda ingin memiliki kontrol penuh atas alur onboarding: - Bangun serta pertahankan seluruh logika alur onboarding Anda sendiri. Dapat bersifat intensif sumber daya dan mahal untuk dibangun. - Anda mengelola risiko dengan tanggung jawab penuh atas pertanggungjawaban saldo negatif pada akun terhubung. - Anda harus tetap memperbarui alur karena persyaratan verifikasi berubah, dan juga membangun alur tambahan untuk mengomunikasikan serta mengumpulkan persyaratan tersebut dari pengguna Anda. Tinjau dan perbarui persyaratan onboarding minimal setiap enam bulan guna memastikan Anda membangun persyaratan terbaru ke dalam alur. - Anda harus membuat formulir custom untuk mengumpulkan rekening bank atau kartu debit sehingga akun terhubung dapat disiapkan dengan rekening payout. ### Siapkan alur dashboard Akun terhubung membutuhkan akses ke dashboard untuk mengelola akunnya. Beri akun terhubung akses ke Dashboard Stripe, Dashboard Express, atau dashboard yang dibuat menggunakan Stripe API dan komponen tersemat. #### Item 1 Berikan akses ke Dashboard Stripe kepada akun terhubung. Dashboard Stripe memberikan akun terhubung akses tidak terbatas ke rangkaian fitur lengkap Stripe menggunakan kredensial login mereka sendiri. Akun terhubung dapat masuk ke dashboard.stripe.com secara langsung kapan saja. Mereka memiliki akses ke dukungan Stripe, dan Stripe dapat berkomunikasi dengan mereka tentang akun mereka. Gunakan Dashboard Stripe saat akun terhubung Anda: - Perlu mengelola kunci API, webhook, atau integrasi pengembang mereka sendiri. - Memerlukan pelaporan keuangan mendetail atau ekspor data. - Memiliki tim dengan kebutuhan akses yang berbeda (misalnya, peran admin dan analis terpisah). - Menggunakan Stripe Apps. Anda dapat menambahkan [komponen tersemat](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) setiap saat ke situs web Anda sendiri secara bersamaan dengan menyediakan akses ke Dashboard Stripe. #### Item 2 Berikan akses ke Dashboard Express kepada akun terhubung untuk mengelola akunnya. Dashboard Express adalah dashboard yang di-hosting Stripe dengan fungsionalitas terbatas yang dapat Anda sesuaikan dengan branding Anda dan dengan mengonfigurasi fitur mana yang didukungnya. Akun terhubung yang menggunakan Dashboard Express memiliki akses ke dukungan Stripe, dan Stripe dapat berkomunikasi dengan mereka tentang akun mereka. Gunakan Dashboard Express saat akun terhubung Anda: - Terutama perlu melacak payout dan aktivitas pembayaran mereka. - Tidak memerlukan alat pengembang atau pelaporan lanjutan. - Dapat menggunakan UI yang sederhana dan efisien. Anda dapat [mengonfigurasi Dashboard Express](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features) untuk menyesuaikan fitur mana, seperti sengketa, pengembalian dana, dan payout manual, yang dapat diakses oleh akun terhubung Anda. Akun terhubung mengakses Dashboard Express melalui [tautan login](https://docs.stripe.com/api/accounts/login_link/create.md) yang Anda buat, daripada masuk di dashboard.stripe.com secara langsung. Anda selalu dapat menambahkan [komponen tersemat Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) ke situs web Anda sendiri bersamaan dengan memberikan akses ke Dashboard Express. #### Item 3 Buat dashboard menggunakan API Stripe atau komponen tersemat guna mengaktifkan akun terhubung untuk mengelola akunnya. Akun terhubung tidak akan memiliki akses ke Dashboard Stripe atau Dashboard Express. Terserah Anda untuk memberikan akses ke alur kerja ini dengan membangun dashboard pengguna, pengembalian dana, alur kerja sengketa, dan fungsionalitas pelaporan. Pengguna mungkin tidak menyadari bahwa mereka memiliki akun Stripe melalui platform Anda. Kami merekomendasikan untuk mengintegrasikan [komponen tersemat Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) guna menambahkan fungsionalitas dashboard ke aplikasi platform Anda dengan upaya integrasi yang rendah. Komponen tersemat ini sangat dapat disesuaikan tampilannya dan dapat mendukung akun terhubung dengan: - Alur kerja pembayaran seperti melihat pembayaran dan payout, mengelola pengembalian dana, serta menanggapi sengketa - Alur kerja payout seperti mengelola jadwal payout, membuat payout manual, atau memperbarui rekening payout - Alur kerja pelaporan untuk mengunduh serta mengekspor pembayaran dan payout - Alur kerja manajemen akun seperti pembaruan informasi bisnis > Untuk akun yang tidak memiliki akses ke Dashboard yang dihosting oleh Stripe dan di mana Stripe bertanggung jawab atas saldo negatif, gunakan komponen tersemat Connect untuk memungkinkan pemilik akun melakukan pembaruan secara mandiri. Anda tidak dapat membuat [Akun Link](https://docs.stripe.com/api/account_links.md) dengan tipe `account_update` untuk akun semacam ini. > #### Jenis dashboard tidak dapat diubah > > Dashboard yang Anda tentukan saat membuat akun terhubung bersifat permanen, jadi pertimbangkan persyaratan bisnis jangka panjang Anda saat memutuskan jenis dashboard. Untuk mengubah dashboard akun terhubung, Anda harus membuat objek `Account` baru. ### Terima pembayaran Anda membuat charge untuk menerima pembayaran dari pelanggan atas nama akun terhubung Anda. Tipe charge yang Anda buat: - Menentukan cara dana pembayaran dibagi di antara semua pihak yang terlibat - Memengaruhi cara charge ditampilkan pada rekening koran tagihan atau bank pelanggan (dengan informasi platform Anda atau milik pengguna) - Menentukan rekening mana yang akan didebit Stripe untuk pengembalian dana dan chargeback #### Item 1 Direct Charges adalah pembayaran konsumen yang dilakukan secara langsung ke akun terhubung. Pelanggan secara langsung melakukan transaksi dengan akun terhubung Anda, sering kali tanpa mengetahui keberadaan platform Anda. Tipe charge ini paling cocok bagi platform yang menyediakan perangkat lunak sebagai layanan. Misalnya, Shopify menyediakan alat untuk membangun toko online, dan Thinkific memungkinkan para pendidik menjual kursus online. #### Item 2 Buat Destination Charges pada platform Anda dan segera transfer dana ke akun terhubung. Pelanggan bertransaksi dengan platform untuk mendapat produk atau layanan yang disediakan oleh akun terhubung Anda. Tipe charge ini paling cocok bagi situs belanja online seperti Airbnb, situs belanja online penyewaan rumah atau Lyft, aplikasi berbagi tumpangan. Destination Charges dibuat pada platform, tetapi sebagai bagian dari operasi charge, dana segera ditransfer ke akun terhubung yang Anda tentukan. Anda dapat memutuskan apakah sebagian atau seluruh dana tersebut akan ditransfer. Kecuali jika memenuhi syarat untuk [pembayaran lintas negara Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), platform dan akun terhubung tempat Anda mentransfer dana harus berada di wilayah yang sama untuk membuat Destination charges. Upaya mentransfer dana ke negara yang tidak diizinkan akan menghasilkan kesalahan. #### Item 3 Buat Separate Charges and Transfers untuk mentransfer dana dari satu pembayaran ke beberapa akun terhubung, atau bila pengguna spesifik tidak dikenal pada waktu charge. Charge pada akun platform tidak dipisahkan dari transfer ke akun terhubung Anda. Tipe charge ini paling cocok bagi situs belanja online yang perlu membagi pembayaran di antara beberapa pihak, seperti DoorDash, sebuah platform pesan-antar restoran. Meski memberikan banyak fleksibilitas, Separate Charges and Transfers memerlukan integrasi yang lebih rumit untuk mengelola saldo akun antara platform dan pengguna. Anda harus memantau saldo akun platform secara cermat guna memastikan bahwa Anda memiliki cukup dana yang tersedia untuk menutupi jumlah transfer. Kecuali jika memenuhi syarat untuk [pembayaran lintas negara Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), platform dan akun terhubung tempat Anda mentransfer dana harus berada di wilayah yang sama untuk menggunakan separate charges and transfers. Upaya mentransfer dana ke negara yang tidak diizinkan akan menghasilkan kesalahan. ### Biaya Stripe #### Item 1 Stripe menagih biaya Stripe dari akun platform Anda, termasuk biaya pemrosesan. Anda mengontrol jumlah biaya pemrosesan yang Anda tagihkan ke akun terhubung. Gunakan parameter biaya aplikasi untuk menagih biaya pemrosesan dari akun terhubung Anda. #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Direct Charges --> [Charge 10 USD] [Charge 10 USD] --> [Biaya aplikasi 0,59 USD] [Charge 10 USD] -- Neto 9,41 USD --> [bank] [Biaya aplikasi 0,59 USD] -- (0,23 USD) Stripe --> [stripe] [Biaya aplikasi 0,59 USD] -- Neto 0,36 USD --> [bank] [account] [platform] ``` #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Charge 10 USD] [Charge 10 USD] --> [Transfer 10 USD] [Transfer 10 USD] --> [Pembayaran 10 USD] [Pembayaran 10 USD] --> [Biaya aplikasi (1,23 USD)] [Biaya aplikasi (1,23 USD)] --> [Neto 8,77 USD] [Biaya aplikasi (1,23 USD)] --> [Biaya aplikasi 1,23 USD] [Biaya aplikasi 1,23 USD] --> [Biaya Stripe (0,59 USD)] [Biaya Stripe (0,59 USD)] --> [stripe] [Biaya Stripe (0,59 USD)] --> [Neto 0,64 USD] [platform] [account] ``` #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Charge 100 USD] [Charge 100 USD] --> [Transfer (70 USD)] [Transfer (70 USD)] --> [Pembayaran 70 USD] [Transfer (70 USD)] --> [Transfer (20 USD)] [Transfer (20 USD)] --> [Pembayaran 20 USD] [Transfer (20 USD)] --> [Biaya Stripe (3,20 USD)] [Biaya Stripe (3,20 USD)] --> [stripe] [Biaya Stripe (3,20 USD)] --> [Neto 6,80 USD] [platform] [account] [account] ``` #### Item 2 Stripe menagih biaya Stripe secara langsung dari akun terhubung. Anda dapat menagih biaya aplikasi opsional bila membuat Direct Charges. (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Direct Charges --> [Charge 10 USD] [Charge 10 USD] --> [Biaya aplikasi (1,23 USD)] [Biaya aplikasi (1,23 USD)] --> [Biaya aplikasi 1,23 USD] [Biaya aplikasi 1,23 USD] --> [platform] [Biaya aplikasi (1,23 USD)] --> [Biaya Stripe (0,59 USD)] [Biaya aplikasi (1,23 USD)] --> [Neto 8,18 USD] [Biaya Stripe (0,59 USD)] --> [stripe] [account] ``` ### Kirim pembayaran kepada pengguna Bila dana dari pembayaran lunas dan akun terhubung pengguna memiliki saldo Stripe positif, Anda dapat mengirim pembayaran dana tersebut ke rekening eksternal mereka. #### Item 1 Jika Anda melakukan onboarding pengguna di alur sendiri menggunakan Stripe API, Anda juga harus mengumpulkan rekening bank atau kartu debit untuk menyiapkan akun terhubung dengan rekening payout. Bila Anda telah mengumpulkan informasi pengguna untuk rekening payout, lampirkan sebagai rekening eksternal. Payout diblokir jika akun terhubung tidak memiliki rekening eksternal terverifikasi. #### Item 2 #### Item 3 Secara default, Stripe mengirim pembayaran dana yang telah lunas di saldo akun terhubung Anda setiap harinya. Jika lebih memilihnya, Anda dapat melakukan konfigurasi jadwal payout otomatis yang berbeda, memicu payout secara manual bukannya secara otomatis, atau mengirim pembayaran secara instan. ### Tanggung jawab atas saldo negatif #### Item 1 Platform Anda bertanggung jawab terhadap kerugian yang terjadi karena saldo negatif pada akun terhubung. Platform Anda bertanggung jawab memeriksa akun terhubung baru selama onboarding dan menentukan profil risiko pengguna Anda. Direkomendasikan untuk situs belanja online yang memungut pembayaran dari pelanggan untuk payout ke penjual, atau untuk platform tingkat lanjut yang menginginkan kendali penuh atas bagaimana risiko dan liabilitas negatif dikelola pada akun terhubung: - Platform Anda harus memantau akun terhubung untuk risiko kerugian yang berkelanjutan. - Platform Anda harus membangun alur untuk mengomunikasikan dan melakukan remediasi akun terhubung bila Anda mendeteksi penipuan atau risiko. - Anda memiliki tim operasional maupun sumber daya teknis untuk membangun proses guna mengelola risiko kerugian yang berkelanjutan dan mencegah penipuan. Sebelum membuat akun dengan penyiapan ini, pertimbangkan secara cermat dan akui tanggung jawab platform Anda untuk pertanggungjawaban saldo negatif. #### Item 2 Stripe memantau sinyal risiko pada akun terhubung, menerapkan intervensi risiko pada akun terhubung sebagai tanggapan terhadap sinyal yang diamati, dan berusaha untuk memulihkan saldo negatif dari akun terhubung Anda. Bagi sebagian besar platform perangkat lunak sebagai layanan, ini merupakan pilihan default terbaik, terutama bagi mereka yang baru tahu penyematan pembayaran: - Stripe memantau akun terhubung Anda untuk risiko penipuan dan kredit, serta proteksi terhadap risiko kerugian jika terjadi saldo negatif yang diatribusikan ke risiko bisnis. - Stripe menangani seluruh komunikasi dan remediasi dari hulu ke hilir secara langsung dengan akun terhubung Anda melalui alur yang di-hosting atau komponen tersemat. #### Item 1 > #### Versi API pratinjau diperlukan untuk Dashboard Express > > Menggabungkan akses Dashboard Express dengan tanggung jawab Stripe atas saldo negatif saat ini berada dalam tahap [pratinjau publik](https://docs.stripe.com/release-phases.md). Gunakan string versi pratinjau saat ini (`2026-10-28.preview`) dalam konfigurasi SDK Stripe Anda saat membuat akun terhubung. > > Kode dan perintah yang dihasilkan di halaman ini menggunakan versi API yang tersedia secara umum saat ini. Ganti versi tersebut dengan string versi pratinjau jika Anda menggunakan kombinasi ini. #### Item 2 #### Item 3 #### Item 1 #### Komponen tersemat yang diperlukan Bila Stripe bertanggung jawab atas saldo negatif pada akun terhubung, Anda harus mengintegrasikan komponen tersemat untuk onboarding, manajemen akun, dan spanduk notifikasi. Stripe menggunakan komponen spanduk notifikasi tersemat untuk memberi tahu akun terhubung tentang persyaratan yang belum terpenuhi atau permintaan terkait risiko terkelola lainnya. Komponen manajemen akun diperlukan agar akun terhubung dapat mengelola kredensial autentikasi dan informasi bisnisnya. Stripe juga mengirim email ke akun terhubung atas nama Anda untuk mengelola risiko dan mengonfirmasi kepatuhan yang berkelanjutan. Anda dapat menyesuaikan serta membuat brand komunikasi email ini dengan branding platform dan domain email Anda sendiri. Untuk komponen opsional lainnya, Anda juga dapat menggunakan [komponen tersemat](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) atau membangun UI sendiri. #### Item 2 #### Item 3 ## Langkah-langkah integrasi untuk pilihan Anda Langkah-langkah integrasi berikut didasarkan pada opsi yang Anda pilih di atas. Anda dapat melihat langkah-langkah yang berbeda dengan memilih berbagai opsi di atas atau pada panel di sebelah kanan langkah-langkah. Opsi pada halaman ini hanya mengontrol langkah-langkah yang ditampilkan di bawah ini. Konfigurasi platform Anda tidak terpengaruh. Tombol berikut menghasilkan perintah LLM berdasarkan pilihan Anda. Fitur ini hanya mendukung Dashboard yang dihosting oleh Stripe dan proses onboarding yang dihosting.