🤖 Spiega con IA

Gestire rimborsi, storni di addebito e controversie in modo programmatico¶

Panoramica¶

4Geeks Payments fornisce strumenti completi per la gestione di rimborsi, storni di addebito e controversie. In qualità di commerciante registrato, 4Geeks gestisce gli aspetti di responsabilità e conformità, ma devi comunque gestire l’esperienza del cliente e i flussi di lavoro operativi.

In questo tutorial potrai:

• Elabora rimborsi completi e parziali tramite API
• Gestire le notifiche di chargeback
• Gestire i flussi di lavoro di risoluzione delle controversie
• Imposta politiche di rimborso automatizzate
• Monitorare le metriche relative a rimborsi e controversie

Passaggio 1: elaborazione dei rimborsi¶

Rimborso completo¶

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

Rimborso parziale¶

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

Motivi del rimborso¶

Rimborsi multipli con lo stesso addebito¶

Puoi elaborare più rimborsi parziali con un unico addebito:

CODICE_BLOCCO_2

Passaggio 2: gestire i chargeback¶

Eventi webhook di chargeback¶

Quando si verifica uno storno di addebito, riceverai una notifica webhook:

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

Invio della prova di chargeback¶

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

Cronologia del riaddebito¶

Passaggio 3: gestione delle controversie¶

Controversia contro chargeback¶

Prevenzione proattiva delle controversie¶

CODICE_BLOCCO_5

Passaggio 4: imposta le politiche di rimborso automatizzate¶

Regole di rimborso automatico¶

Configura i rimborsi automatici in base alle condizioni:

CODICE_BLOCCO_6

Configurazione della politica di rimborso¶

1. Vai su Pagamenti → Impostazioni → Rimborsi
2. Configura:
3. Finestra di rimborso automatico: periodo di tempo per i rimborsi automatici (ad es. 14 giorni)
4. Rimborso parziale consentito: Sì/No
5. Tempo di elaborazione del rimborso: istantaneo, 1-3 giorni, 5-10 giorni
6. Impostazioni di notifica: invia un’e-mail al cliente in merito al rimborso

Passaggio 5: monitorare i parametri relativi a rimborsi e controversie¶

Metriche del dashboard¶

Accedi ai rapporti¶

1. Vai su Pagamenti → Analisi → Rimborsi e controversie
2. Visualizza dashboard in tempo reale
3. Filtra per intervallo di date, prodotto e motivo
4. Esporta report per l’analisi

Migliori pratiche¶

Gestione dei rimborsi¶

• Elabora rapidamente i rimborsi: i rimborsi rapidi impediscono gli storni di addebito
• Comunica chiaramente: comunica ai clienti quando aspettarsi il rimborso
• Documenta tutto: conserva un registro di tutte le richieste di rimborso e dell’elaborazione
• Analizza i modelli di rimborso: identifica prodotti o servizi con tassi di rimborso elevati

Prevenzione dei riaddebiti¶

• Descrizioni chiare dei prodotti: evita affermazioni fuorvianti
• Procedura di rimborso semplice: rendi più semplice il rimborso che la contestazione
• Conferma di consegna: fornire sempre tracciabilità e prova di consegna
• Comunicazione con il cliente: rispondi ai reclami prima che si intensifichino

Risoluzione delle controversie¶

• Rispondi rapidamente: gestisci i reclami dei clienti entro 24 ore
• Sii onesto: offri soluzioni ragionevoli prima che si verifichino storni di addebito
• Interazioni con i documenti: conserva un registro di tutte le comunicazioni con i clienti
• Imparare dalle controversie: utilizzare i dati sulle controversie per migliorare prodotti e processi

Qual è il prossimo passo?¶

• Ulteriori informazioni sul Pagamento multivaluta
• 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