Valuta Adattiva

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Cos’è la Valuta Adattiva?

​

Vantaggi Chiave

• Esperienza di pagamento localizzata: I prezzi appaiono nella valuta locale per impostazione predefinita.
• Più metodi di pagamento: Sblocca i metodi di pagamento disponibili per la valuta locale.
• Rimborsi nella stessa valuta: Rimborso al cliente nella valuta con cui ha pagato.

​

Abilitare la Valuta Adattiva

​

Esperienza del Cliente

1. Rilevamento: Il sistema rileva il paese del cliente in base all’indirizzo di fatturazione.
2. Selezione della valuta: Se il paese è supportato, i prezzi vengono visualizzati nella valuta locale per impostazione predefinita. I clienti possono passare a USD.
3. Metodi di pagamento: I metodi di pagamento localizzati appaiono dove applicabile.
4. Checkout: Il pagamento viene completato nella valuta selezionata.

​

Conversione e Commissioni

• Tu paghi: 0% (predefinito) o 2–4% (quando le commissioni incluse sono abilitate)
• I tuoi clienti pagano: 2–4% in base al valore dell’ordine (predefinito) o 0% (quando le commissioni incluse sono abilitate)

• 4% per ordini inferiori a $500
• 3% per ordini da $500 a$1,500
• 2% per ordini superiori a $1,500

​

Scegli chi sostiene la commissione

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});

​

Valute Supportate

​

Rimborsi e Rettifiche

1. Vendi un prodotto per 100 USD con la conversione delle valute Adaptive abilitata.
2. Un cliente canadese vede 137 CAD a un tasso di cambio di 1,37 CAD per 1 USD e completa l’acquisto.
3. Elaboriamo il pagamento, convertendo 137 CAD a 100 USD per il tuo pagamento.
4. Successivamente, il tasso di cambio cambia a 1,40 CAD per 1 USD e tu emetti un rimborso completo.
5. Deduciamo 100 USD e rimborsiamo al cliente 140 CAD.

​

Fatture e Tassazione

• Le fatture mostrano solo l’importo in valuta di regolamento.
• Le tasse e le commissioni della piattaforma sono calcolate sull’importo della valuta di regolamento.
• Esempio: una vendita di $10 convertita in 36 AED riflette ancora come $10 nel Dashboard e nelle fatture.

​

Esempi di Integrazione

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});