# Clientes multimoedas

Altere a moeda de faturamento de qualquer cliente para aceitar várias moedas.

Se você precisa vender em várias moedas, mas faz com que cada cliente use uma única moeda, consulte [Preços multimoedas](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies).

Use a API Invoicing para emitir uma fatura para um cliente em uma moeda diferente. Com o recurso de clientes multimoedas, você pode cobrar o mesmo *cliente* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) usando uma moeda diferente da definida como moeda padrão e alterar a moeda das assinaturas de um cliente. Não é possível ter duas assinaturas ativas com moedas diferentes.

Este guia também explica como criar uma nota de crédito e inspecionar o saldo de crédito de um cliente em todas as moedas atribuídas. Para fins ilustrativos, usamos o dólar canadense (CAD).

## Crie uma fatura

Antes de faturar um cliente, crie um item de fatura passando um `id` de cliente, um `amount` e uma `currency`. Adicione itens de fatura a um único cliente por vez para evitar adicioná-los ao cliente errado.

O número máximo de itens da fatura é 250. A criação de uma fatura adiciona até 250 itens pendentes. Os itens restantes serão adicionados à próxima fatura. Para ver os itens pendentes da fatura de um cliente, consulte a página **Detalhes do cliente** ou defina o atributo [pending](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) como `true` quando usar a API para listar todos os itens da fatura.

> Uma fatura em CAD não considera nenhum saldo credor do cliente denominado em moeda diferente do CAD. Além disso, ela desconsidera quaisquer cupons de desconto aplicados ao cliente que sejam denominados em moeda diferente do CAD.

#### Contas v2

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=cad
```

#### Clientes v1

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d amount=1000 \
  -d currency=cad
```

Você precisa passar o parâmetro `currency` quando emite uma fatura multimoedas. O parâmetro `currency` determina quais itens de fatura são incluídos na fatura. Por exemplo, quando você cria dois itens de fatura, um em USD e o outro em CAD, para o mesmo cliente e define a moeda como CAD, somente o item de fatura em CAD será incluído na fatura (o item em USD será ignorado).

#### Contas v2

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad
```

#### Clientes v1

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad
```

## Criar uma nota de crédito

Se houver um problema com a fatura, você pode criar uma nota de crédito. Se precisar aplicar o crédito ao saldo de crédito do cliente (em vez de voltar à forma de pagamento original), a Stripe aloca o valor do crédito ao saldo de crédito específico para CAD.

```curl
curl https://api.stripe.com/v1/credit_notes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d invoice={{INVOICE_ID}} \
  -d reason=duplicate \
  -d amount=1000 \
  -d credit_amount=1000
```

## Inspecionar o saldo de crédito

Para ver quanto crédito um cliente tem em cada moeda, use o parâmetro `invoice_credit_balance`:

```curl
curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "expand[]=invoice_credit_balance"
```

O saldo de crédito do cliente é retirado da próxima fatura CAD criada para esse cliente. No entanto, ele não será abatido para faturas criadas em moedas diferentes.

## See also

- [Integrar com a API Invoicing](https://docs.stripe.com/invoicing/integration.md)
- [Gerenciar clientes](https://docs.stripe.com/invoicing/customer.md)
- [Produtos e preços](https://docs.stripe.com/invoicing/products-prices.md)