Clienti multi-valuta

Usa l’API Invoicing per emettere una fattura per un cliente in una valuta diversa. Grazie alla funzione clienti multi-valuta, puoi addebitare gli importi allo stesso cliente utilizzando una valuta diversa da quella impostata come predefinita e modificare la valuta degli abbonamenti di un cliente. Non puoi avere due abbonamenti attivi con valute diverse.

Questa guida spiega anche come creare una nota di credito e consultare il saldo a credito di un cliente in tutte le valute assegnate. A scopo illustrativo, utilizziamo il dollaro canadese (CAD).

Crea una fattura

Prima di emettere la fattura a un cliente, crea una voce fattura specificando id, amount e currency. del cliente. Aggiungi le voci fattura a un solo cliente alla volta per evitare di aggiungerle a quello sbagliato.

Il numero massimo di voci fattura è 250. Quando crei una fattura, puoi aggiungere 250 voci fattura in sospeso, mentre le restanti verranno aggiunte alla fattura successiva. Per visualizzare le voci della fattura in sospeso del cliente, consulta la pagina Dettagli cliente o imposta l’attributo pending su true se utilizzi l’API per elencare tutte le voci della fattura.

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

Quando emetti una fattura multi-valuta, devi specificare il parametro currency, che determina quali voci della fattura vengono inserite nella fattura. Ad esempio, se crei due voci fattura, una in USD e l’altra in CAD, per lo stesso cliente, e imposti la valuta su CAD, verrà visualizzata solo la voce fattura in CAD, mentre la voce fattura in USD verrà ignorata.

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

In casi di problemi con la fattura, puoi creare una nota di credito. Se devi applicare il credito al saldo a credito del cliente (anziché al metodo di pagamento originale), Stripe alloca l’importo del credito al saldo a credito specifico 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

Ispeziona il saldo a credito

Per visualizzare l’importo del credito di un cliente in ciascuna valuta, utilizza il parametro invoice_credit_balance:

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

Il saldo a credito del cliente viene utilizzato per pagare la prossima fattura in CAD creata per questo cliente, ma non per le fatture create in altre valute.