# Siapkan lingkungan pengembangan Anda Pahami Stripe CLI dan SDK sisi server kami. Periksa [dokumen tanpa kode](https://docs.stripe.com/no-code.md) kami, gunakan [solusi siap-rakit](https://stripe.com/partners/directory) dari direktori mitra kami, atau rekrut [pakar bersertifikat Stripe](https://stripe.com/partners/directory?t=Consulting). SDK sisi server dan antarmuka baris perintah (CLI) Stripe memungkinkan Anda berinteraksi dengan REST API Stripe. Mulailah dengan Stripe CLI untuk mengefisienkan lingkungan pengembangan Anda dan melakukan panggilan API. Gunakan SDK untuk menghindari penulisan kode boilerplate. Untuk mulai mengirim permintaan dari lingkungan Anda, pilih bahasa untuk mengikuti panduan mulai cepat. > #### Ekstensi Chrome > > Kami merekomendasikan Anda membangun integrasi pembayaran dengan Stripe, (seperti [Elements](https://docs.stripe.com/payments/elements.md) atau [Checkout](https://docs.stripe.com/payments/checkout.md)) pada situs web Anda sendiri. Kemudian, siapkan ekstensi Chrome untuk mengarahkan pengguna ke halaman pembayaran ini setelah siap menyelesaikan pembelian. > > Metode ini lebih aman dan lebih mudah dikelola daripada mencoba menangani pembayaran secara langsung di dalam ekstensi. # Ruby > This is a Ruby for when lang is ruby. View the full page at https://docs.stripe.com/get-started/development-environment?lang=ruby. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe Ruby server-side SDK](https://github.com/stripe/stripe-ruby) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa Ruby. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan bundler dengan RubyGems - Cara menginstal Stripe Ruby SDK v18.4.0 - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Kelola dependensi pihak ketiga Kami merekomendasikan untuk mengelola dependensi pihak ketiga menggunakan alat baris perintah [RubyGems](http://rubygems.org/), yang memungkinkan Anda menambahkan pustaka baru dan memasukkannya ke dalam proyek Ruby. Periksa apakah RubyGems diinstal: ### Instal RubyGems #### Instal RubyGems ```bash gem --version ``` Jika Anda mendapatkan `gem: command not found`, [unduh RubyGems](http://rubygems.org/pages/download) dari halaman unduhan mereka. ## Menginstal SDK sisi server Ruby Versi terbaru dari SDK sisi server Stripe Ruby adalah v18.4.0. Ini mendukung Ruby versi 2.3+. Periksa versi Ruby Anda: ```bash ruby -v ``` ### Instal pustaka [Buat file gem](https://guides.rubygems.org/make-your-own-gem/) dan instal gem yang dihasilkan menggunakan bundler dengan [RubyGems](https://rubygems.org/). Tambahkan versi terbaru dari [gem Stripe](https://rubygems.org/gems/stripe) ke sebuah proyek: ```bash bundle add stripe ``` Instal gem yang diperlukan dari sumber yang Anda tentukan: ```bash bundle install ``` ### Alternatif instalasi **Tambahkan sebagai dependensi**—Tambahkan versi pustaka terbaru sebagai dependensi gem: ```ruby source 'https://rubygems.org' gem 'rails' gem 'stripe' ``` **Instalasi global**—Instalasi pustaka secara global dengan [RubyGems](https://rubygems.org/): ```bash gem install stripe ``` **Instalasi manual**—[Bangun gem dari sumber](https://github.com/stripe/stripe-ruby), lalu instal pustaka dengan menjalankan: ```bash gem build stripe.gemspec ``` ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal Ruby SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```ruby require 'rubygems' require 'stripe' Stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2" starter_subscription = Stripe::Product.create( name: 'Starter Subscription', description: '$12/Month subscription', ) starter_subscription_price = Stripe::Price.create( currency: 'usd', unit_amount: 1200, recurring: {interval: 'month'}, product: starter_subscription['id'], ) puts "Success! Here is your starter subscription product id: #{starter_subscription.id}" puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}" ``` Simpan file sebagai `create_price.rb`. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### create_price.rb ```bash ruby create_price.rb ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # Python > This is a Python for when lang is python. View the full page at https://docs.stripe.com/get-started/development-environment?lang=python. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe Python server-side SDK](https://github.com/stripe/stripe-python) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa Python. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan lingkungan virtual dan manajer paket pip - Cara menginstal Stripe Python SDK v14.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Kelola dependensi pihak ketiga Sebaiknya kelola dependensi pihak ketiga menggunakan modul [venv](https://docs.python.org/3/tutorial/venv.html), yang memungkinkan Anda menambahkan pustaka baru dan menyertakannya dalam proyek Python 3 Anda. ### Di Windows (cmd.exe): #### Di Windows (cmd.exe) ```bash python3 -m venv env .\env\Scripts\activate.bat ``` ### Di GNU Linux atau MacOS (bash): #### Di GNU/Linux atau MacOS (bash) ```bash python3 -m venv env source env/bin/activate ``` ## Menginstal SDK sisi server Python Versi terbaru SDK sisi server Stripe Python adalah v14.4.0. Ini mendukung versi Python 3.6+. Periksa versi Python Anda: ```bash python3 --version ``` ### Instal pustaka Instal pustaka dari [PyPi](http://pypi.python.org/pypi/stripe/), pengelola paket untuk Python: ```bash pip3 install --upgrade stripe ``` Selanjutnya, tentukan versi berikut di file requirements.txt Anda: ```txt stripe>=14.4.0 ``` ### Alternatif instalasi **Instalasi manual**—[Unduh kode sumber](https://github.com/stripe/stripe-python) untuk SDK, lalu instal pustaka dengan menjalankan: ```bash python3 setup.py install ``` ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal Python SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```python import stripe stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2" starter_subscription = stripe.Product.create( name="Starter Subscription", description="$12/Month subscription", ) starter_subscription_price = stripe.Price.create( unit_amount=1200, currency="usd", recurring={"interval": "month"}, product=starter_subscription['id'], ) # Save these identifiers print(f"Success! Here is your starter subscription product id: {starter_subscription.id}") print(f"Success! Here is your starter subscription price id: {starter_subscription_price.id}") ``` Simpan file sebagai `create_price.py`. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### create_price.py ```bash python3 create_price.py ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # Go > This is a Go for when lang is go. View the full page at https://docs.stripe.com/get-started/development-environment?lang=go. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe Go server-side SDK](https://github.com/stripe/stripe-go) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa Go. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan modul Go - Cara menginstal Stripe Go SDK v84.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Kelola dependensi pihak ketiga Sebaiknya kelola dependensi pihak ketiga menggunakan [modul Go](https://go.dev/blog/using-go-modules), yang memungkinkan Anda menambahkan pustaka baru dan memasukkannya ke dalam project Go Anda. ### Inisialisasi Go Jika Anda memulai dari nol di direktori baru, Anda perlu terlebih dahulu membuat file `go.mod` untuk melacak dependensi. Misalnya: #### Inisialisasi Go ```bash go mod init stripe-example ``` ## Menginstal SDK sisi server Go Versi terbaru SDK sisi server Stripe Go adalah v84.4.0. Ini mendukung Go versi 1.15+. ### Instal pustaka Instal pustaka dengan [modul Go](https://go.dev/blog/using-go-modules), pengelola paket untuk Go: ```bash go get github.com/stripe/stripe-go/v84 ``` Setelah Anda menginstal pustaka dengan modul Go ke proyek *new*, pustaka secara otomatis ditambahkan sebagai dependensi dalam file go.mod proyek Anda. Sebagai contoh: ```go.mod module stripe-example go 1.18 require github.com/stripe/stripe-go/v84 84.4.0 // indirect ``` ### Sinkronkan dependensi Untuk menjaga agar dependensi terkelola tetap rapi untuk project *existing*, jalankan perintah berikut untuk [menyinkronkan dependensi kode Anda](https://go.dev/doc/modules/managing-dependencies). ```bash go mod tidy ``` ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal Go SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```go package main import ( "fmt" "github.com/stripe/stripe-go/v84" "github.com/stripe/stripe-go/v84/product" "github.com/stripe/stripe-go/v84/price" ) func main() { stripe.Key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2" product_params := &stripe.ProductParams{ Name: stripe.String("Starter Subscription"), Description: stripe.String("$12/Month subscription"), } starter_product, _ := product.New(product_params) price_params := &stripe.PriceParams{ Currency: stripe.String(string(stripe.CurrencyUSD)), Product: stripe.String(starter_product.ID), Recurring: &stripe.PriceRecurringParams{ Interval: stripe.String(string(stripe.PriceRecurringIntervalMonth)), }, UnitAmount: stripe.Int64(1200), } starter_price, _ := price.New(price_params) fmt.Println("Success! Here is your starter subscription product id: " + starter_product.ID) fmt.Println("Success! Here is your starter subscription price id: " + starter_price.ID) } ``` Simpan file sebagai `create_price.go`. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### create_price.rb ```bash go run create_price.go ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # Java > This is a Java for when lang is java. View the full page at https://docs.stripe.com/get-started/development-environment?lang=java. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe Java server-side SDK](https://github.com/stripe/stripe-java) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa Java. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan Maven atau Gradle - Cara menginstal Stripe Java SDK v31.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Kelola dependensi pihak ketiga Kami merekomendasikan untuk mengelola dependensi pihak ketiga menggunakan [Maven](https://maven.apache.org/guides/getting-started/index.html) atau [Gradle](https://docs.gradle.org), yang membantu menambahkan pustaka baru dan menyertakannya dalam proyek Java Anda. ### Inisialisasi proyek - Untuk membuat proyek dengan **Maven**, lihat [Bagaimana cara membuat proyek Maven pertama saya?](https://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project). - Untuk membuat proyek dengan **Gradle**, lihat [Contoh Membuat Aplikasi Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html). ## Menginstal SDK sisi server Java Versi terbaru dari SDK sisi server Stripe Java adalah v31.4.0. Ini mendukung Java versi 1.8+. Periksa versi Java Anda: ```bash java -version ``` ### Instal pustaka - Dengan **Maven**, tempatkan yang berikut ini di file pom.xml proyek Anda: ```xml com.stripe stripe-java 31.4.0 ``` - Dengan **Gradle**, tempel baris berikutnya di dalam blok dependensi file build.gradle Anda: ```groovy implementation 'com.stripe:stripe-java:31.4.0' ``` ### Alternatif instalasi **Instalasi manual**—Anda dapat menginstal stripe-java secara manual dengan JAR berikut: [Unduh Stripe JAR (.jar)](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST). [Unduh JAR Gson (.jar)](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) untuk [Google Gson](https://github.com/google/gson). **Proguard**—Jika Anda menggunakan ProGuard, pastikan untuk mengecualikan pustaka dengan menambahkan yang berikut ke file `proguard.cfg` Anda: ```proguard -keep class com.stripe.** { *; } ``` ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal Java SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```java package com.stripe.sample; import com.stripe.Stripe; import com.stripe.exception.StripeException; import com.stripe.model.Product; import com.stripe.param.ProductCreateParams; import com.stripe.param.PriceCreateParams; import com.stripe.model.Price; public class Server { public static void main(String[] args) throws StripeException { Stripe.apiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"; ProductCreateParams productParams = ProductCreateParams.builder() .setName("Starter Subscription") .setDescription("$12/Month subscription") .build(); Product product = Product.create(productParams); System.out.println("Success! Here is your starter subscription product id: " + product.getId()); PriceCreateParams params = PriceCreateParams .builder() .setProduct(product.getId()) .setCurrency("usd") .setUnitAmount(1200L) .setRecurring( PriceCreateParams.Recurring .builder() .setInterval(PriceCreateParams.Recurring.Interval.MONTH) .build()) .build(); Price price = Price.create(params); System.out.println("Success! Here is your starter subscription price id: " + price.getId()); } } ``` Simpan file sebagai `CreatePrice.java`. Dari proyek di IDE Anda untuk Maven atau Gradle, jalankan sampel. Misalnya: `Run 'CreatePrice.main()'`. Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # Node.js > This is a Node.js for when lang is node. View the full page at https://docs.stripe.com/get-started/development-environment?lang=node. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe Node.js server-side SDK](https://github.com/stripe/stripe-node) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa Node.js. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Bagaimana mengelola dependensi pihak ketiga menggunakan npm atau manajer paket Yarn - Cara menginstal Stripe Node SDK v20.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Menginstal SDK sisi server Node.js Versi terbaru SDK sisi server Stripe Node.js adalah v20.4.0. Ini mendukung Node.js versi 12+. Periksa versi Node Anda: ```bash node --version ``` ### Inisialisasi Node #### Inisialisasi Node ```bash npm init ``` ### Instal pustaka Instal pustaka dengan [npm](https://www.npmjs.com/package/node), manajer paket untuk Node: ```bash npm install stripe --save ``` Setelah Anda menginstal pustaka dengan npm, pustaka secara otomatis ditambahkan sebagai dependensi dalam file package.json proyek Anda. Sebagai contoh: ```json { "name": "stripe-node-example", "version": "1.0.0", "description": "A Stripe demo", "main": "index.js", "scripts": { "node ": "node create_price.js", "test": "echo \"Error: no test specified\" && exit 1" }, "author": "", "license": "ISC", "dependencies": { "stripe": "^20.4.0" } } ``` ### Alternatif instalasi **Yarn**—Anda dapat menginstal pustaka dengan [yarn](https://yarnpkg.com/), manajer paket lain untuk Node: ```bash yarn add stripe ``` ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal Node.js SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. SDK Node.js mengembalikan [janji](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) yang dapat digunakan sebagai callback yang dapat dirantai. Untuk mendemonstrasikannya, kami meneruskan pengidentifikasi produk yang dikembalikan dalam respons Produk untuk membuat Harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```node const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2'); stripe.products.create({ name: 'Starter Subscription', description: '$12/Month subscription', }).then(product => { stripe.prices.create({ unit_amount: 1200, currency: 'usd', recurring: { interval: 'month', }, product: product.id, }).then(price => { console.log('Success! Here is your starter subscription product id: ' + product.id); console.log('Success! Here is your starter subscription price id: ' + price.id); }); }); ``` Simpan file sebagai `create_price.js`. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### create_price.js ```bash node create_price.js ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # PHP > This is a PHP for when lang is php. View the full page at https://docs.stripe.com/get-started/development-environment?lang=php. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe PHP server-side SDK](https://github.com/stripe/stripe-php) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa PHP. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan Composer - Cara menginstal Stripe PHP SDK v19.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Kelola dependensi pihak ketiga Sebaiknya kelola dependensi pihak ketiga dari [Packagist](https://packagist.org/) menggunakan [Composer](https://getcomposer.org/download/), yang memungkinkan Anda menambahkan pustaka baru dan menyertakannya di proyek PHP. ### Instal Composer Dari baris perintah, [unduh Composer](https://getcomposer.org/download/) menggunakan petunjuk. ## Menginstal SDK sisi server PHP Versi terbaru dari SDK sisi server Stripe PHP adalah v19.4.0. Ini mendukung PHP versi 5.6.0+. Periksa versi PHP Anda: ```bash php --version ``` ### Instal pustaka Instal pustaka dengan [Composer](http://getcomposer.org/), manajer paket untuk PHP: ```bash composer require stripe/stripe-php ``` Setelah Anda menginstal pustaka dengan Composer, pustaka ini secara otomatis ditambahkan sebagai dependensi dalam file composer.json proyek Anda. Sebagai contoh: ```json { "require": { "stripe/stripe-php": "^19.4.0" } } ``` Untuk menggunakan binding, gunakan [autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading) Composer. Sebagai contoh: ```php require_once('vendor/autoload.php'); ``` ### Alternatif instalasi **Instalasi manual** Anda dapat [mengunduh rilis terbaru](https://github.com/stripe/stripe-php/releases) untuk menggunakan binding, lalu sertakan file init.php: ```php require_once('/path/to/stripe-php/init.php'); ``` Kemudian, tambahkan ekstensi berikut: [cURL](https://secure.php.net/manual/en/book.curl.php) (atau opsional, gunakan klien non-curl Anda sendiri) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php) ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal PHP SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```php products->create([ 'name' => 'Starter Subscription', 'description' => '$12/Month subscription', ]); echo "Success! Here is your starter subscription product id: " . $product->id . "\n"; $price = $stripe->prices->create([ 'unit_amount' => 1200, 'currency' => 'usd', 'recurring' => ['interval' => 'month'], 'product' => $product['id'], ]); echo "Success! Here is your starter subscription price id: " . $price->id . "\n"; ?> ``` Simpan file sebagai `create_price.php`. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### create_price.php ```bash php create_price.php ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: price_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) # .NET > This is a .NET for when lang is dotnet. View the full page at https://docs.stripe.com/get-started/development-environment?lang=dotnet. Dalam panduan cepat ini, Anda akan menginstal [Stripe CLI](https://docs.stripe.com/stripe-cli.md)—alat penting yang memberi Anda akses melalui baris perintah ke integrasi Stripe. Anda juga akan menginstal [Stripe .NET server-side SDK](https://github.com/stripe/stripe-dotnet) untuk mendapatkan akses ke API Stripe dari aplikasi yang ditulis dalam bahasa C#. ## Apa yang Anda pelajari Dalam panduan mulai cepat ini, Anda akan mempelajari: - Cara memanggil API Stripe tanpa menulis sebaris kode - Cara mengelola dependensi pihak ketiga menggunakan .NET Core CLI, NuGet CLI atau Package Manager Console - Cara menginstal Stripe .NET SDK v50.4.0 terbaru - Cara mengirim permintaan SDK pertama Anda ## Pengaturan awal Pertama, [buat akun Stripe](https://dashboard.stripe.com/register) atau [masuk](https://dashboard.stripe.com/login). ## Siapkan Stripe CLI ### Instal Dari baris perintah, gunakan skrip instal atau unduh dan ekstrak file arsip berversi untuk diinstal CLI oleh sistem operasi Anda. #### homebrew Untuk menginstal Stripe CLI dengan [homebrew](https://brew.sh/), jalankan: ```bash brew install stripe/stripe-cli/stripe ``` Perintah ini gagal jika Anda menjalankannya di homebrew versi Linux, tetapi Anda dapat menggunakan alternatif ini atau mengikuti petunjuk di tab Linux. ```bash brew install stripe-cli ``` #### apt > Build Debian untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis Ubuntu dan Debian: 1. Add Stripe CLI’s GPG key to the apt sources keyring: ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg ``` 1. Tambahkan repositori apt CLI ke daftar sumber apt: ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Perbarui daftar paket: ```bash sudo apt update ``` 1. Instal CLI ```bash sudo apt install stripe ``` #### yum > Build RPM untuk CLI tersedia di JFrog di https://packages.stripe.dev, yang bukan merupakan domain milik Stripe. Saat mengunjungi URL ini, Anda akan diarahkan ke daftar artifactory JFrog. Untuk menginstal Stripe CLI pada distribusi berbasis RPM: 1. Tambahkan repositori yum CLI ke daftar sumber yum: ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Instal CLI ```bash sudo yum install stripe ``` #### Scoop Untuk menginstal Stripe CLI dengan [Scoop](https://scoop.sh/), jalankan: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Untuk menginstal Stripe CLI di macOS tanpa homebrew: 1. Unduh file tar.gz `mac-os` terbaru dari jenis arsitektur cpu Anda dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Atau, instal biner di lokasi tempat Anda dapat mengeksekusinya secara global (misalnya `/usr/local/bin`). #### Linux Untuk menginstal Stripe CLI di Linux tanpa pengelola paket: 1. Unduh file tar.gz `linux` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Pindahkan `./stripe` ke jalur eksekusi Anda. #### Windows Untuk menginstal Stripe CLI di Windows tanpa Scoop: 1. Unduh file zip `windows` terbaru dari [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Ekstrak file zip `stripe_X.X.X_windows_x86_64.zip`. 1. Tambahkan jalur ke file `stripe.exe` yang telah diekstrak ke variabel lingkungan `Path` Anda. Untuk mempelajari cara memperbarui variabel lingkungan, lihat [dokumentasi Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). > Pemindai antivirus Windows terkadang menandai Stripe CLI sebagai tidak aman. Hal ini kemungkinan positif palsu. Untuk informasi selengkapnya, lihat [edisi #692](https://github.com/stripe/stripe-cli/issues/692) di repositori GitHub. 1. Jalankan file `.exe` yang telah diekstrak. #### Docker Stripe CLI juga tersedia sebagai [gambar Docker](https://hub.docker.com/r/stripe/stripe-cli). Untuk menginstal versi terbaru, jalankan: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ### Autentikasi Masuk dan autentikasi [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk menghasilkan satu set kunci terbatas. Untuk mempelajari selengkapnya, lihat [Kunci dan izin CLI Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` Tekan tombol **Enter** di keyboard Anda untuk menyelesaikan proses autentikasi di browser Anda. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` ### Konfirmasikan penyiapan Sekarang setelah Anda menginstal CLI, Anda dapat membuat satu permintaan API ke [Create a product](https://docs.stripe.com/api/products/create.md). #### bash ```bash stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI" ``` Cari pengenal produk (dalam `id`) di objek respons. Simpan untuk langkah selanjutnya. Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "prod_LTenIrmp8Q67sa", // Pengidentifikasi terlihat seperti ini. "object": "product", "active": true, "attributes": [], "created": 1668198126, "default_price": null, "description": "Created with the Stripe CLI", "identifiers": {}, "images": [], "livemode": false, "metadata": {}, "name": "My First Product", "package_dimensions": null, "price": null, "product_class": null, "shippable": null, "sku": "my-first-product-10", "statement_descriptor": null, "tax_code": null, "type": "service", "unit_label": null, "updated": 1668198126, "url": null } ``` Selanjutnya, panggil [Buat harga](https://docs.stripe.com/api/prices/create.md) untuk melampirkan harga 30 USD. Tukar placeholder di `product` dengan pengenal produk Anda (misalnya, `prod_LTenIrmp8Q67sa`). #### bash ```bash stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product="{{PRODUCT_ID}}" ``` Jika semuanya berfungsi, baris perintah menampilkan respons berikut. #### bash ```json { "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Pengidentifikasi terlihat seperti ini. "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1652636348, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_Lh9iTGZhb2mcBy", "recurring": null, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "one_time", "unit_amount": 3000, "unit_amount_decimal": "3000" } ``` ## Menginstal SDK sisi server .NET Versi terbaru dari Stripe .NET server-side SDK adalah v50.4.0. Mendukung .NET Standard 2.0+, .NET Core 2.0+, dan .NET Framework 4.6.1+. Periksa versi [.NET SDK](https://docs.microsoft.com/en-us/dotnet/core/install/how-to-detect-installed-versions) Anda: ```bash dotnet --list-sdks ``` ### Instal pustaka Gunakan [.NET Core Command Line Interface (CLI)](https://docs.microsoft.com/en-us/dotnet/core/tools/) untuk membuat proyek baru dari baris perintah: ```bash dotnet new console ``` Untuk menginstal pustaka, jalankan perintah ini untuk menambahkan referensi paket ke file proyek Anda (`.csproj`): ```bash dotnet add package Stripe.net ``` Setelah Anda menginstal pustaka dengan CLI, pustaka secara otomatis ditambahkan sebagai dependensi dalam file proyek Anda (`.csproj`). Sebagai contoh: ```xml Exe net6.0 enable enable ``` ### Alternatif instalasi **NuGet Command Line Interface (CLI)**—Anda dapat menggunakan [NuGet CLI](https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference) untuk menginstal pustaka: ```bash nuget install Stripe.net ``` **Package Manager Console (PowerShell)**—Jika Anda menggunakan [Package Manager Console (PowerShell)](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console), jalankan perintah berikut untuk menginstal pustaka: ```PowerShell Install-Package Stripe.net ``` **VisualStudio**—Untuk menambahkan paket Stripe.net ke Visual Studio: Buka Solution Explorer. Klik kanan proyek Anda. Klik **Kelola Paket NuGet**. Klik tab **Browse** dan cari **Stripe.net**. Klik paket **Stripe.net**, pilih versi yang sesuai pada tab dan klik **Instal**. ## Jalankan permintaan SDK pertama Anda Sekarang setelah menginstal .NET SDK, Anda dapat membuat [Produk](https://docs.stripe.com/api/products/create.md) langganan dan melampirkan [Harga](https://docs.stripe.com/api/prices/create.md) dengan beberapa permintaan API. Kami menggunakan pengidentifikasi produk yang dikembalikan dalam respons untuk membuat harga dalam contoh ini. > Contoh ini menggunakan kunci default [akun](https://docs.stripe.com/get-started/account/activate.md) pengguna Stripe Anda untuk 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. Hanya Anda yang dapat melihat nilai-nilai ini. #### Buat produk dan harga ```dotnet using System; using Stripe; class Program { static void Main(string[] args) { var client = new StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2"); var optionsProduct = new ProductCreateOptions { Name = "Starter Subscription", Description = "$12/Month subscription", }; Product product = client.V1.Products.Create(optionsProduct); Console.Write("Success! Here is your starter subscription product id: {0}\n", product.Id); var optionsPrice = new PriceCreateOptions { UnitAmount = 1200, Currency = "usd", Recurring = new PriceRecurringOptions { Interval = "month", }, Product = product.Id }; Price price = client.V1.Prices.Create(optionsPrice); Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id); } } ``` Simpan kode ke file `Program.cs` di proyek Anda. Dari baris perintah, `cd` ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan: #### Program.cs ```bash dotnet run ``` Jika semuanya berfungsi, baris perintah menunjukkan respons berikut. Simpan pengidentifikasi ini sehingga Anda dapat menggunakannya saat membangun integrasi. #### bash ```bash Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb ``` ## See also Ini mengakhiri panduan mulai cepat. Lihat tautan di bawah ini guna mengetahui beberapa cara berbeda dalam memproses pembayaran untuk produk yang baru saja Anda buat. - [Buat tautan pembayaran](https://docs.stripe.com/payment-links.md) - [Halaman yang di-hosting Stripe](https://docs.stripe.com/checkout/quickstart.md) - [Integrasi lanjutan](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)