# 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.

# Python


Neste início rápido, você instala a [Stripe CLI](https://docs.stripe.com/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 ter 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 v16.0.0
- Como enviar sua primeira solicitação de SDK

## Configurar o Stripe CLI

### Instale e conecte

Instale o Stripe CLI com o [npm](https://www.npmjs.com/):

```bash
npm install -g @stripe/cli@latest
```

Após a instalação, faça login na sua conta Stripe:

```bash
stripe login
```

Após instalar a CLI, também é possível instalar [ferramentas de agente](https://docs.stripe.com/cli/agent/setup) ou configurar o [preenchimento automático](https://docs.stripe.com/cli/completion).

> Para mais opções de instalação no Windows, macOS, Linux e Docker, consulte o [readme da Stripe CLI](https://github.com/stripe/stripe-cli#installation) no GitHub.

### 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 é v16.0.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](https://pypi.org/project/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>=16.0.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.

> #### Use práticas recomendadas para chaves de API
> 
> Este exemplo utiliza as chaves padrão da sua [conta](https://docs.stripe.com/get-started/account/set-up.md) de usuário da Stripe para o 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). Somente você pode ver esses valores. Siga as [práticas recomendadas](https://docs.stripe.com/keys-best-practices.md) para gerenciar suas chaves com segurança.

#### Criar um produto e preço

```python
import stripe

# Don't embed any keys in production code. This is an example.
# See https://docs.stripe.com/keys-best-practices.
client = stripe.StripeClient("sk_test_...")

starter_subscription = client.v1.products.create(params={
  "name": "Starter Subscription",
  "description": "$12/Month subscription",
})

starter_subscription_price = client.v1.prices.create(params={
  "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.md)