Memicu tindakan dengan webhook
Webhook adalah endpoint HTTP yang menerima kejadian dari Stripe.
Webhook memungkinkan Anda diberi tahu tentang kejadian pembayaran di dunia nyata di luar alur pembayaran seperti:
- Pembayaran yang berhasil (
payment_intent.succeeded
) - Pembayaran yang dipersengketakan (
charge.dispute.created
) - Saldo yang tersedia di akun Stripe Anda (
balance.available
)
Meskipun Dashboard sangat bagus untuk tindakan satu kali seperti mengembalikan dana pembayaran atau memperbarui informasi pelanggan, webhook sangat penting untuk menskalakan integrasi pembayaran dengan membantu Anda memproses kejadian bisnis penting dalam volume besar.
Bangun webhook Anda sendiri
Anda dapat membuat webhook handler di server sendiri untuk mengelola semua alur pembayaran offline. Mulailah dengan mengungkapkan endpoint yang dapat menerima permintaan dari Stripe dan menggunakan CLI untuk mencoba integrasi secara lokal. Setiap permintaan dari Stripe berisi objek Event dengan referensi ke objek di Stripe yang telah dimodifikasi.
Buat endpoint webhook
Tambahkan endpoint baru di aplikasi Anda. Anda dapat bertindak atas kejadian tertentu dengan memeriksa bidang type
objek kejadian yang dikirim dalam isi permintaan. Untuk saat ini, cetaklah ke output standar untuk memastikan webhook berfungsi.
Mulai server Anda setelah menambahkan endpoint baru.
Instal dan siapkan Stripe CLI
Untuk opsi instalasi tambahan, lihat Mulai dengan Stripe CLI.
Setelah Anda menginstal Stripe CLI, jalankan stripe login
di baris perintah untuk menghasilkan kode pemasangan yang akan ditautkan dengan akun Stripe Anda. Tekan Enter untuk membuka browser dan masuk ke akun Stripe Anda untuk mengizinkan akses. Kunci API yang dihasilkan berlaku selama 90 hari. Anda dapat mengubah atau menghapus kunci pada Kunci API di Dashboard.
stripe login Your pairing code is: humour-nifty-finer-magic Press Enter to open up the browser (^C to quit)
Jika Anda ingin menggunakan kunci API yang ada, gunakan tanda --api-key
:
stripe login --api-key
Your pairing code is: humour-nifty-finer-magic Press Enter to open up the browser (^C to quit)sk_test_4eC39HqLyjWDarjtT1zdp7dc
Coba webhook Anda secara lokal
Gunakan CLI untuk meneruskan kejadian ke endpoint webhook lokal Anda menggunakan perintah listen
.
Dengan asumsi aplikasi Anda berjalan di port 4242, jalankan:
stripe listen --forward-to http://localhost:4242/webhook
Di tab terminal yang berbeda, gunakan perintah CLI trigger
untuk memicu kejadian webhook rekaan.
stripe trigger payment_intent.succeeded
Anda harus melihat kejadian follow di tab listen
:
[200 POST] OK payment_intent.succeeded
Anda juga akan melihat “PaymentIntent berhasil!” dicetak di tab terminal yang menjalankan server Anda.
Gunakan endpoint webhook Anda
Bila Anda siap menggunakan endpoint webhook ke produksi, ada beberapa hal yang perlu dilakukan:
Gunakan kunci API mode live dan bukan kunci mode percobaan Anda.
Konfigurasikan endpoint webhook Anda di Dashboard Stripe atau dengan API.
Untuk mengonfigurasi endpoint Anda di Dashboard, buka pengaturan webhook.
Klik “Tambahkan endpoint” dan masukkan URL endpoint Anda, versi API Stripe, dan kejadian spesifik yang Anda ingin agar dikirim oleh Stripe.
Ganti webhook endpoint secret di aplikasi Anda dengan secret baru yang ditampilkan di tampilan Dashboard endpoint.
Itu saja! Aplikasi Anda siap menerima kejadian langsung. Untuk informasi selengkapnya tentang mengonfigurasi endpoint webhook Anda, Webhook Endpoint API, dan mencoba dalam mode percobaan lihat panduan Pengembangan kami.