Programmgesteuerte Bearbeitung von Rückerstattungen, Rückbuchungen und Streitfällen¶

Übersicht¶

4Geeks Payments bietet umfassende Tools zur Verwaltung von Rückerstattungen, Rückbuchungen und Streitfällen. Als Ihr Merchant of Record kümmert sich 4Geeks um die Haftungs- und Compliance-Aspekte, Sie müssen jedoch weiterhin das Kundenerlebnis und die betrieblichen Arbeitsabläufe verwalten.

In diesem Tutorial werden Sie:

Verarbeiten Sie vollständige und teilweise Rückerstattungen über die API
Bearbeitung von Rückbuchungsbenachrichtigungen
Verwalten Sie Arbeitsabläufe zur Streitbeilegung
Richten Sie automatisierte Rückerstattungsrichtlinien ein
Überwachen Sie Rückerstattungs- und Streitfallmetriken

Schritt 1: Rückerstattungen bearbeiten¶

Volle Rückerstattung¶

const refund = await axios.post(
  `https://api.4geeks.io/v1/charges/${chargeId}/refunds`,
  {
    reason: 'requested_by_customer'
    // No amount = full refund
  },
  {
    headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
  }
);

console.log('Refund processed:', refund.data);
// ref_xxxxxxxxxxxxx

Teilweise Rückerstattung¶

const partialRefund = await axios.post(
  `https://api.4geeks.io/v1/charges/${chargeId}/refunds`,
  {
    amount: 2500,  // $25.00 in cents
    reason: 'product_defective'
  },
  {
    headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
  }
);

Rückerstattungsgründe¶

Grund	Beschreibung
`requested_by_customer`	Der Kunde hat die Rückerstattung beantragt
„Duplikat“	Es wurde eine doppelte Gebühr erhoben
„betrügerisch“	Der Ladevorgang war nicht autorisiert
`product_defective`	Produkt war defekt oder entsprach nicht der Beschreibung
`service_not_delivered`	Die Dienstleistung wurde nicht erbracht
`subscription_cancelled`	Abonnement wurde gekündigt

Mehrere Rückerstattungen für dieselbe Gebühr¶

Sie können mehrere Teilrückerstattungen mit einer einzigen Gebühr abwickeln:

// First partial refund: $25
await axios.post(`https://api.4geeks.io/v1/charges/${chargeId}/refunds`, {
  amount: 2500,
  reason: 'product_defective'
}, { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } });

// Second partial refund: $15
await axios.post(`https://api.4geeks.io/v1/charges/${chargeId}/refunds`, {
  amount: 1500,
  reason: 'shipping_delay'
}, { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } });

// Total refunded: $40 of original $100 charge

Schritt 2: Rückbuchungen bearbeiten¶

Chargeback-Webhook-Ereignisse¶

Wenn eine Rückbuchung erfolgt, erhalten Sie eine Webhook-Benachrichtigung:

// In your webhook handler
switch (event.type) {
  case 'chargeback.created':
    // Customer disputed the charge with their bank
    console.log('Chargeback created:', event.data);
    // Gather evidence: order details, delivery confirmation, communication
    submitChargebackEvidence(event.data.chargeback_id, evidence);
    break;

  case 'chargeback.updated':
    // Status changed (under review, evidence submitted, etc.)
    console.log('Chargeback updated:', event.data);
    break;

  case 'chargeback.won':
    // You won the dispute — funds returned
    console.log('Chargeback won:', event.data);
    updateOrderStatus(event.data.charge_id, 'chargeback_won');
    break;

  case 'chargeback.lost':
    // You lost the dispute — funds deducted
    console.log('Chargeback lost:', event.data);
    updateOrderStatus(event.data.charge_id, 'chargeback_lost');
    break;
}

Einreichen eines Rückbuchungsnachweises¶

const evidence = await axios.post(
  `https://api.4geeks.io/v1/chargebacks/${chargebackId}/evidence`,
  {
    // Evidence types
    product_description: 'Detailed description of the product/service',
    customer_communication: 'Email/chat logs showing customer agreement',
    delivery_confirmation: 'Tracking number and delivery confirmation',
    customer_signature: 'Signed delivery receipt (if applicable)',
    cancellation_policy: 'Link to your refund/cancellation policy',
    service_logs: 'Server logs showing service was provided',
    additional_evidence: 'Any other relevant documentation'
  },
  {
    headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
  }
);

Rückbuchungszeitplan¶

Bühne	Zeiteinteilung	Aktion erforderlich
Rückbuchung eingereicht	Tag 0	Benachrichtigung erhalten, Beweise sammeln
Beweisfrist	Tag 7-14	Reichen Sie alle Nachweise fristgerecht ein
Banküberprüfung	Tag 14-30	Bankentscheidung abwarten
Entscheidung	Tag 30-60	Gewinn-/Verlustbenachrichtigung erhalten
Darstellung	Tag 60-75	Optional: Entscheidung anfechten

