# Configura il tuo ambiente di sviluppo
Acquisisci familiarità con la CLI di Stripe e i nostri SDK lato server.
Consulta la nostra [documentazione per le opzioni senza codice](https://docs.stripe.com/no-code.md), usa una [soluzione preintegrata](https://stripe.com/partners/directory) dalla nostra galleria dei partner oppure assumi un [esperto Stripe certificato](https://stripe.com/partners/directory?t=Consulting).
Gli SDK lato server e l’interfaccia della riga di comando (CLI) di Stripe consentono l’interazione con le API REST di Stripe. Inizia con la CLI di Stripe per semplificare l’ambiente di sviluppo ed effettuare chiamate API.
Utilizza gli SDK per evitare di scrivere codice boilerplate. Per iniziare a inviare richieste dal tuo ambiente, scegli una lingua per seguire una guida rapida.
> #### Estensioni di Chrome
>
> Ti consigliamo di sviluppare l’integrazione per i pagamenti con Stripe (come [Elements](https://docs.stripe.com/payments/elements.md) o [Checkout](https://docs.stripe.com/payments/checkout.md)) sul tuo sito web. Configura quindi la tua estensione per Chrome in modo che gli utenti vengano indirizzati a questa pagina di pagamento quando sono pronti ad acquistare.
>
> Questo metodo è più sicuro e più facile da gestire rispetto al tentativo di gestire i pagamenti direttamente all’interno dell’estensione.
# 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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe Ruby](https://github.com/stripe/stripe-ruby) per accedere alle API Stripe dalle applicazioni scritte in Ruby.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando un bundler con RubyGems
- Come installare l’SDK Ruby v18.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Gestisci le dipendenze di terze parti
Ti consigliamo di gestire le dipendenze di terze parti utilizzando lo strumento da riga di comando [RubyGems](http://rubygems.org/), che ti consente di aggiungere nuove librerie e includerle nei tuoi progetti Ruby. Controlla se RubyGems è installato:
### Installa RubyGems
#### Installa RubyGems
```bash
gem --version
```
Se visualizzi il messaggio `gem: command not found`, [scarica RubyGems](http://rubygems.org/pages/download) dalla pagina di download ufficiale.
## Installa l'SDK lato server di Ruby
La versione più recente dell’SDK Stripe Ruby lato server è v18.4.0. Supporta le versioni Ruby 2.3 e successive.
Verifica la tua versione Ruby:
```bash
ruby -v
```
### Installare la libreria
[Crea un file gem](https://guides.rubygems.org/make-your-own-gem/) e installa il gem generato utilizzando un bundler con [RubyGems](https://rubygems.org/).
Aggiungi l’ultima versione di [Stripe gem](https://rubygems.org/gems/stripe) a un progetto:
```bash
bundle add stripe
```
Installa i file gem richiesti dalle fonti specificate:
```bash
bundle install
```
### Alternative di installazione
**Aggiungi come dipendenza**. Aggiungi la versione più recente della libreria come dipendenza dal file gem:
```ruby
source 'https://rubygems.org'
gem 'rails'
gem 'stripe'
```
**Installazione globale**. Installa la libreria a livello globale con [RubyGems](https://rubygems.org/):
```bash
gem install stripe
```
**Installazione manuale**. [Crea il file gem dall’origine](https://github.com/stripe/stripe-ruby) e quindi installare la libreria eseguendo:
```bash
gem build stripe.gemspec
```
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK Ruby, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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}"
```
Salva il file come `create_price.rb`. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### create_price.rb
```bash
ruby create_price.rb
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe Python](https://github.com/stripe/stripe-python) per accedere alle API Stripe dalle applicazioni scritte in Python.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando un ambiente virtuale e il gestore dei pacchetti pip
- Come installare l’ultimo SDK Python v14.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Gestisci le dipendenze di terze parti
Ti consigliamo di gestire le dipendenze di terze parti utilizzando il modulo [venv](https://docs.python.org/3/tutorial/venv.html), che ti permette di aggiungere nuove librerie e includerle nei tuoi progetti Python 3.
### In Windows (cmd.exe):
#### In Windows (cmd.exe)
```bash
python3 -m venv env
.\env\Scripts\activate.bat
```
### In GNU Linux o MacOS (bash):
#### In GNU/Linux o MacOS (bash)
```bash
python3 -m venv env
source env/bin/activate
```
## Installa l'SDK lato server di Python
La versione più recente dell’SDK lato server di Stripe Python è v14.4.0. Supporta le versioni Python 3.6 e successive.
Consulta la tua versione Python:
```bash
python3 --version
```
### Installare la libreria
Installa la libreria da [PyPi](http://pypi.python.org/pypi/stripe/), un gestore di pacchetti per Python:
```bash
pip3 install --upgrade stripe
```
Poi specifica la seguente versione nel file requirements.txt:
```txt
stripe>=14.4.0
```
### Alternative di installazione
**Installazione manuale**. [Scarica il codice sorgente](https://github.com/stripe/stripe-python) per l’SDK e installa la libreria eseguendo:
```bash
python3 setup.py install
```
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK Python, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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}")
```
Salva il file come `create_price.py`. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### create_price.py
```bash
python3 create_price.py
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe Go](https://github.com/stripe/stripe-go) per accedere alle API Stripe dalle applicazioni scritte in Go.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando i moduli Go
- Come installare l’ultimo SDK Go v84.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Gestisci le dipendenze di terze parti
Ti consigliamo di gestire le dipendenze di terze parti utilizzando i [moduli Go](https://go.dev/blog/using-go-modules), che ti consentono di aggiungere nuove librerie e includerle nei progetti Go.
### Avvia Go
Se inizi da zero in una nuova directory, devi prima creare un file `go.mod` per tenere traccia delle dipendenze. Per esempio:
#### Avvia Go
```bash
go mod init stripe-example
```
## Installa l'SDK lato server di Go
La versione più recente dell’SDK di Stripe Go lato server è v84.4.0. Supporta le versioni Go 1.15 e successive.
### Installare la libreria
Installa la libreria con i [moduli Go](https://go.dev/blog/using-go-modules), un gestore di pacchetti per Go:
```bash
go get github.com/stripe/stripe-go/v84
```
Dopo aver installato la libreria con i moduli Go per un *new* project, la libreria viene aggiunta automaticamente come dipendenza nel file package.json del progetto. Ad esempio:
```go.mod
module stripe-example
go 1.18
require github.com/stripe/stripe-go/v84 84.4.0 // indirect
```
### Sincronizza dipendenze
Per mantenere in ordine la tua dipendenza per un *existing* project, esegui il seguente comando per [sincronizzare le dipendenze del tuo codice](https://go.dev/doc/modules/managing-dependencies).
```bash
go mod tidy
```
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK Go, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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)
}
```
Salva il file come `create_price.go`. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### create_price.rb
```bash
go run create_price.go
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe Java](https://github.com/stripe/stripe-java) per accedere alle API Stripe dalle applicazioni scritte in Java.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando Maven o Gradle
- Come installare l’ultimo SDK Java v31.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Gestisci le dipendenze di terze parti
Ti consigliamo di gestire le dipendenze di terze parti utilizzando [Maven](https://maven.apache.org/guides/getting-started/index.html) o [Gradle](https://docs.gradle.org), che ti aiutano ad aggiungere nuove librerie e a includerle nei tuoi progetti Java.
### Avviare un progetto
- Per creare un progetto con **Maven**, consulta la sezione [Come faccio a creare il mio primo progetto Maven?](https://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project).
- Per creare un progetto con **Gradle**, consulta la sezione [Esempio di sviluppo di applicazioni Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).
## Installa l'SDK lato server di Java
La versione più recente dell’SDK di Stripe Java lato server è v31.4.0. Supporta tutte le versioni Java 1.8 e successive.
Verifica la tua versione di Java:
```bash
java -version
```
### Installare la libreria
- Con **Maven**, inserisci quanto segue nel file pom.xml del tuo progetto:
```xml
com.stripe
stripe-java
31.4.0
```
- Con **Gradle**, incolla la riga successiva all’interno del blocco di dipendenze del file build.gradle:
```groovy
implementation 'com.stripe:stripe-java:31.4.0'
```
### Alternative di installazione
**Installazione manuale**. Puoi installare manualmente stripe-java con i seguenti JAR: [Scarica il file (.jar) di Stripe JAR](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST).
[Scarica il file (.jar) di Gson JAR](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) per [Google Gson](https://github.com/google/gson).
**Proguard**. Se utilizzi ProGuard, assicurati di escludere la libreria aggiungendo quanto segue al tuo file `proguard.cfg`:
```proguard
-keep class com.stripe.** { *; }
```
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK Java, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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());
}
}
```
Salva il file come `CreatePrice.java`. Dal progetto nel tuo IDE per Maven o Gradle, esegui l’esempio. Ad esempio: `Run 'CreatePrice.main()'`.
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe Node.js](https://github.com/stripe/stripe-node) per accedere alle API Stripe dalle applicazioni scritte in Node.js.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando il gestore di pacchetti npm o yarn
- Come installare l’ultimo SDK Node v20.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Installa l'SDK lato server di Node.js
La versione più recente dell’SDK di Stripe Node.js lato server è v20.4.0. Supporta le versioni Node.js 12 e successive.
Verifica la tua versione di Node:
```bash
node --version
```
### Avvia Node
#### Avvia Node
```bash
npm init
```
### Installare la libreria
Installa la libreria con [npm](https://www.npmjs.com/package/node), un gestore pacchetti per Node:
```bash
npm install stripe --save
```
Dopo aver installato la libreria con npm, la libreria viene aggiunta automaticamente come dipendenza nel file package.json del progetto. Ad esempio:
```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"
}
}
```
### Alternative di installazione
**Yarn**. Puoi installare la libreria con [yarn](https://yarnpkg.com/), un altro gestore di pacchetti per Node:
```bash
yarn add stripe
```
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK Node.js, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. L’SDK Node.js restituisce [promesse](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) che possono essere utilizzate come callback gestibili. A titolo esemplificativo, per creare una tariffa utilizziamo l’identificatore di prodotto restituito nella risposta del prodotto.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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);
});
});
```
Salva il file come `create_price.js`. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### create_price.js
```bash
node create_price.js
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche l’[SDK lato server Stripe PHP](https://github.com/stripe/stripe-php) per accedere alle API Stripe dalle applicazioni scritte in PHP.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando Composer
- Come installare l’ultimo SDK PHP v19.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Gestisci le dipendenze di terze parti
Ti consigliamo di gestire le dipendenze di terze parti da [Packagist](https://packagist.org/) utilizzando [Composer](https://getcomposer.org/download/), che ti permette di aggiungere nuove librerie e includerle nei tuoi progetti PHP.
### Installare Composer
Dalla riga di comando, [scarica Composer](https://getcomposer.org/download/) utilizzando le seguenti istruzioni.
## Installa l'SDK lato server di PHP
La versione più recente dell’SDK di Stripe PHP lato server è v19.4.0. Supporta le versioni PHP 5.6.0 o successive.
Verifica la tua versione di PHP:
```bash
php --version
```
### Installare la libreria
Installa la libreria con [Composer](http://getcomposer.org/), un gestore pacchetti per PHP:
```bash
composer require stripe/stripe-php
```
Dopo aver installato la libreria con Composer, viene aggiunta automaticamente come dipendenza nel file composer.json del progetto. Ad esempio:
```json
{
"require": {
"stripe/stripe-php": "^19.4.0"
}
}
```
Per utilizzare i binding, usa il [caricamento automatico](https://getcomposer.org/doc/01-basic-usage.md#autoloading) di Composer. Ad esempio:
```php
require_once('vendor/autoload.php');
```
### Alternative di installazione
**Installazione manuale**
Puoi [scaricare l’ultima versione](https://github.com/stripe/stripe-php/releases) per utilizzare i binding, quindi includere il file init.php:
```php
require_once('/path/to/stripe-php/init.php');
```
Poi aggiungi le seguenti estensioni: [cURL](https://secure.php.net/manual/en/book.curl.php) (oppure utilizza il tuo client non cURL) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php)
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK PHP, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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";
?>
```
Salva il file come `create_price.php`. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### create_price.php
```bash
php create_price.php
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: price_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](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.
In questa guida rapida introduttiva installerai la [CLI di Stripe](https://docs.stripe.com/stripe-cli.md), uno strumento essenziale che ti consente di accedere alla tua integrazione Stripe dalla riga di comando. Installerai anche [Stripe .NET server-side SDK](https://github.com/stripe/stripe-dotnet) per accedere alle API Stripe dalle applicazioni scritte in C#.
## Che cosa imparerai
In questa guida rapida scoprirai:
- Come chiamare le API di Stripe senza scrivere una riga di codice
- Come gestire le dipendenze di terze parti utilizzando la CLI di .NET Core, la CLI di NuGet o la console di gestione dei pacchetti
- Come installare l’ultimo SDK .NET v50.4.0 di Stripe
- Come inviare la tua prima richiesta SDK
## Configurazione iniziale
Innanzitutto [crea un account Stripe](https://dashboard.stripe.com/register) o [accedi](https://dashboard.stripe.com/login).
## Configura la CLI di Stripe
### Installa
Dalla riga di comando, utilizza uno script di installazione o scarica ed estrai un file di archivio con versione numerata per il sistema operativo in uso per installare la CLI.
#### homebrew
Per installare la CLI di Stripe con [homebrew](https://brew.sh/), esegui:
```bash
brew install stripe/stripe-cli/stripe
```
Questo comando fallisce se lo si esegue sulla versione Linux di Homebrew, ma è possibile utilizzare questa alternativa o seguire le istruzioni nella scheda Linux.
```bash
brew install stripe-cli
```
#### APT
> La build Debian per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su Debian e Ubuntu:
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. Aggiungi il repository APT della CLI all’elenco delle fonti 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. Aggiorna l’elenco dei pacchetti:
```bash
sudo apt update
```
1. Installa la CLI:
```bash
sudo apt install stripe
```
#### yum
> La build RPM per la CLI è disponibile su JFrog all’indirizzo https://packages.stripe.dev, che non è un dominio di proprietà di Stripe. Quando visiti questo URL, viene effettuato il reindirizzamento all’elenco di artifactory di Jfrog.
Per installare la CLI di Stripe su distribuzioni basate su RPM:
1. Aggiungi il repository yum della CLI all’elenco delle fonti 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. Installa la CLI:
```bash
sudo yum install stripe
```
#### Scoop
Per installare la CLI di Stripe con [Scoop](https://scoop.sh/), esegui:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Per installare la CLI di Stripe su macOS senza homebrew:
1. Scarica il file tar.gz per `mac-os` più recente della tua architettura cpu da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
Facoltativamente, installa il binario in una posizione da cui possa essere eseguito a livello globale (per esempio, `/usr/local/bin`).
#### Linux
Per installare la CLI di Stripe su Linux senza un gestore pacchetti:
1. Scarica il file tar.gz per `linux` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Sposta `./stripe` sul tuo percorso di esecuzione.
#### Windows
Per installare la CLI di Stripe su Windows senza Scoop:
1. Scarica il file zip per `windows` più recente da [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Decomprimi il file `stripe_X.X.X_windows_x86_64.zip`.
1. Aggiungi il percorso al file `stripe.exe` decompresso alla variabile di ambiente `Path`. Per informazioni su come aggiornare le variabili di ambiente, consulta la [documentazione di 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).
> Gli scanner antivirus di Windows segnalano occasionalmente che la CLI di Stripe non è sicura. Probabilmente si tratta di un falso positivo. Per ulteriori informazioni, consulta il [problema #692](https://github.com/stripe/stripe-cli/issues/692) nel repository GitHub.
1. Esegui il file `.exe` decompresso.
#### Docker
La CLI di Stripe è disponibile anche come [immagine Docker](https://hub.docker.com/r/stripe/stripe-cli). Per installare l’ultima versione, esegui:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autentica
Accedi e autentica il tuo[account](https://docs.stripe.com/get-started/account/activate.md) Stripe utente per generare una serie di chiavi con limitazioni. Per ulteriori informazioni, consulta [Autorizzazioni e chiavi della CLI di Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Premi **Enter** sulla tastiera per completare la procedura di autenticazione nel browser.
```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)
```
### Conferma la configurazione
Ora che hai installato la CLI, puoi fare una singola richiesta API per [creare un prodotto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Cerca l’identificatore del prodotto (in `id`) nell’oggetto della risposta. Conservalo per il passaggio successivo.
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile a questo.
"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
}
```
Poi chiama [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per associare un prezzo di 30 USD. Scambia il segnaposto in `product` con l’identificatore del prodotto (ad esempio, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tutto ha funzionato, la riga di comando visualizza la seguente risposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile a questo.
"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"
}
```
## Installa l'SDK lato server di .NET
La versione più recente dell’SDK Stripe .NET lato server è v50.4.0. Supporta .NET Standard 2.0+, .NET Core 2.0+ e .NET Framework 4.6.1+.
Controlla la versione dell’[SDK .NET](https://docs.microsoft.com/en-us/dotnet/core/install/how-to-detect-installed-versions):
```bash
dotnet --list-sdks
```
### Installare la libreria
Per creare un nuovo progetto dalla riga di comando, utilizza [.NET Core Command Line Interface (CLI)](https://docs.microsoft.com/en-us/dotnet/core/tools/):
```bash
dotnet new console
```
Per installare la libreria, esegui questo comando e aggiungi il riferimento del pacchetto al file di progetto (`.csproj`):
```bash
dotnet add package Stripe.net
```
Dopo aver installato la libreria con la CLI, la libreria viene aggiunta automaticamente come dipendenza nel file di progetto (`.csproj`). Ad esempio:
```xml
Exe
net6.0
enable
enable
```
### Alternative di installazione
**NuGet Command Line Interface (CLI)**. Per installare la libreria, puoi utilizzare [NuGet Command Line Interface (CLI)](https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference):
```bash
nuget install Stripe.net
```
**Console di gestione dei pacchetti (PowerShell)**. Se utilizzi la [Console di gestione dei pacchetti (PowerShell)](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console), per installare la libreria esegui il comando seguente:
```PowerShell
Install-Package Stripe.net
```
**VisualStudio**. Per aggiungere il pacchetto Stripe.net a Visual Studio: Apri Esplora soluzioni. Fai clic con il pulsante destro del mouse sul progetto. Fai clic su **Gestisci pacchetti NuGet**. Fai clic sulla scheda **Sfoglia** e cerca **Stripe.net**. Fai clic sul pacchetto **Stripe.net**, seleziona la versione appropriata nella scheda e fai clic su **Installa**.
## Esegui la prima richiesta SDK
Ora che hai installato l’SDK .NET, puoi creare un oggetto [Product](https://docs.stripe.com/api/products/create.md) in abbonamento e associare un oggetto [Price](https://docs.stripe.com/api/prices/create.md) con due richieste API. In questo esempio, per creare il prezzo utilizziamo l’identificatore del prodotto restituito nella risposta.
> Questo esempio utilizza le chiavi predefinite del tuo [account](https://docs.stripe.com/get-started/account/activate.md) utente Stripe per il tuo ambiente *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) Solo tu puoi vedere questi valori.
#### Creare un prodotto e una tariffa
```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);
}
}
```
Salva il codice nel file `Program.cs` del tuo progetto. Dalla riga di comando, inserisci `cd` alla directory contenente il file che hai appena salvato ed esegui:
#### Program.cs
```bash
dotnet run
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta. Salva questi identificatori in modo da poterli utilizzare durante la creazione della tua integrazione.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
La guida introduttiva termina qui. Fai clic sui link riportati di seguito per conoscere alcuni modi per elaborare un pagamento per il prodotto che hai appena creato.
- [Creare un link di pagamento](https://docs.stripe.com/payment-links.md)
- [Pagina in hosting su Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integrazione avanzata](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)