Buenas prácticas

┌─────────────────────────────────────────────────┐
│  Confirmar transferencia                        │
│                                                 │
│  Destinatario: Maria Silva                      │
│  Banco: Bradesco (237)                          │
│                                                 │
│  Valor: R$ 1.500,00                             │
│  Tarifa: R$ 8,50                                │
│  ─────────────────────────                      │
│  Total: R$ 1.508,50                             │
│                                                 │
│  [ Cancelar ]              [ Confirmar ]        │
└─────────────────────────────────────────────────┘

function isWithinOperatingHours() {
  const now = new Date();
  const brasiliaOffset = -3 * 60; // UTC-3
  const utc = now.getTime() + now.getTimezoneOffset() * 60000;
  const brasilia = new Date(utc + brasiliaOffset * 60000);

  const day = brasilia.getDay();
  const hour = brasilia.getHours();
  const minute = brasilia.getMinutes();
  const time = hour * 60 + minute;

  // Lun-Vie (1-5), 06:30-17:00
  const isWeekday = day >= 1 && day <= 5;
  const isWithinHours = time >= 390 && time <= 1020; // 6:30=390, 17:00=1020

  return isWeekday && isWithinHours;
}

TED disponible de lunes a viernes, de 06:30 a 17:00.
Próximo horario disponible: lunes, 06:30.

const feriadosBancarios2026 = [
  '2026-01-01', // Año Nuevo
  '2026-02-16', // Carnaval
  '2026-02-17', // Carnaval
  '2026-04-03', // Viernes Santo
  '2026-04-21', // Tiradentes
  '2026-05-01', // Día del Trabajo
  '2026-06-04', // Corpus Christi
  '2026-09-07', // Independencia
  '2026-10-12', // Nuestra Señora Aparecida
  '2026-11-02', // Día de los Muertos
  '2026-11-15', // Proclamación de la República
  '2026-12-25', // Navidad
];

POST /v1/transfers/initiate
X-Idempotency-Key: 7c9e6679-7425-40de-944b-e07fc1f90ae7

async function initiateTransfer(data) {
  const idempotencyKey = crypto.randomUUID();

  // Guarda la clave localmente
  await localStorage.setItem(`transfer:${data.senderAccountId}`, idempotencyKey);

  try {
    const response = await api.post('/v1/transfers/initiate', data, {
      headers: { 'X-Idempotency-Key': idempotencyKey },
    });
    return response.data;
  } catch (error) {
    if (error.code === 'NETWORK_ERROR') {
      // Puede reenviar con la misma clave
      return retryWithSameKey(data, idempotencyKey);
    }
    throw error;
  }
}

const errorMessages = {
  'BTF-0010': 'Transferencias disponibles de lunes a viernes, de 06:30 a 17:00.',
  'BTF-0011': 'Ha alcanzado el límite diario de transferencias.',
  'BTF-0012': 'Una transferencia idéntica fue enviada hace pocos segundos.',
  'BTF-2001': 'Saldo insuficiente para esta transferencia.',
  'BTF-0500': 'No encontramos la cuenta de destino. Verifique los datos.',
  'BTF-1000': 'Servicio temporalmente no disponible. Intente nuevamente en algunos minutos.',
};

function getUserMessage(error) {
  return errorMessages[error.code] || 'Ocurrió un error. Intente nuevamente.';
}

async function withRetry(fn, maxAttempts = 3) {
  const retryableCodes = ['BTF-1000', 'BTF-0501', 'BTF-2000', 'BTF-3000'];

  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    try {
      return await fn();
    } catch (error) {
      const isRetryable = retryableCodes.includes(error.code);
      const isLastAttempt = attempt === maxAttempts;

      if (!isRetryable || isLastAttempt) {
        throw error;
      }

      const delay = Math.pow(2, attempt) * 1000; // 2s, 4s, 8s
      await sleep(delay);
    }
  }
}

func validateRecipient(r RecipientDetails) error {
    // ISPB: exactamente 8 dígitos
    if !regexp.MustCompile(`^\d{8}$`).MatchString(r.ISPB) {
        return ErrInvalidISPB
    }

    // HolderDocument: CPF (11) o CNPJ (14)
    if !isValidCPF(r.HolderDocument) && !isValidCNPJ(r.HolderDocument) {
        return ErrInvalidDocument
    }

    // Valor: positivo, máximo 2 decimales
    if r.Amount <= 0 || !hasMaxTwoDecimals(r.Amount) {
        return ErrInvalidAmount
    }

    return nil
}

app.post('/webhooks/ted', (req, res) => {
  if (!validateSignature(req)) {
    logger.warn('Invalid webhook signature', { ip: req.ip });
    return res.status(401).send('Unauthorized');
  }
  // ...
});

[✓] Transferencia iniciada
[✓] Fondos reservados
[○] Esperando confirmación del banco
[ ] Completada

// Servidor recibe webhook
socket.to(transfer.userId).emit('transfer:updated', {
  transferId: transfer.id,
  status: 'COMPLETED',
});

// Cliente actualiza la UI
socket.on('transfer:updated', (data) => {
  updateTransferStatus(data.transferId, data.status);
});

async function syncTransfers() {
  const lastSync = await getLastSyncTimestamp();
  const transfers = await api.get('/v1/transfers', {
    params: { fromDate: lastSync },
  });

  for (const transfer of transfers.data) {
    await upsertLocalTransfer(transfer);
  }

  await setLastSyncTimestamp(new Date());
}

async function checkLimits(accountId, amount) {
  const limits = await api.get(`/accounts/${accountId}/limits`);

  if (limits.dailyUsed + amount > limits.dailyLimit) {
    return {
      allowed: false,
      reason: 'daily_limit',
      available: limits.dailyLimit - limits.dailyUsed,
    };
  }

  return { allowed: true };
}

Límite diario: R$ 50.000,00
Utilizado hoy: R$ 45.000,00
Disponible: R$ 5.000,00

{
  "timestamp": "2026-01-21T14:30:00-03:00",
  "action": "TRANSFER_INITIATED",
  "userId": "user-123",
  "transferId": "transfer-456",
  "ip": "192.168.1.1",
  "userAgent": "Mozilla/5.0..."
}

DELETE /admin/v1/transfers/{id}/anonymize