# Clientes en varias monedas

Cambia la moneda de facturación de los clientes para aceptar varias monedas.

Si necesitas vender en varias monedas, pero hacer que cada cliente utilice una única moneda, consulta [Precios en múltiples monedas](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies).

Usa la API Invoicing para emitir una factura a un cliente en otra moneda. Con la funcionalidad de clientes en varias monedas, puedes facturarle al mismo *cliente* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) en una moneda diferente a la establecida como moneda predeterminada y cambiar la moneda de las suscripciones de un cliente. No puedes tener dos suscripciones activas con monedas diferentes.

Esta guía también explica cómo crear una nota de crédito y revisar el saldo acreedor de un cliente en todas las monedas asignadas. A título ilustrativo, utilizamos el dólar canadiense (CAD).

## Crea una factura

Antes de facturarle a un cliente, debes crear un ítem de factura especificando el `id`, `amount` y `currency` del cliente. Únicamente agrega los artículos de la factura a un solo cliente por separado para evitar asociarlos al cliente equivocado.

La cantidad máxima de partidas de factura es 250. Al crear una factura se agregan hasta 250 partidas de factura pendientes; el resto se agregará en la próxima factura. Para ver las partidas de factura pendientes de tu cliente, ve a la página **Datos del cliente** o establece el atributo [pending](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) en `true` cuando uses la API para enumerar todas las partidas de la factura.

> Una factura en CAD no aplica ningún saldo acreedor del cliente denominado en una moneda distinta del CAD. Además, tampoco tiene en cuenta ningún cupón de descuento por importe fijo aplicado al cliente que esté denominado en una moneda distinta del CAD.

#### Accounts v2

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

#### Customers&nbsp;v1

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

Debes especificar el parámetro `currency` cuando emites una factura en varias monedas. El parámetro `currency` indica cuáles son los ítems de factura que se incluirán en la factura. Por ejemplo, en caso de crear dos ítems de factura para el mismo cliente, uno en USD y otro en CAD, si estableces la moneda en CAD, solo se incluirá el ítem en CAD (y se ignorará el ítem en USD).

#### Accounts&nbsp;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
```

#### Customers&nbsp;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
```

## Crea una nota de crédito

Si hay algún problema con la factura, puedes crear una nota de crédito. Si necesitas aplicar el crédito al saldo acreedor del cliente (en lugar de volver al método de pago original), Stripe asigna el importe del crédito al saldo acreedor 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
```

## Inspecciona el saldo acreedor

Para ver cuánto crédito tiene un cliente en cada moneda, usa el 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"
```

El saldo acreedor del cliente se retira de la siguiente factura en CAD creada para este cliente. Sin embargo, no se retirará para las facturas creadas en diferentes monedas.

## See also

- [Integrar con la API Invoicing](https://docs.stripe.com/invoicing/integration.md)
- [Gestionar clientes](https://docs.stripe.com/invoicing/customer.md)
- [Productos y precios](https://docs.stripe.com/invoicing/products-prices.md)