Schritt 3: Streitigkeiten verwalten¶

Streit vs. Rückbuchung¶

Aspekt	Streit	Rückbuchung
Initiiert von	Der Kunde kontaktiert Sie direkt	Kunde kontaktiert seine Bank
Auflösung	Sie lösen mit dem Kunden	Bank entscheidet über das Ergebnis
Gebühren	Keine zusätzlichen Gebühren	Es fällt eine Rückbuchungsgebühr an
Zeitleiste	Sofort	30-75 Tage
Kontrolle	Volle Kontrolle	Begrenzte Kontrolle

Proaktive Streitprävention¶

// Set up automated refund for high-risk situations
const charge = await axios.get(
  `https://api.4geeks.io/v1/charges/${chargeId}`,
  { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } }
);

// If customer requests refund, process it immediately
// to prevent chargeback
if (charge.data.customer_complaint === true) {
  await axios.post(
    `https://api.4geeks.io/v1/charges/${chargeId}/refunds`,
    { reason: 'requested_by_customer' },
    { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } }
  );
}

Schritt 4: Automatische Rückerstattungsrichtlinien einrichten¶

Regeln für die automatische Rückerstattung¶

Konfigurieren Sie automatische Rückerstattungen basierend auf Bedingungen:

// Example: Auto-refund if subscription canceled within trial period
const subscription = await axios.get(
  `https://api.4geeks.io/v1/subscriptions/${subId}`,
  { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } }
);

if (subscription.data.trial_period && 
    subscription.data.days_active <= subscription.data.trial_period_days) {
  // Auto-refund the first charge
  await axios.post(
    `https://api.4geeks.io/v1/charges/${subscription.data.latest_charge_id}/refunds`,
    { reason: 'subscription_canceled' },
    { headers: { 'Authorization': `Bearer ${SECRET_KEY}` } }
  );
}

Konfiguration der Rückerstattungsrichtlinie¶

Gehen Sie zu Zahlungen → Einstellungen → Rückerstattungen
Konfigurieren:
Zeitraum für automatische Rückerstattung: Zeitraum für automatische Rückerstattungen (z. B. 14 Tage)
Teilweise Rückerstattung zulässig: Ja/Nein
Bearbeitungszeit der Rückerstattung: Sofort, 1–3 Tage, 5–10 Tage
Benachrichtigungseinstellungen: E-Mail an den Kunden bei Rückerstattung senden

Schritt 5: Erstattungs- und Streitfallmetriken überwachen¶

Dashboard-Metriken¶

Metrisch	Beschreibung	Ziel
Rückerstattungssatz	% der erstatteten Transaktionen	<5%
Rückbuchungssatz	% der umstrittenen Transaktionen	<1%
Gewinnquote bei Rückbuchungen	% der gewonnenen Rückbuchungen	>60 %
Durchschnittlicher Rückerstattungsbetrag	Mittlerer Rückerstattungswert	Trend verfolgen
Bearbeitungszeit der Rückerstattung	Durchschnittliche Bearbeitungszeit	<24 Stunden

Zugriffsberichte¶

Gehen Sie zu Zahlungen → Analysen → Rückerstattungen und Streitfälle
Sehen Sie sich Echtzeit-Dashboards an
Filtern Sie nach Datumsbereich, Produkt und Grund
Exportieren Sie Berichte zur Analyse

Best Practices¶

Rückerstattungsverwaltung¶

Rückerstattungen schnell bearbeiten: Schnelle Rückerstattungen verhindern Rückbuchungen
Klar kommunizieren: Teilen Sie Ihren Kunden mit, wann sie mit ihrer Rückerstattung rechnen müssen
Alles dokumentieren: Führen Sie Aufzeichnungen über alle Rückerstattungsanträge und deren Bearbeitung
Rückerstattungsmuster analysieren: Identifizieren Sie Produkte oder Dienstleistungen mit hohen Rückerstattungsraten

Rückbuchungsprävention¶

Klare Produktbeschreibungen: Vermeiden Sie irreführende Behauptungen
Einfacher Rückerstattungsprozess: Machen Sie eine Rückerstattung einfacher als eine Anfechtung
Lieferbestätigung: Stellen Sie immer eine Sendungsverfolgung und einen Liefernachweis bereit
Kundenkommunikation: Reagieren Sie auf Beschwerden, bevor sie eskalieren

Streitbeilegung¶

Schnell reagieren: Behandeln Sie Kundenbeschwerden innerhalb von 24 Stunden
Seien Sie fair: Bieten Sie angemessene Lösungen an, bevor es zu Rückbuchungen kommt
Interaktionen dokumentieren: Führen Sie Aufzeichnungen über die gesamte Kundenkommunikation
Aus Streitigkeiten lernen: Nutzen Sie Streitdaten, um Produkte und Prozesse zu verbessern

Was kommt als nächstes?¶

Erfahren Sie mehr über Multi-Currency Checkout
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