Clientes en varias monedas

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 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 en true cuando uses la API para enumerar todas las partidas de la factura.

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

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

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

Inspecciona el saldo acreedor

Para ver cuánto crédito tiene un cliente en cada moneda, usa el parámetro invoice_credit_balance:

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