🤖 Spiega con IA

Checkout multivaluta: accettazione di pagamenti a livello globale¶

Panoramica¶

4Geeks Payments ti consente di accettare pagamenti in più valute, fornendo esperienze di pagamento localizzate per i clienti in tutto il mondo. In qualità di commerciante registrato, 4Geeks gestisce automaticamente la conversione di valuta, la conformità transfrontaliera e i metodi di pagamento locali.

In questo tutorial potrai:

• Configura le valute supportate
• Imposta la conversione dinamica della valuta
• Implementare esperienze di pagamento localizzate
• Gestire abbonamenti multivaluta
• Monitorare i tassi di cambio e le commissioni di conversione

Valute supportate¶

4Geeks Payments supporta oltre 135 valute. Quelli più comunemente usati includono:

Passaggio 1: configura le valute supportate¶

1. Accedi a console.4geeks.io
2. Vai a Pagamenti → Impostazioni → Valute
3. Abilita le valute che desideri accettare:
4. Attiva/disattiva ciascuna valuta
5. Imposta le regole di arrotondamento (ad esempio, arrotonda allo 0,99 più vicino)
6. Configurare il formato di visualizzazione (posizione del simbolo, cifre decimali)

Impostazioni di visualizzazione della valuta¶

Passaggio 2: implementa la conversione dinamica della valuta¶

Utilizzo dei link di pagamento¶

I link di pagamento rilevano automaticamente la posizione del cliente e mostrano i prezzi nella valuta locale:

const paymentLink = await axios.post('https://api.4geeks.io/v1/payment-links', {
  amount: 4900,           // Base amount in your default currency
  currency: 'USD',        // Base currency
  description: 'Pro Plan',
  customer_email: 'customer@example.com',
  auto_convert: true,     // Enable automatic currency conversion
  supported_currencies: ['USD', 'EUR', 'GBP', 'MXN', 'BRL'],
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel'
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

// Customer sees the price in their local currency
// based on their location and browser settings

Utilizzo dell’API diretta¶

Per il checkout personalizzato, specifica la valuta preferita del cliente:

const charge = await axios.post('https://api.4geeks.io/v1/charges', {
  amount: 99000,          // Amount in the target currency's smallest unit
  currency: 'EUR',        // Customer's currency
  customer_id: 'cus_xxx',
  description: 'Annual Plan',
  metadata: {
    original_amount: 10800,  // Original USD amount
    original_currency: 'USD',
    exchange_rate: 0.917     // Rate at time of transaction
  }
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

Passaggio 3: imposta il pagamento localizzato¶

Rileva la posizione del cliente¶

CODICE_BLOCCO_2

Visualizza i prezzi localizzati¶

// Fetch real-time exchange rate
const rate = await getExchangeRate('USD', targetCurrency);

// Convert and format
const localAmount = Math.round(baseAmount * rate);
const formattedPrice = formatCurrency(localAmount, targetCurrency);
// "$49.00" → "€45.00" → "MX$980.00"

// Display on checkout page
document.getElementById('price').textContent = formattedPrice;

Metodi di pagamento locali¶

4Geeks Payments offre automaticamente metodi di pagamento pertinenti in base alla valuta e alla località:

Passaggio 4: gestisci gli abbonamenti multivaluta¶

Creare un piano multivaluta¶

// Create plan with multiple currency prices
const plan = await axios.post('https://api.4geeks.io/v1/plans', {
  name: 'Pro Plan',
  currencies: {
    USD: { amount: 4900, display: '$49.00/month' },
    EUR: { amount: 4500, display: '€45.00/month' },
    GBP: { amount: 3900, display: '£39.00/month' },
    MXN: { amount: 98000, display: 'MX$980.00/month' },
    BRL: { amount: 24500, display: 'R$245.00/month' }
  },
  interval: 'month',
  trial_period_days: 14
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

Blocco valuta per gli abbonamenti¶

Quando un cliente si abbona, la sua valuta è bloccata:

• La fatturazione continua nella stessa valuta per tutta la durata dell’abbonamento
• Le fluttuazioni del tasso di cambio non influiscono sul prezzo del cliente
• Le modifiche al piano (upgrade/downgrade) utilizzano la stessa valuta
• Il cliente può richiedere cambio valuta (richiede intervento di supporto)

Passaggio 5: monitora i tassi di cambio e la conversione¶

Pannello dei tassi di cambio¶

1. Vai su Pagamenti → Analisi → Multivaluta
2. Visualizza:
3. Tassi di cambio attuali per tutte le valute abilitate
4. Valutazione della cronologia nel tempo
5. Volume di conversione per valuta
6. Entrate per valuta

Commissioni di conversione¶

Reporting delle entrate¶

Visualizza le entrate suddivise per:

• Valuta della transazione: importo pagato dal cliente
• Valuta di liquidazione: quanto hai ricevuto
• Impatto conversione: utile/perdita derivante dai movimenti dei tassi di cambio

Migliori pratiche¶

Strategia dei prezzi¶

• Imposta prezzi locali competitivi: non limitarti a convertire: ricerca le tariffe del mercato locale
• Utilizza prezzi psicologici: \(49,99 → €44,99 → MX\)949
• Considera il potere d’acquisto: modifica i prezzi per le diverse regioni
• Rivedere i prezzi trimestralmente: i tassi di cambio e le condizioni di mercato cambiano

Esperienza del cliente¶

• Mostra i prezzi in valuta locale per impostazione predefinita
• Visualizza la valuta originale per trasparenza
• Spiegare la conversione se la valuta della carta del cliente è diversa
• Selezione della valuta dell’offerta nella pagina di pagamento

Gestione del rischio¶

• Monitora la volatilità del tasso di cambio: ampie oscillazioni possono incidere sui margini
• Imposta importi minimi di transazione per valuta per evitare piccoli addebiti
• Utilizzare la copertura valutaria per entrate internazionali elevate e prevedibili
• Rivedi le normative transfrontaliere: alcuni paesi hanno restrizioni sui pagamenti

Qual è il prossimo passo?¶

• Ulteriori informazioni sulla gestione di rimborsi e storni di addebito
• Leggi informazioni su 3D Secure per la prevenzione delle frodi

Hai bisogno di aiuto?¶

• Documentazione: docs.4geeks.io/en/payments
• Riferimento API: docs.4geeks.io/en/api
• Supporto: disponibile tramite il dashboard della console

Hai ancora domande? Richiedi supporto or explore tutoriali