🤖 Erklären mit KI

Kaufabwicklung in mehreren Währungen: Akzeptieren von Zahlungen weltweit¶

Übersicht¶

Mit 4Geeks Payments können Sie Zahlungen in mehreren Währungen akzeptieren und so lokalisierte Checkout-Erlebnisse für Kunden weltweit bieten. Als Ihr eingetragener Händler kümmert sich 4Geeks automatisch um die Währungsumrechnung, grenzüberschreitende Compliance und lokale Zahlungsmethoden.

In diesem Tutorial werden Sie:

• Konfigurieren Sie unterstützte Währungen
• Richten Sie eine dynamische Währungsumrechnung ein
• Implementieren Sie lokalisierte Checkout-Erlebnisse
• Verwalten Sie Abonnements in mehreren Währungen
• Überwachen Sie Wechselkurse und Umrechnungsgebühren

Unterstützte Währungen¶

4Geeks Payments unterstützt mehr als 135 Währungen. Zu den am häufigsten verwendeten gehören:

Schritt 1: Unterstützte Währungen konfigurieren¶

1. Melden Sie sich bei console.4geeks.io an.
2. Navigieren Sie zu Zahlungen → Einstellungen → Währungen
3. Aktivieren Sie die Währungen, die Sie akzeptieren möchten:
4. Schalten Sie jede Währung ein/aus
5. Legen Sie Rundungsregeln fest (z. B. auf die nächste 0,99 runden).
6. Anzeigeformat konfigurieren (Symbolposition, Nachkommastellen)

Einstellungen für die Währungsanzeige¶

Schritt 2: Dynamische Währungsumrechnung implementieren¶

Verwendung von Zahlungslinks¶

Zahlungslinks erkennen automatisch den Standort des Kunden und zeigen Preise in seiner Landeswährung an:

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

Direkte API verwenden¶

Geben Sie für den benutzerdefinierten Checkout die bevorzugte Währung des Kunden an:

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}` }
});

Schritt 3: Lokalisierten Checkout einrichten¶

Kundenstandort ermitteln¶

// Option 1: Browser locale
const browserCurrency = navigator.language;
// 'en-US' → USD, 'es-MX' → MXN, 'de-DE' → EUR

// Option 2: IP geolocation (server-side)
const customerCountry = req.headers['cf-ipcountry']; // Cloudflare
// 'US' → USD, 'MX' → MXN, 'DE' → EUR

// Option 3: Customer preference (stored in profile)
const preferredCurrency = customer.preferences.currency;

Lokalisierte Preise anzeigen¶

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

Lokale Zahlungsmethoden¶

4Geeks Payments bietet automatisch relevante Zahlungsmethoden basierend auf Währung und Standort an:

Schritt 4: Abonnements in mehreren Währungen verwalten¶

Erstellen eines Mehrwährungsplans¶

// 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}` }
});

Währungssperre für Abonnements¶

Wenn ein Kunde ein Abonnement abschließt, ist seine Währung gesperrt:

• **Die Abrechnung erfolgt während der gesamten Laufzeit des Abonnements weiterhin in derselben Währung
• Wechselkursschwankungen haben keinen Einfluss auf den Preis des Kunden
• Planänderungen (Upgrade/Downgrade) verwenden dieselbe Währung
• Der Kunde kann einen Währungswechsel anfordern (erfordert Supporteingriff)

Schritt 5: Wechselkurse und Umrechnung überwachen¶

Wechselkurs-Dashboard¶

1. Gehen Sie zu Zahlungen → Analysen → Mehrwährung
2. Ansicht:
3. Aktuelle Wechselkurse für alle aktivierten Währungen
4. Preisverlauf im Laufe der Zeit
5. Conversion-Volumen nach Währung
6. Umsatz nach Währung

Umrechnungsgebühren¶

Umsatzberichterstattung¶

Umsatz aufgeschlüsselt anzeigen nach:

• Transaktionswährung: Was der Kunde bezahlt hat
• Abrechnungswährung: Was Sie erhalten haben
• Umrechnungseffekt: Gewinn/Verlust aus Wechselkursschwankungen

Best Practices¶

Preisstrategie¶

• Legen Sie wettbewerbsfähige lokale Preise fest: Konvertieren Sie nicht nur – recherchieren Sie die lokalen Marktpreise
• Verwenden Sie psychologische Preise: 49,99 $ → 44,99 € → 949 MX$
• Kaufkraft berücksichtigen: Passen Sie die Preise für verschiedene Regionen an
• Preise vierteljährlich überprüfen: Wechselkurse und Marktbedingungen ändern sich

Kundenerfahrung¶

• Preise standardmäßig in lokaler Währung anzeigen
• Zeigen Sie die Originalwährung an für mehr Transparenz
• Erklären Sie die Umrechnung, wenn die Kartenwährung des Kunden abweicht
• Angebotswährungsauswahl auf der Checkout-Seite

Risikomanagement¶

• Wechselkursvolatilität überwachen: Große Schwankungen können sich auf die Margen auswirken
• Legen Sie Mindesttransaktionsbeträge fest pro Währung, um geringe Gebühren zu vermeiden
• Verwenden Sie Währungsabsicherung für große, vorhersehbare internationale Umsätze
• Überprüfen Sie die grenzüberschreitenden Vorschriften: In einigen Ländern gelten Zahlungsbeschränkungen

Was kommt als nächstes?¶

• Erfahren Sie mehr über den Umgang mit Rückerstattungen und Rückbuchungen (/en/tutorials/refunds-chargebacks/)
• Lesen Sie mehr über 3D Secure zur Betrugsprävention

Brauchen Sie Hilfe?¶

• Dokumentation: docs.4geeks.io/en/zahlungen
• API-Referenz: docs.4geeks.io/en/api
• Support: Verfügbar über das Konsolen-Dashboard

Noch Fragen? Get support or explore tutorials