# Configure seu ambiente de desenvolvimento
Conheça o Stripe CLI e nossos SDKs no lado do servidor.
Confira nossa [documentação no-code](https://docs.stripe.com/no-code.md), use uma [solução pré-integrada](https://stripe.com/partners/directory) do nosso diretório de parceiros ou contrate um [especialista certificado pela Stripe](https://stripe.com/partners/directory?t=Consulting).
Os SDKs do lado do servidor e a interface de linha de comando (CLI) da Stripe permitem que você interaja com as APIs REST da Stripe. Comece com a Stripe CLI para simplificar seu ambiente de desenvolvimento e fazer chamadas de API.
Use os SDKs para não precisar programar rotinas padrão. Para começar a enviar solicitações do seu ambiente, escolha um idioma para seguir um guia de início rápido.
> #### Extensões do Chrome
>
> Recomendamos criar sua integração de pagamentos com a Stripe (como [Elements](https://docs.stripe.com/payments/elements.md) ou [Checkout](https://docs.stripe.com/payments/checkout.md)) no seu próprio site. Em seguida, configure sua extensão do Chrome para enviar os usuários a esta página de pagamento quando estiverem prontos para concluir uma compra.
>
> Esse método é mais seguro e fácil de manter do que tentar gerenciar pagamentos diretamente dentro da extensão.
# 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.
Neste guia de início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK do lado do servidor Stripe Ruby](https://github.com/stripe/stripe-ruby) para obter acesso às APIs da Stripe a partir de aplicativos programados em Ruby.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando um agrupador com RubyGems
- Como instalar o SDK da Stripe para Ruby v18.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros usando a ferramenta de linha de comando [RubyGems](http://rubygems.org/), que permite adicionar novas bibliotecas e incluí-las em seus projetos Ruby. Verifique se o RubyGems está instalado:
### Instale o RubyGems
#### Instale o RubyGems
```bash
gem --version
```
Se você receber `gem: command not found`, [baixe o RubyGems](http://rubygems.org/pages/download) na página de downloads.
## Instale o SDK para Ruby no lado do servidor
A versão mais recente do SDK da Stripe para Ruby no lado do servidor é v18.4.0. Ele aceita as versões do Ruby acima de 2.3.
Verifique sua versão Ruby:
```bash
ruby -v
```
### Instale a biblioteca
[Crie um arquivo gem](https://guides.rubygems.org/make-your-own-gem/) e instale o gem gerado usando um agrupador com [RubyGems](https://rubygems.org/).
Adicione a versão mais recente do [Stripe gem](https://rubygems.org/gems/stripe) a um projeto:
```bash
bundle add stripe
```
Instale os gems necessários de suas fontes especificadas:
```bash
bundle install
```
### Alternativas de instalação
**Adicionar como dependência** – Adicione a versão mais recente da biblioteca como uma dependência do gem:
```ruby
source 'https://rubygems.org'
gem 'rails'
gem 'stripe'
```
**Instalação global** – Instale a biblioteca globalmente com [RubyGems](https://rubygems.org/):
```bash
gem install stripe
```
**Instalação manual** – [Crie o gem da fonte](https://github.com/stripe/stripe-ruby) e instale a biblioteca executando:
```bash
gem build stripe.gemspec
```
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para Ruby instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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}"
```
Salve o arquivo como `create_price.rb`. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### create_price.rb
```bash
ruby create_price.rb
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá a você acesso por linha de comando à integração da Stripe. Você também instala o [SDK da Stripe para Python no lado do servidor](https://github.com/stripe/stripe-python) para obter acesso às APIs da Stripe a partir de aplicativos programados em Python.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando um ambiente virtual e o gerenciador de pacotes do pip
- Como instalar o SDK da Stripe mais recente para Python v14.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros usando o módulo [venv](https://docs.python.org/3/tutorial/venv.html), que permite adicionar novas bibliotecas e incluí-las nos seus projetos do Python 3.
### No Windows (cmd.exe):
#### No Windows (cmd.exe)
```bash
python3 -m venv env
.\env\Scripts\activate.bat
```
### No GNU Linux ou MacOS (bash):
#### Em GNU/Linux ou MacOS (bash)
```bash
python3 -m venv env
source env/bin/activate
```
## Instale o SDK para Python no lado do servidor
A versão mais recente do SDK para Python do lado do servidor da Stripe é v14.4.0. Ela aceita o Python 3.6 ou superior.
Verifique sua versão do Python:
```bash
python3 --version
```
### Instale a biblioteca
Instale a biblioteca do [PyPi](http://pypi.python.org/pypi/stripe/), um gerenciador de pacotes para Python:
```bash
pip3 install --upgrade stripe
```
Em seguida, especifique a seguinte versão no arquivo requirements.txt:
```txt
stripe>=14.4.0
```
### Alternativas de instalação
**Instalação manual** – [Baixe o código-fonte](https://github.com/stripe/stripe-python) do SDK e instale a biblioteca executando:
```bash
python3 setup.py install
```
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para Python instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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}")
```
Salve o arquivo como `create_price.py`. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### create_price.py
```bash
python3 create_price.py
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK da Stripe para Go no lado do servidor](https://github.com/stripe/stripe-go) para obter acesso às APIs da Stripe a partir de aplicativos programados em Go.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando módulos Go
- Como instalar o SDK mais recente da Stripe para Go v84.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros usando [módulos Go](https://go.dev/blog/using-go-modules), que permite adicionar novas bibliotecas e incluí-las nos seus projetos do Glo.
### Inicializar o Go
Se você está começando do zero em um novo diretório, primeiro é preciso criar um arquivo `go.mod` para rastrear dependências. Por exemplo:
#### Inicializar o Go
```bash
go mod init stripe-example
```
## Instale o SDK para Go no lado do servidor
A versão mais recente do SDK da Stripe para Go no lado do servidor é v84.4.0. Ela aceita as versões do Go acima de 1.15.
### Instale a biblioteca
Instale a biblioteca com [módulos do Go](https://go.dev/blog/using-go-modules), um gerenciador de pacotes para Go:
```bash
go get github.com/stripe/stripe-go/v84
```
Depois de instalar a biblioteca com módulos Go em um *novo* projeto, a biblioteca é automaticamente adicionada como dependência no arquivo go.mod do seu projeto. Por exemplo:
```go.mod
module stripe-example
go 1.18
require github.com/stripe/stripe-go/v84 84.4.0 // indirect
```
### Sincronizar dependências
Para manter sua dependência gerenciada definida para um projeto *existente*, execute o seguinte comando para [sincronizar as dependências do seu código](https://go.dev/doc/modules/managing-dependencies).
```bash
go mod tidy
```
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para Go instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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)
}
```
Salve o arquivo como `create_price.go`. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### create_price.rb
```bash
go run create_price.go
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK da Stripe para Java no lado do servidor](https://github.com/stripe/stripe-java) para obter acesso às APIs da Stripe a partir de aplicativos programados em Java.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando Maven ou Gradle
- Como instalar o SDK para Java mais recente da Stripe v31.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros usando [Maven](https://maven.apache.org/guides/getting-started/index.html) ou [Gradle](https://docs.gradle.org), o que ajuda você a adicionar novas bibliotecas e incluí-las em seus projetos Java.
### Inicialize um projeto
- Para criar um projeto com o **Maven**, consulte [Como faço para fazer meu primeiro projeto Maven?](https://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project).
- Para criar um projeto com o **Gradle**, consulte [Exemplo de criação de aplicativos Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).
## Instale o SDK para Java no lado do servidor
A versão mais recente do SDK da Stripe para Java no lado do servidor é v31.4.0. Ela aceita versões do Java acima de 1.8.
Verifique sua versão do Java :
```bash
java -version
```
### Instale a biblioteca
- Com o **Maven**, insira o seguinte no arquivo pom.xml do seu projeto:
```xml
com.stripe
stripe-java
31.4.0
```
- Com o **Gradle**, cole a próxima linha dentro do bloco de dependências do seu arquivo build.gradle:
```groovy
implementation 'com.stripe:stripe-java:31.4.0'
```
### Alternativas de instalação
**Instalação manual** – Você pode instalar manualmente o stripe-java com os seguintes JARs: [Baixar o Stripe JAR (.jar)](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST).
[Baixe o Gson JAR (.jar)](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) for [Google Gson](https://github.com/google/gson).
**Proguard** – Se estiver usando o ProGuard, exclua a biblioteca adicionando o seguinte ao arquivo `proguard.cfg`:
```proguard
-keep class com.stripe.** { *; }
```
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para Java instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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());
}
}
```
Salve o arquivo como `CreatePrice.java`. No projeto no seu IDE para Maven ou Gradle, execute a amostra. Por exemplo: `Run 'CreatePrice.main()'`.
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK da Stripe para Node.js no lado do servidor](https://github.com/stripe/stripe-node) para obter acesso às APIs da Stripe a partir de aplicativos programados em Node.js.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando o gerenciador de pacotes npm ou yarn
- Como instalar o SDK da Stripe mais recente para Node v20.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Instale o SDK para Node.js no lado do servidor
A versão mais recente do SDK da Stripe para Node no lado do servidor é v20.4.0. Ele aceita as versões do Node.js acima de 12.
Verifique sua versão do Node:
```bash
node --version
```
### Inicialize o Node
#### Inicialize o Node
```bash
npm init
```
### Instale a biblioteca
Instale a biblioteca com [npm](https://www.npmjs.com/package/node), um gerenciador de pacotes para Node:
```bash
npm install stripe --save
```
Depois de instalar a biblioteca com npm, ela é adicionada automaticamente como uma dependência no arquivo package.json do seu projeto. Por exemplo:
```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"
}
}
```
### Alternativas de instalação
**Yarn** – É possível instalar a biblioteca com [yarn](https://yarnpkg.com/), outro gerenciador de pacotes para o Node:
```bash
yarn add stripe
```
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para Node.js instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. O SDK para Node.js retorna [promessas](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) que podem ser usadas como retornos de chamada encadeáveis. Para demonstrar, estamos passando o identificador do produto retornado na resposta do produto para criar um preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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);
});
});
```
Salve o arquivo como `create_price.js`. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### create_price.js
```bash
node create_price.js
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK da Stripe para PHP no lado do servidor](https://github.com/stripe/stripe-php) para obter acesso às APIs da Stripe a partir de aplicativos programados em PHP.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando o Composer
- Como instalar o SDK da Stripe mais recente para PHP v19.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros do [Packagist](https://packagist.org/) usando o [Composer](https://getcomposer.org/download/), que permite adicionar novas bibliotecas e incluí-las nos seus projetos do PHP.
### Instalar o Composer
Na linha de comando, [baixe o Composer](https://getcomposer.org/download/) usando as instruções.
## Instale o SDK para PHP no lado do servidor
A versão mais recente do SDK da Stripe para PHP é v19.4.0. Ele aceita versões do PHP acima da 5.6.0.
Verifique sua versão do PHP:
```bash
php --version
```
### Instale a biblioteca
Instale a biblioteca com o [Composer](http://getcomposer.org/), um gerenciador de pacotes para PHP:
```bash
composer require stripe/stripe-php
```
Após instalar a biblioteca com o Composer, ela é automaticamente adicionada como dependência ao arquivo composer.json do seu projeto. Por exemplo:
```json
{
"require": {
"stripe/stripe-php": "^19.4.0"
}
}
```
Para usar as vinculações, use o [autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading) do Composer. Por exemplo:
```php
require_once('vendor/autoload.php');
```
### Alternativas de instalação
**Instalação manual**
Você pode [baixar a versão mais recente](https://github.com/stripe/stripe-php/releases) para usar as vinculações e depois incluir o arquivo init.php:
```php
require_once('/path/to/stripe-php/init.php');
```
Em seguida, adicione as seguintes extensões: [cURL](https://secure.php.net/manual/en/book.curl.php) (ou, opcionalmente, use seu próprio cliente não relacionado ao curl) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php)
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para PHP instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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";
?>
```
Salve o arquivo como `create_price.php`. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### create_price.php
```bash
php create_price.php
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: price_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](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.
Neste guia de início rápido, você instala o [Stripe CLI](https://docs.stripe.com/stripe-cli.md), uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o [SDK do lado do servidor Stripe NET](https://github.com/stripe/stripe-dotnet) para obter acesso às APIs da Stripe a partir de aplicativos programados em C#.
## O que você aprende
Neste início rápido, você aprenderá:
- Como chamar as APIs da Stripe sem escrever uma linha de código
- Como gerenciar dependências de terceiros usando o .NET Core CLI, NuGet CLI ou o console do gerenciador de pacotes
- Como instalar a versão mais recente do SDK da Stripe para .NET v50.4.0
- Como enviar sua primeira solicitação de SDK
## Configuração inicial
Primeiro, [crie uma conta Stripe](https://dashboard.stripe.com/register) ou [entre](https://dashboard.stripe.com/login).
## Configurar o Stripe CLI
### Instalar
Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.
#### homebrew
Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:
```bash
brew install stripe/stripe-cli/stripe
```
Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.
```bash
brew install stripe-cli
```
#### apt
> A versão para Debian da CLI está disponível no JFrog na página https://packages.stripe.dev,que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:
```bash
sudo apt update
```
1. Instale a CLI:
```bash
sudo apt install stripe
```
#### yum
> A versão para RPM da CLI está disponível no JFrog na página https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista do Jfrog artifactory.
Para instalar a Stripe CLI em distribuições baseadas em RPM:
1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:
```bash
sudo yum install stripe
```
#### Scoop
Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:
```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```
```bash
scoop install stripe
```
#### macOS
Para instalar a Stripe CLI no macOS sem homebrew:
1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.
O binário também pode ficar em um local onde possa ser executado globalmente (por exemplo, `/usr/local/bin`).
#### Linux
Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:
1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Mova `./stripe` para o caminho de execução.
#### Windows
Para instalar a Stripe CLI no Windows sem o Scoop:
1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.
1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).
> Os scanners antivírus do Windows ocasionalmente sinalizam o Stripe CLI como inseguro. É provável que se trate de um falso-positivo. Para obter mais informações, consulte o [problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.
1. Execute o arquivo `.exe` descompactado.
#### Docker
A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Chaves e permissões da CLI do Stripe](https://docs.stripe.com/stripe-cli/keys.md).
```bash
stripe login
```
Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.
```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)
```
### Confirmar configuração
Agora que você instalou a CLI, pode fazer uma única solicitação de API para [Criar um produto](https://docs.stripe.com/api/products/create.md).
#### bash
```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```
Procure o identificador do produto (em `id`) no objeto de resposta. Salve para a próxima etapa.
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // O identificador fica assim.
"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
}
```
Em seguida, invoque [Criar um preço](https://docs.stripe.com/api/prices/create.md) para anexar um preço de 30 USD. Substitua o espaço reservado em `product` com seu identificador de produto (por exemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // O identificador fica assim.
"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"
}
```
## Instale o SDK para .NET no lado do servidor
A versão mais recente do SDK da Stripe para .NET no lado do servidor é v50.4.0. Ela é compatível com .NET Standard 2.0+, .NET Core 2.0+ e .NET Framework 4.6.1+.
Verifique a versão do seu [.NET SDK](https://docs.microsoft.com/en-us/dotnet/core/install/how-to-detect-installed-versions):
```bash
dotnet --list-sdks
```
### Instale a biblioteca
Use a [Interface de linha de comando (CLI) .NET Core](https://docs.microsoft.com/en-us/dotnet/core/tools/) para criar um projeto da linha de comando:
```bash
dotnet new console
```
Para instalar a biblioteca, execute este comando para adicionar a referência do pacote ao seu arquivo de projeto (`.csproj`):
```bash
dotnet add package Stripe.net
```
Depois de instalar a biblioteca com a CLI, ela é automaticamente adicionada como dependência no arquivo de projeto (`.csproj`). Por exemplo:
```xml
Exe
net6.0
enable
enable
```
### Alternativas de instalação
Use a **Interface de linha de comando (CLI) NuGet** – É possível usar o [NuGet CLI](https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference) para instalar a biblioteca:
```bash
nuget install Stripe.net
```
**Console do gerenciador de pacotes (PowerShell)** – Se você estiver usando o [Console do gerenciador de pacotes (PowerShell)](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console), execute o seguinte comando para instalar a biblioteca:
```PowerShell
Install-Package Stripe.net
```
**VisualStudio** – Para adicionar o pacote Stripe.net ao Visual Studio: abra o Gerenciador de Soluções. Clique com o botão direito no seu projeto. Clique em **Gerenciar pacotes NuGet**. Clique na guia **Navegar** e pesquise **Stripe.net**. Clique no pacote **Stripe.net**, selecione a versão apropriada na guia e clique em **Instalar**.
## Executar sua primeira solicitação de SDK
Agora que você tem o SDK para .NET instalado, pode criar um [Product](https://docs.stripe.com/api/products/create.md) de assinatura e vincular um [Price](https://docs.stripe.com/api/prices/create.md) com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
> Este exemplo usa as chaves padrão de sua [conta](https://docs.stripe.com/get-started/account/activate.md) de usuário Stripe para seu ambiente de *área restrita* (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). Só você pode ver esses valores.
#### Criar um produto e preço
```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);
}
}
```
Salve o código no arquivo `Program.cs` do seu projeto. Na linha de comando, `cd` para o diretório que contém o arquivo que você acabou de salvar e execute:
#### Program.cs
```bash
dotnet run
```
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
#### bash
```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```
## See also
Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.
- [Criar um link de pagamento](https://docs.stripe.com/payment-links.md)
- [Página hospedada na Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integração avançada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)