# Produtos e preços

Use a API Invoicing para gerenciar produtos e preços.

Defina todas as ofertas de negócios e produtos em um só lugar. Os *produtos* (Products represent what your business sells—whether that's a good or a service) definem o que você vende e os *preços* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) acompanham quanto e com que frequência você cobra. Entidade central da Stripe que funciona com *assinaturas* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis), *faturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) e o [Checkout](https://docs.stripe.com/payments/checkout.md).

Os preços habilitam estes casos de uso:

- Um provedor de software que cobra uma tarifa de configuração avulsa sempre que um usuário cria uma nova assinatura.
- Uma loja de e-commerce que envia uma caixa de produtos regularmente aos clientes por US$ 10 por mês e quer permitir que os clientes comprem complementos avulsos.
- Uma firma de serviços profissionais que agora pode criar uma lista padrão de serviços e criar faturas a partir dessa lista em vez de digitar cada item manualmente.
- Uma organização sem fins lucrativos que permite aos doadores definir um valor de doação recorrente personalizado por cliente.

Gerencie o catálogo de produtos usando produtos e preços. Os produtos definem o que você vende e os preços definem quanto e com que frequência você cobra. Gerencie produtos e seus preços no Dashboard ou pela API.

#### Dashboard

Se você usou o Dashboard em uma *á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) para configurar sua empresa, copie cada um dos produtos para o modo de produção usando **Copiar para modo de produção** na [página Catálogo de produtos](https://dashboard.stripe.com/products). Use nossas bibliotecas oficiais para acessar a API Stripe em seu aplicativo.

1. Acesse a página **Catálogo de produtos** e clique em **Adicionar produto**.

1. Defina se quer criar um **Produto de compra avulsa** ou um **Produto de compra avulsa recorrente**.

1. Atribua um nome e preço ao produto.

#### API

Saiba como criar [produtos](https://docs.stripe.com/api/products.md) e [preços](https://docs.stripe.com/api/prices.md).

> Para obter orientações completas sobre como começar a usar o [Stripe CLI](https://docs.stripe.com/stripe-cli.md) ou a API, consulte o [guia de integração completa do Invoicing](https://docs.stripe.com/invoicing/integration.md).

### Criar um produto

Para criar um produto, informe o nome dele:

```curl
curl https://api.stripe.com/v1/products \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=Gold Special"
```

### Criar um preço

[Preços](https://docs.stripe.com/api.md#prices) definem quanto e com que frequência cobrar os produtos. Você define o custo do produto, a moeda a ser usada e o intervalo de cobrança (quando o preço refere-se a uma assinatura). Assim como os produtos, se você tem poucos preços, é preferível gerenciá-los no Dashboard. Use o valor unitário para expressar preços na menor unidade da moeda, neste caso, centavos (10&nbsp;USD são 1.000&nbsp;centavos, portanto, o valor unitário é 1000).

Se não for preciso criar um preço para seu produto, você também pode usar o parâmetro [value](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-amount) durante a criação do item da fatura.

Para criar um preço e atribuí-lo ao produto, passe o ID, o valor unitário e a moeda do produto. Neste exemplo, o preço do produto “Gold Special” é US$&nbsp;10:

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "product={{PRODUCT_ID}}" \
  -d unit_amount=1000 \
  -d currency=usd
```

> #### Preços regionalizados
> 
> Ao [criar itens de fatura](https://docs.stripe.com/api/invoiceitems/create.md) ou cobranças com a API, a Stripe processa o valor e a moeda que você fornece explicitamente. O preço localizado não é calculado automaticamente, e você é responsável por passar o valor e a moeda corretos para a região do seu cliente. Recomendamos usar o parâmetro [pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) para passar o ID do preço.