Ekstensi terdahuluTidak lagi digunakan
Stripe Apps menggantikan ekstensi
Anda tidak lagi dapat membuat ekstensi Stripe baru. Stripe Apps menggantikan ekstensi untuk pengembangan di Stripe. Namun, ekstensi yang ada akan terus berfungsi hingga tahun 2024. Jika Anda sudah memiliki ekstensi, kami merekomendasikan untuk melakukan migrasi ke Stripe Apps.
Catatan
Sekarang Anda dapat secara otomatis mengirim laporan dan data Stripe ke Snowflake atau Amazon Redshift dalam beberapa klik dengan Stripe Data Pipeline. Pelajari selengkapnya.
Produk dan fitur Stripe memungkinkan perusahaan menerima pembayaran online, tetapi juga menawarkan alasan lain untuk diintegrasikan. Perusahaan seperti Baremetrics dan Segment membangun di atas Stripe untuk menyediakan layanan mereka kepada akun Stripe dengan dashboard Standard.
Membangun ekstensi di Stripe terdiri dari empat langkah:
- Konfigurasikan OAuth dan tentukan URL pengalihan.
- Konfigurasikan pengaturan branding.
- Buat tautan OAuth untuk pengguna Anda.
- Gunakan API atas nama akun terhubung.
Anda juga diharuskan untuk menambahkan detail bisnis untuk mengaktifkan akun Anda, jika Anda belum melakukannya.
Untuk memulai, kunjungi halaman Ekstensi yang berada di tab Pengembang dari dashboard Stripe.
Konfigurasikan OAuth dan tentukan URL pengalihan
Anda dapat mengonfigurasikan pengaturan ini di bagian Integrasi dari halaman Pengaturan Ekstensi.
Mulai integrasi Anda dengan memindahkan tombol agar dapat melakukan onboarding pada akun Standard dengan OAuth. Ekstensi tidak boleh menggunakan OAuth dengan akun Express.
Stripe menyediakan identifier unik untuk ekstensi Anda yang disebut client_id
. Anda mengatur redirect_uri
dan pengguna diarahkan ke alamat itu setelah mereka menghubungkan akunnya. Versi pengembangan dan produksi dari dua nilai ini membuat percobaan lebih mudah. Catat nilai ini agar Anda dapat membuat tautan OAuth di langkah ketiga.
Konfigurasikan pengaturan branding
Anda dapat menyesuaikan cara bisnis Anda ditampilkan kepada pengguna Anda dalam bagian Branding dari halaman Pengaturan Ekstensi.
Pengguna melihat logo Anda bila mereka menautkan akun Stripe ke aplikasi. Setelah mereka menautkan akun mereka, ikon Anda ditampilkan di daftar aplikasi yang terhubung.
Buat tautan OAuth untuk pengguna Anda
Stripe menawarkan alur OAuth 2.0 standar untuk menghubungkan ke akun Stripe. Dengan memakai nilai client_id
dan redirect_uri
dari langkah pertama, Anda dapat membuat tautan OAuth bagi pengguna Anda untuk melakukan onboarding. Kami merekomendasikan untuk menampilkan tautan ini dengan tombol Hubungkan dengan Stripe yang mengirimkan pengguna ke endpoint authorize_url
:
https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb&scope=read_only
Berikut suatu contoh tentang bagaimana Anda dapat menampilkan tautan di atas kepada pengguna, bersama dengan tombol Hubungkan dengan Stripe:
Terhubung denganSetelah pengguna mengklik tautan pada situs Anda, kami akan mengarahkan mereka ke suatu halaman untuk mengizinkan atau menolak koneksi ke ekstensi Anda. Alur otorisasi Stripe akan meminta mereka untuk memilih akun yang sudah ada saat ini untuk menghubungkan koneksi Anda, atau membuat yang baru.
Setelah pengguna menghubungkan akun mereka saat ini atau akun yang baru dibuat ke ekstensi Anda, kami akan mengarahkan ulang mereka kembali ke URL yang Anda atur sebagai redirect_uri
ekstensi.
Di akhir alur kerja OAuth, Anda diberikan kredensial otorisasi untuk akun pengguna:
{ ... "stripe_user_id": "acct_0123456789", ... }
Anda perlu menyimpan stripe_user_id
agar dapat mengidentifikasi akun pengguna.
Gunakan API atas nama akun terhubung
Setelah pengguna menautkan akun Stripe mereka ke aplikasi, Anda dapat membuat permintaan API) atas nama mereka. Untuk melakukan permintaan API, Anda membutuhkan kunci rahasia akun ekstensi dan header Stripe-Account
yang mengidentifikasi akun yang Anda minta. Semua pustaka Stripe mendukung gaya autentikasi ini berdasarkan permintaan.
Mengambil data tersimpan
Data tersimpan menyertakan informasi seperti charge dan detail pelanggan. Dengan akses read_only
, Anda dapat membuat sebagian besar permintaan GET
di API Stripe. Anda dapat mengambil satu objek (misalnya ambil Payment Intent) atau daftar objek (misalnya cantumkan semua Payment Intents).
Meski API ini performanya secara umum, pengambilan set data dalam jumlah besar akan memperlambat daya tanggap aplikasi Anda. Kami merekomendasikan penyimpanan data yang diambil di sisi Anda untuk analisis dan pelaporan.
Mendengar data secara aktual
Selain data tersimpan, Anda dapat mengakses data secara aktual melalui webhook. Begitu Anda menentukan ekstensi endpoint webhook di akun, Stripe mengirimkan notifikasi kejadian ke endpoint Anda untuk setiap akun terhubung. Properti account
dari objek kejadian mengidentifikasi akun tempat terjadinya kejadian tersebut.
Misalnya, kejadian di bawah ini menunjukkan bahwa pelanggan dibuat di akun acct_0123456789
. Sekali lagi, kami merekomendasikan penyimpanan data ini di pihak Anda untuk analisis dan pelaporan. Dengan mengamati kejadian yang sedang berlangsung, aplikasi dapat merespons lebih cepat, dan Anda tidak perlu melakukan banyak panggilan API.
{ "id": "evt_6JNjxkkcDPwIkV", "livemode": true, "object": "event", "type": "customer.created", "account": "acct_0123456789", "pending_webhooks": 2, "created": 1349654313, "data": {...} }
Men-charge aplikasi Anda
Akun Stripe ekstensi dapat memproses charge-nya sendiri, jadi Anda tetap dapat mengenakan charge untuk aplikasi dengan akses read_only
. Setelah pelanggan menghubungkan akun Stripe mereka, minta detail pembayaran mereka kemudian buat langganan untuk mereka di akun Stripe Anda. Pastikan untuk menyimpan identifikasi pelanggan yang dibuat dengan identifikasi akun Stripe yang dikaitkan, sehingga Anda dapat melacak pengguna mana yang dibayar dan aktif, dan mana yang tidak.
Jika membuat langganan, Anda juga dapat menentukan application_fee_percent
sebagai biaya untuk aplikasi. Biaya ini dikenakan di luar biaya Stripe. Baca dokumentasi Subscriptions untuk mempelajari selengkapnya.
Akun terputus
Pengguna dapat memutuskan koneksi akun mereka dari integrasi Anda setiap saat. Jika hal ini terjadi, Stripe mengirim kejadian webhook account.application.deauthorized
. Anda dapat menggunakan notifikasi ini untuk memicu pembersihan di pihak Anda, seperti menonaktifkan akun pengguna di situs Anda atau menghapus data mereka.
Anda juga dapat memutuskan koneksi akun dari integrasi, dengan membuat permintaan ke endpoint pencabutan otorisasi OAuth.