Gunakan Stripe CLI

Bangun, uji, dan kelola integrasi Stripe Anda dari baris perintah.

Stripe CLI memungkinkan Anda membangun, menguji, dan mengelola integrasi Stripe Anda dari baris perintah. Dengan CLI, Anda dapat membuat dan mengelola sumber daya Stripe, memicu peristiwa webhook, mengalirkan catatan permintaan API secara real-time, serta meneruskan peristiwa ke lingkungan pengembangan lokal Anda.

Tentukan versi API saat menjalankan permintaan.

Ketika Anda memanggil API Stripe di CLI, perintah ini menggunakan versi API bawaan Anda dalam semua permintaan, yang dapat Anda identifikasi di Workbench. Untuk mencoba versi API yang berbeda di CLI, gunakan flag berikut:

Flag	Deskripsi	Contoh
`--stripe-version 2025-08-27.basil`	Gunakan flag `--stripe-version` dalam permintaan CLI apa pun untuk menentukan versi API.	`stripe products create --name=“My Product” --stripe-version 2025-08-27.basil`
`--latest`	Gunakan flag `--latest` dalam permintaan CLI apa pun untuk menentukan versi API terbaru.	`stripe products create --name="My Product" --latest`

Anda juga dapat melihat daftar versi API.

Alirkan catatan permintaan

Gunakan perintah stripe logs tail untuk mengalirkan catatan permintaan API. Biarkan jendela ini tetap terbuka. Jika terjadi kesalahan pada pemanggilan API Anda, terminal ini akan menampilkan pesan kesalahan API beserta alasan kesalahannya.

Command Line
stripe logs tail

Teruskan peristiwa ke endpoint webhook lokal Anda.

Gunakan flag --forward-to untuk mengirim semua peristiwa Stripe dalam sandbox ke endpoint webhook lokal Anda. Untuk menonaktifkan verifikasi sertifikat HTTPS, gunakan flag --skip-verify.

Command Line
stripe listen --forward-to localhost:4242/webhooks

Output
Ready! Your webhook signing secret is '{{WEBHOOK_SIGNING_SECRET}}' (^C to quit)

Untuk meneruskan peristiwa tertentu dalam daftar yang dipisahkan koma, gunakan flag--events.

Command Line
stripe listen --events payment_intent.created,customer.created,payment_intent.succeeded,charge.succeeded,checkout.session.completed,charge.failed \
  --forward-to localhost:4242/webhook

Jika sudah mendaftarkan endpoint Anda di Stripe, Anda dapat menggunakan flag --load-from-webhook-api dan --forward-to.

Command Line
stripe listen --load-from-webhooks-api --forward-to localhost:4242

Perintah ini meneruskan peristiwa yang dikirim ke endpoint webhook publik Anda yang terdaftar di Stripe ke endpoint webhook lokal Anda. Perintah ini memuat endpoint terdaftar Anda, mengurai jalur serta peristiwa yang terdaftar di dalamnya, lalu menambahkan jalur tersebut ke endpoint webhook lokal Anda pada jalur --forward-to. Jika Anda memeriksa tanda tangan webhook, gunakan {{WEBHOOK_SIGNING_SECRET}} dari keluaran awal perintah listen.

Tampilkan semua peristiwa yang tersedia.

Gunakan flag bantuan (--help) untuk menampilkan semua peristiwa yang mungkin terjadi pada suatu kategori peristiwa. Sebagai contoh, untuk menampilkan semua peristiwa yang mungkin terjadi pada halaman pembayaran siap pakai untuk Stripe Checkout:

Command Line
stripe trigger checkout --help

Buat produk dan harga satu kali.

Lakukan satu permintaan API untuk Membuat produk.

Command Line
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"

Cari pengenal produk (dalam id) pada objek respons. Simpan untuk langkah berikutnya. Jika semua berjalan dengan baik, baris perintah akan menampilkan respons berikut:
```
{
  "id": "prod_LTenIrmp8Q67sa",
  "object": "product",
```
Panggil Create a price untuk menetapkan harga sebesar 30 USD. Ganti placeholder pada product dengan pengenal produk Anda (misalnya, prod_LTenIrmp8Q67sa).
Command Line
```
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product={{PRODUCT_ID}}
```
Jika semua berjalan dengan baik, baris perintah akan menampilkan respons berikut:
```
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",
```

Picu peristiwa webhook saat pengujian.

Picu peristiwa checkout.session.completed untuk membuat objek API yang dihasilkan dari sesi checkout yang berhasil diselesaikan.

Command Line
stripe trigger checkout.session.completed

Terminal stripe listen Anda menampilkan keluaran berikut:

Command Line

Setting up fixture for: checkout_session
Running fixture for: checkout_session
Setting up fixture for: payment_page
Running fixture for: payment_page
Setting up fixture for: payment_method
Running fixture for: payment_method
Setting up fixture for: payment_page_confirm
Running fixture for: payment_page_confirm
Trigger succeeded!