Cetelem integración de interfaces y soluciones de Open Finance (br.com.cetelem.mobilebank)

Entregables estándar

• Informe de análisis de protocolos (app → backend → cadena de pagos de terceros)
• Especificación de API OpenAPI/Swagger y ejemplos de requests/responses
• Código fuente ejecutable (Python/Node.js) con pruebas unitarias y scripts de ejemplo
• Webhooks y lógica de flujo de eventos, reintentos y idempotencia
• Scripts de conciliación y exportación de informes (Excel/CSV/PDF)
• Sugerencias de cumplimiento: LGPD, GDPR, Banco Central y buenas prácticas

Ejemplo: API de consulta de tarjetas (pseudocódigo)

// POST /api/v1/cetelem/transactions
// Autorización: Bearer <ACCESS_TOKEN>
{
  'account_id': 'user_account_123',
  'from_date': '2025-10-01',
  'to_date': '2025-10-31',
  'page': 1,
  'page_size': 50
}

Respuesta: {
  'status': 'OK',
  'transactions': [
    { 'id':'txn_001','date':'2025-10-03','amount':-120.50,'merchant':'Supermercado','type':'CREDIT_CARD' },
    { 'id':'txn_002','date':'2025-10-07','amount':3500.00,'merchant':'Salary','type':'CREDIT' }
  ],
  'meta': { 'page':1,'total_pages':2 }
}

Ejemplo: generación de código de barras para factura (Boleto)

// POST /api/v1/cetelem/boleto/create
{
  'customer_id': 'user_123',
  'due_date': '2025-11-15',
  'amount': 250.75,
  'description': 'Factura tarjeta de crédito - Octubre'
}

Respuesta: {
  'status': 'CREATED',
  'boleto': {
    'barcode': '23791234567890123456789012345678901234567890',
    'line': '23790.12345 67890.123456 78901.234567 8 12345678901234',
    'expires': '2025-11-15'
  }
}

Aspectos de cumplimiento y seguridad

En el mercado brasileño seguiremos LGPD y las normas del Banco Central. Todas las integraciones se realizan a partir de la autorización del cliente o de APIs públicas/colaborativas, con recomendaciones de minimización de datos, registros de consentimiento, cifrado y auditoría.

Clientes y escenarios de implementación

• FinTechs: agregación de cuentas y acceso a pagos y liquidaciones
• Empresas y software de contabilidad: conciliación automática, pagos de nómina, integración F24
• Plataformas de comercio y servicios: cobros, reembolsos y gestión de tarjetas automatizada
• TPP: autorización PSD2 y adaptación de interfaces

Guía rápida de integración API (para responsables de tech)

1. Proporcione el caso objetivo y permisos requeridos (KYC, préstamos, callbacks, agregación de cuentas).
2. Realizamos el análisis de protocolo: captura de red, secuencias de autorización, certificados y nodos de encriptación (2-5 días hábiles).
3. Diseño y desarrollo: generar especificación OpenAPI y SDK/ middleware (3-10 días hábiles, según complejidad).
4. Pruebas y cumplimiento: pruebas de integración, pruebas de regresión y documentación de entrega (1-4 días hábiles).
5. Entrega y soporte: código fuente, scripts de despliegue, colección Postman y 30 días de soporte técnico.

Preguntas frecuentes

¿Qué información necesito proporcionar?

¿Cómo aseguramos el cumplimiento?