🤖 Explicar com IA

Lidando com reembolsos, estornos e disputas de maneira programática¶

Visão geral¶

4Geeks Payments fornece ferramentas abrangentes para gerenciar reembolsos, estornos e disputas. Como seu comerciante oficial, a 4Geeks cuida dos aspectos de responsabilidade e conformidade, mas você ainda precisa gerenciar a experiência do cliente e os fluxos de trabalho operacionais.

Neste tutorial, você irá:

• Processar reembolsos totais e parciais via API
• Lidar com notificações de estorno
• Gerenciar fluxos de trabalho de resolução de disputas
• Configure políticas de reembolso automatizadas
• Monitorar métricas de reembolso e disputa

Etapa 1: processar reembolsos¶

Reembolso total¶

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

Reembolso Parcial¶

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

Razões de reembolso¶

Vários reembolsos na mesma cobrança¶

Você pode processar vários reembolsos parciais com uma única cobrança:

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

Etapa 2: lidar com estornos¶

Eventos de webhook de estorno¶

Quando ocorrer um estorno, você receberá uma notificação de webhook:

CODE_BLOCO_3

Envio de evidências de estorno¶

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

Cronograma de estorno¶

Etapa 3: Gerenciar disputas¶

Disputa vs. Estorno¶

Prevenção proativa de disputas¶

CODE_BLOCO_5

Etapa 4: configurar políticas de reembolso automatizado¶

Regras de reembolso automático¶

Configure reembolsos automáticos com base nas condições:

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

Configuração da política de reembolso¶

1. Vá para Pagamentos → Configurações → Reembolsos
2. Configurar:
3. Janela de reembolso automático: período de tempo para reembolsos automáticos (por exemplo, 14 dias)
4. Reembolso parcial permitido: Sim/Não
5. Tempo de processamento do reembolso: Instantâneo, 1 a 3 dias, 5 a 10 dias
6. Configurações de notificação: Enviar e-mail ao cliente sobre reembolso

Etapa 5: Monitore as métricas de reembolso e disputa¶

Métricas do painel¶

Acesse relatórios¶

1. Vá para Pagamentos → Análises → Reembolsos e disputas
2. Visualize painéis em tempo real
3. Filtre por período, produto e motivo
4. Exporte relatórios para análise

Melhores práticas¶

Gerenciamento de reembolso¶

• Processar reembolsos rapidamente: reembolsos rápidos evitam estornos
• Comunique-se claramente: informe aos clientes quando esperar o reembolso
• Documente tudo: mantenha registros de todas as solicitações e processamentos de reembolso
• Analise padrões de reembolso: identifique produtos ou serviços com altas taxas de reembolso

Prevenção de estorno¶

• Descrições claras dos produtos: evite afirmações enganosas
• Processo de reembolso fácil: torne mais fácil reembolsar do que contestar
• Confirmação de entrega: Sempre forneça rastreamento e comprovante de entrega
• Comunicação com o cliente: responda às reclamações antes que elas aumentem

Resolução de disputas¶

• Responda rapidamente: resolva as reclamações dos clientes dentro de 24 horas
• Seja justo: ofereça soluções razoáveis antes que ocorram estornos
• Interações de documentos: mantenha registros de todas as comunicações do cliente
• Aprenda com as disputas: use dados de disputas para melhorar produtos e processos

O que vem a seguir?¶

• Saiba mais sobre Checkout multimoedas
• Leia sobre 3D Secure para prevenção de fraudes

Precisa de ajuda?¶

• Documentação: docs.4geeks.io/en/payments
• Referência da API: docs.4geeks.io/en/api
• Suporte: disponível no painel do console

Ainda tem dúvidas? Pergunte na Discord or explore tutoriais