Guía de Referencia API R4 Conecta

Desarrollado por: dPana Soft

Introducción

Bienvenido a la guía de referencia de la API R4 Conecta. Este documento está diseñado para usuarios no técnicos que necesitan comprender las capacidades y el funcionamiento general del sistema.

¿Qué es R4 Conecta?

R4 Conecta es una plataforma de integración bancaria que permite a las empresas:

Recibir pagos móviles de clientes
Realizar pagos a proveedores y empleados
Consultar tasas de cambio oficiales del BCV
Procesar transferencias bancarias inmediatas
Gestionar domiciliaciones de pagos recurrentes

Funcionalidades Principales

1. Consulta de Tasa de Cambio

Permite obtener la tasa de cambio oficial del Banco Central de Venezuela (BCV) para diferentes monedas.

Casos de uso:

Actualizar precios en moneda extranjera
Calcular equivalencias para reportes contables
Mostrar tasas actualizadas a clientes

Monedas soportadas: USD, EUR, y otras divisas oficiales

2. Recepción de Pagos Móviles

El sistema puede recibir notificaciones automáticas cuando un cliente realiza un pago móvil a su comercio.

Proceso:

Cliente realiza pago móvil desde su banco
Sistema valida la identidad del cliente
Se notifica el pago recibido
Se acredita automáticamente en su cuenta

Beneficios:

Conciliación automática de pagos
Reducción de errores manuales
Confirmación inmediata al cliente

3. Vuelto (Devolución de Dinero)

Permite devolver dinero a clientes mediante pago móvil.

Casos de uso:

Devoluciones por productos
Reembolsos de servicios
Pagos de comisiones

Requisitos:

Número de teléfono del beneficiario
Cédula de identidad
Código del banco
Monto a transferir

4. Dispersión de Pagos

Realiza múltiples pagos simultáneos a diferentes beneficiarios desde una sola transacción.

Casos de uso:

Pago de nómina a empleados
Pago a múltiples proveedores
Distribución de comisiones

Ventajas:

Ahorro de tiempo
Procesamiento en lote
Trazabilidad completa

5. Débito Inmediato

Permite cobrar directamente de la cuenta bancaria de un cliente con su autorización mediante OTP.

Proceso:

Se solicita generar un código OTP
Cliente recibe OTP en su teléfono
Cliente proporciona el OTP
Se procesa el débito inmediato

Casos de uso:

Cobro de servicios
Pagos de facturas
Suscripciones

6. Crédito Inmediato

Realiza transferencias inmediatas a cuentas bancarias de terceros.

Modalidades:

Por teléfono: Usando número de celular afiliado
Por cuenta: Usando número de cuenta de 20 dígitos

Casos de uso:

Pago a proveedores
Transferencias a empleados
Pagos urgentes

7. Domiciliación de Pagos

Configura pagos recurrentes automáticos desde cuentas de clientes.

Proceso:

Cliente autoriza domiciliación (primera vez)
Sistema registra la autorización
Pagos subsecuentes se procesan automáticamente

Casos de uso:

Suscripciones mensuales
Pagos de servicios recurrentes
Cuotas de financiamiento

8. Cobro C2P (Cliente a Comercio)

Permite cobrar directamente a clientes mediante pago móvil con OTP.

Diferencia con débito inmediato:

Usa la red de pago móvil
Requiere OTP del cliente
Procesamiento más rápido

Seguridad

Autenticación

Todas las operaciones requieren:

Token de comercio único por empresa
Firma digital HMAC-SHA256 en cada petición
Licencia activa con validez de fechas

Encriptación

Todas las comunicaciones usan HTTPS con TLS 1.2+
Los datos sensibles se encriptan en tránsito
Certificados emitidos por autoridades confiables

Validaciones

Verificación de identidad en cada transacción
Validación de montos y límites
Control de duplicados
Registro de auditoría completo

Códigos de Respuesta

Operaciones Exitosas

00: Transacción aprobada
ACCP: Operación aceptada
202: Mensaje recibido satisfactoriamente

Errores Comunes

51: Fondos insuficientes
56: Teléfono no coincide con cédula
80: Cédula inválida
AM04: Saldo insuficiente
AC01: Número de cuenta incorrecto

Límites y Restricciones

Límites de Transacciones

Monto máximo por transacción: Según límites bancarios
Cantidad de transacciones: 100 cada 15 minutos
Horario de operación: 24/7 (sujeto a disponibilidad bancaria)

Validaciones de Datos

Teléfonos: Formato 04XXXXXXXXX (11 dígitos)
Cédulas: Formato VXXXXXXXX o EXXXXXXXX
Montos: Máximo 8 enteros y 2 decimales
Cuentas: 20 dígitos numéricos

Flujos de Trabajo Típicos

Flujo 1: Recepción de Pago

Cliente realiza pago móvil
Sistema valida cliente (webhook consulta)
Banco procesa transacción
Sistema recibe notificación (webhook notifica)
Se acredita en cuenta del comercio
Se confirma al cliente

Flujo 2: Pago a Proveedor

Comercio solicita pago
Sistema valida datos del beneficiario
Se genera firma de seguridad
Se procesa transferencia
Se recibe confirmación con referencia
Se notifica al beneficiario

Flujo 3: Cobro con OTP

Comercio solicita generar OTP
Cliente recibe OTP en su teléfono
Cliente proporciona OTP al comercio
Comercio procesa débito con OTP
Se confirma transacción
Se emite comprobante

Reportes y Consultas

Consulta de Operaciones

Permite verificar el estado de transacciones procesadas usando el identificador único (UUID).

Estados posibles:

Aceptada
En proceso
Rechazada
Cancelada

Trazabilidad

Cada transacción genera:

Referencia única interbancaria
UUID de seguimiento interno
Timestamp de procesamiento
Código de respuesta detallado

Soporte y Contacto

Documentación Técnica

Para desarrolladores e integradores, consulte la Documentación Técnica API que incluye:

Especificaciones detalladas de endpoints
Ejemplos de código
Colecciones de prueba
Guías de integración

Asistencia

Para soporte técnico o consultas:

Email: soporte@dpanasoft.com
Documentación: Disponible en el portal web
Horario: Lunes a Viernes, 8:00 AM - 6:00 PM

Glosario

OTP: One-Time Password (Contraseña de un solo uso)
HMAC: Hash-based Message Authentication Code
UUID: Identificador único universal
TLS: Transport Layer Security
BCV: Banco Central de Venezuela
C2P: Cliente a Comercio (Customer to Person)
P2P: Persona a Persona (Person to Person)
Webhook: Endpoint HTTP para recibir notificaciones automáticas

Preguntas Frecuentes

¿Qué necesito para integrar R4 Conecta?

Dominio propio con certificado SSL/TLS
Token de comercio proporcionado por el banco
Licencia activa del sistema
Servidor con IP fija (para webhooks)

¿Cuánto tiempo tarda una transacción?

Pagos móviles: Inmediato (segundos)
Transferencias bancarias: Inmediato a 2 minutos
Domiciliaciones: Según configuración bancaria

¿Qué pasa si una transacción falla?

El sistema retorna un código de error específico que indica la razón del fallo. Las transacciones fallidas no se cobran y pueden reintentarse.

¿Puedo hacer pruebas antes de producción?

Sí, se recomienda usar un ambiente de pruebas con datos ficticios antes de procesar transacciones reales.

¿Los datos están seguros?

Sí, todas las comunicaciones están encriptadas con TLS 1.2+, y se implementan múltiples capas de seguridad y validación.

Desarrollado por dPana Soft

Guía actualizada: 2025