Clientes en múltiples divisas

Usa la API Invoicing para emitir una factura a un cliente en una divisa diferente. Con la función de clientes en varias divisas, puedes facturar al mismo cliente en una divisa diferente de la establecida como divisa predeterminada y cambiar la divisa de las suscripciones de un cliente. No puedes tener dos suscripciones activas con divisas distintas.

En esta guía también se explica cómo crear una nota de crédito e inspeccionar el saldo acreedor de un cliente en todas las divisas asignadas. Con fines ilustrativos, utilizamos el dólar canadiense (CAD).

Crea una factura

Antes de facturarle al cliente, debes crear una partida de factura especificando el id, el amount y la currency del cliente. Añade partidas de factura a un solo cliente a la vez para evitar añadirlas al cliente equivocado.

El número máximo de partidas de factura es 250. La creación de una factura añade hasta 250 partidas de factura pendientes, y el resto se añadirá en la próxima factura. Para ver las partidas pendientes de la factura del cliente, consulta la página Datos del cliente o establece el atributo pendiente en true cuando uses la API para enumerar todas las partidas.

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

Cuando emitas una factura con múltiples divisas, debes especificar el parámetro currency. El parámetro currency determina qué elementos de la factura se incluyen en la factura. Por ejemplo, si crearas dos partidas de factura (una en USD y otra en CAD) para el mismo cliente, si estableces la divisa en CAD, solo se incorporará la partida de factura en CAD (sin tener en cuenta la partida de factura 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

Crear 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 devolverlo al método de pago original), Stripe asigna el importe del crédito al saldo acreedor específico del 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

Inspeccionar el saldo acreedor

Para ver cuánto crédito tiene un cliente en cada divisa, utiliza 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 extrae de la siguiente factura en CAD creada para este cliente. Sin embargo, no se utilizará para facturas creadas en diferentes divisas.