Tratamento de Erros

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Descrição legível do problema"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Dados inválidos na requisição",
    "details": {
      "errors": [
        { "field": "amount", "message": "Valor mínimo é 100 centavos (R$ 1,00)" },
        { "field": "email", "message": "Formato de e-mail inválido" }
      ]
    }
  }
}

const Joi = require('joi');

const chargeSchema = Joi.object({
  gateway: Joi.string().valid('stripe', 'pagarme', 'asaas', 'mercadopago', 'pagseguro').required(),
  paymentMethod: Joi.string().valid('credit_card', 'boleto', 'pix').required(),
  amount: Joi.number().integer().min(100).required(),
  customer: Joi.object({
    name: Joi.string().min(3).max(100).required(),
    email: Joi.string().email().required(),
    document: Joi.string().pattern(/^\d{11}$|^\d{14}$/).required()
  })
});

{
  "success": false,
  "error": {
    "code": "GATEWAY_TIMEOUT",
    "message": "O gateway Stripe não respondeu dentro do tempo limite (30 segundos)."
  }
}

async function createChargeWithRetry(data, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch('https://api.toktus.com/api/v1/charges', {
        method: 'POST',
        headers: {
          'x-api-key': API_KEY,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(data)
      });

      if (response.status === 504 && attempt < maxRetries) {
        await sleep(Math.pow(2, attempt) * 1000); // 2s, 4s, 8s
        continue;
      }

      return await response.json();
    } catch (error) {
      if (attempt === maxRetries) throw error;
      await sleep(2000);
    }
  }
}

{
  "success": false,
  "error": {
    "code": "GATEWAY_UNSUPPORTED_OPERATION",
    "message": "Asaas exige \"customerId\" em toda cobrança. Crie um customer antes (POST /api/v1/customers) e envie o externalId retornado."
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Limite de requisições excedido."
  }
}

async function makeRequest(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      await sleep(retryAfter * 1000);
      continue;
    }

    return response;
  }
}

{
  "success": false,
  "error": {
    "code": "GATEWAY_ERROR",
    "message": "Erro retornado pelo gateway Stripe: Card declined",
    "gateway": "stripe"
  }
}

const ERROR_MESSAGES = {
  card_declined: 'Seu cartão foi recusado. Por favor, tente outro cartão.',
  insufficient_funds: 'Saldo insuficiente. Por favor, use outro cartão.',
  expired_card: 'Seu cartão está vencido. Por favor, atualize os dados.',
  incorrect_cvc: 'Código de segurança (CVV) incorreto.',
  processing_error: 'Erro no processamento. Por favor, tente novamente.'
};

{
  "success": false,
  "error": {
    "code": "GATEWAY_UNREACHABLE",
    "message": "Não foi possível estabelecer conexão com o gateway Stripe."
  }
}

const GATEWAY_PRIORITY = ['stripe', 'pagarme', 'asaas'];

async function createChargeWithFallback(data) {
  for (const gateway of GATEWAY_PRIORITY) {
    try {
      data.gateway = gateway;
      return await createCharge(data);
    } catch (error) {
      console.warn(`Falha em ${gateway}:`, error.message);
      if (gateway === GATEWAY_PRIORITY.at(-1)) throw error;
    }
  }
}