Clientes multimoedas

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 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 como true quando usar a API para listar todos os itens da fatura.

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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).

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.