Servicios de integración API de Deuna Negocios (OpenFinance Ecuador)

Por qué importan los datos de Deuna Negocios

Desde su lanzamiento en 2026, Deuna Negocios se ha posicionado como una herramienta integral para el comercio en los micro y pequeños negocios del Ecuador, centralizando cobros, cierre de caja y permisos del equipo en una única app de Android e iOS. Cada transacción generada en la app es estructurada: lleva un monto, un motivo, una identidad de cajero, una marca de tiempo y un destino de liquidación (una cuenta Deuna o Banco Pichincha, o un número telefónico Deuna).

Para una plataforma de terceros — un ERP, un SaaS contable, un marketplace de delivery o una herramienta de declaraciones tributarias — ese flujo de pagos estructurado es justamente lo que una integración OpenFinance puede desbloquear: visibilidad en tiempo real de ingresos, conciliación automatizada contra facturas y evidencia con calidad de auditoría para el Servicio de Rentas Internas (SRI) y la Superintendencia de Bancos del Ecuador.

Conectamos con Deuna Negocios mediante sus APIs de comercio documentadas y mediante análisis de protocolo autorizado donde se requieran datos adicionales, de modo que su producto pueda leer ventas, levantar cobros, escuchar webhooks y disparar reembolsos sin obligar al comercio a salir de su app actual.

Cambio reciente que vale la pena destacar

En 2025–2026, Deuna lanzó una actualización mayor para el lado comercio: los negocios ahora pueden aceptar pagos con tarjetas de débito y crédito directamente desde el celular, sin lector adicional ni terminal POS. Esto amplía el modelo de datos direccionable, pasando de flujos exclusivamente QR a la aceptación completa de tarjetas, lo que significa que nuestras integraciones también pueden exponer la marca de la tarjeta, el estado de autorización y la metadata de liquidación del adquirente.

En paralelo, Deuna se ha interconectado con la red blu y con más de veinte cooperativas en Ecuador, lo que significa que un solo comercio Deuna Negocios ahora recibe pagos QR originados desde Banca Móvil de Banco Pichincha, BGR Digital, Alianza del Valle, Tulcán y muchas apps cooperativas — todos unificados en un único feed transaccional que podemos exportar.

API de cobro QR

Genere QR estático con monto precargado o QR dinámico por checkout, ambos vinculados al número de pedido interno. Caso de uso: el POS de un restaurante emite un QR por mesa; el sistema de cocina marca la orden como pagada solo cuando nuestro webhook confirma la venta Deuna.

Estado de pago y consulta por cajero

Consulte una transacción por referencia, recupere el cajero operador (rol y alcance de permisos), el texto del concepto y la marca de tiempo. Caso de uso: conciliación de fin de día en una herramienta contable, donde cada venta Deuna se cruza con el turno del cajero y la línea de factura.

Webhook para notificaciones de venta

Suscríbase a callbacks POST instantáneos cuando un cliente paga. Caso de uso: un sistema de inventario descuenta stock en el momento en que Deuna confirma la transacción QR o por link de pago, eliminando el ciclo de polling y reduciendo sobreventas.

API de reembolso y cancelación

Solicite programáticamente un reembolso o cancele un cobro pendiente. Caso de uso: la consola de atención al cliente de un marketplace emite un reembolso directo a la cuenta Deuna del comprador sin pasos manuales dentro de la app del comercio.

Puente de transferencia y liquidación

Lea las transferencias entre cuentas Deuna, cuentas Banco Pichincha y números telefónicos Deuna. Caso de uso: un dashboard de tesorería consolida los ingresos diarios por tienda y empuja los datos de liquidación al ERP corporativo.

Reportes y exportación de cierre de caja

Traiga las entradas de gestión de caja, los reportes diarios y los recordatorios de cierre a su tooling. Caso de uso: un retailer multi-sucursal alimenta los eventos de cierre de caja Deuna en un cubo BI para comparar ventas en la app contra recibos POS.

Escenario 1 — Conciliación de ventas en ERP para pymes

Una cadena minorista ecuatoriana opera un ERP con reportería multi-sucursal. Conectamos un webhook de Deuna Negocios para cada venta QR o de tarjeta, empujamos el evento a una cola y posteamos un asiento contable en el ERP que vincula la referencia de la transacción Deuna con una línea de factura. El mapeo usa cashier_id, store_code y concept del payload Deuna, alineándose con los principios de OpenFinance de compartir datos de pagos de comercio consentidos y granulares.

Escenario 2 — Checkout en línea con link de pago

Un marketplace genera un link de pago Deuna mediante la API de comercio, lo embebe en la página de checkout y escucha el webhook de éxito. Al confirmarse, la orden pasa a "pagada" y el módulo de bodega despacha el paquete. Esto evita redirigir al cliente a una pasarela externa y reutiliza la cuenta Deuna Negocios existente del comercio, manteniendo el flujo OpenBanking dentro de un único proveedor regulado.

Escenario 3 — Cumplimiento tributario y declaración al SRI

Un SaaS de tax-tech extrae una exportación diaria de todas las transacciones de Deuna Negocios para un RUC dado, las clasifica por categoría de IVA y emite el payload de declaración al portal del SRI. Los datos Deuna llevan el RUC del comercio, el concepto de la transacción y el monto — exactamente los campos requeridos para reportería con IVA en Ecuador.

Escenario 4 — Crédito y scoring para micro-comercios

Un prestamista digital solicita, con consentimiento explícito del comercio, una ventana de 90 días de ventas Deuna Negocios. La plataforma las convierte en un score de flujo de caja, incluyendo ticket promedio, número de clientes pagadores y estacionalidad, y ofrece una línea de capital de trabajo. Es un caso de uso clásico de OpenFinance para el segmento de micro-comercio en LATAM.

Escenario 5 — Tableros BI para redes de franquicias

La oficina central de una franquicia consolida ventas Deuna Negocios de decenas de franquiciados en una herramienta BI (Looker, Metabase o Power BI). Nuestro pipeline normaliza store_code, cashier_id y payment_method, exponiendo KPIs de ventas diarias e intradía junto con eventos de liquidación de Banco Pichincha.

1) Generar un QR / link de pago

POST /api/v1/deuna-negocios/charges
Content-Type: application/json
Authorization: Bearer <MERCHANT_ACCESS_TOKEN>

{
  "ruc": "1790012345001",
  "store_code": "QUITO-NORTE-01",
  "amount": 18.75,
  "currency": "USD",
  "reason": "Order #A-9821",
  "method": "QR_DYNAMIC",
  "external_id": "ord_A9821"
}

200 OK
{
  "charge_id": "chg_01HXYZ...",
  "qr_payload": "00020101021226...",
  "payment_link": "https://pay.deuna.app/c/abc123",
  "expires_at": "2026-04-29T18:30:00-05:00",
  "status": "PENDING"
}

2) Consultar el estado de una transacción

GET /api/v1/deuna-negocios/charges/chg_01HXYZ
Authorization: Bearer <MERCHANT_ACCESS_TOKEN>

200 OK
{
  "charge_id": "chg_01HXYZ",
  "status": "PAID",
  "paid_at": "2026-04-29T17:42:11-05:00",
  "amount": 18.75,
  "cashier": { "id": "csh_22", "role": "CAJERO" },
  "payer": { "channel": "DEUNA_APP", "alias": "ana***@deuna" },
  "concept": "Order #A-9821",
  "settlement_target": "PICHINCHA_2200xxxx"
}

3) Webhook de callback y reembolso

POST https://your-api.example/webhooks/deuna
X-Deuna-Signature: t=1714421000,v1=...
{
  "event": "charge.paid",
  "charge_id": "chg_01HXYZ",
  "external_id": "ord_A9821",
  "amount": 18.75,
  "cashier_id": "csh_22"
}

# Verify signature, then optionally refund:
POST /api/v1/deuna-negocios/charges/chg_01HXYZ/refund
Authorization: Bearer <MERCHANT_ACCESS_TOKEN>
{ "reason": "customer_request", "amount": 18.75 }

# Standard error envelope
4xx { "error": { "code": "CHARGE_ALREADY_REFUNDED", "message": "..." } }

Marco regulatorio

Deuna Negocios opera en Ecuador bajo la supervisión de la Superintendencia de Bancos del Ecuador y trabaja en estrecha alianza con Banco Pichincha. A la fecha, la regulación formal de OpenFinance en el país aún está en construcción: la Junta de Política y Regulación Financiera y Monetaria, junto con el Banco Central del Ecuador, han ido emitiendo resoluciones que sientan las bases para el intercambio de datos financieros, mientras los operadores privados ya ofrecen integraciones con consentimiento del comercio. Toda integración que entregamos respeta la Ley Orgánica de Protección de Datos Personales (LOPDP) del Ecuador y se alinea con prácticas regionales de OpenFinance y con los principios popularizados por PSD2/PSD3 en Europa y por el Open Finance Brasil. Documentamos la base legal (consentimiento del comercio, necesidad contractual), las categorías de datos accedidas y la política de retención aplicada.

Salvaguardas operativas

Minimizamos datos, ciframos tokens en reposo, rotamos llaves, firmamos webhooks con HMAC y aislamos ambientes por tenant. La PII se separa de los campos transaccionales, los reembolsos se auditan de extremo a extremo y los logs de acceso se conservan por los plazos requeridos por el SRI y la Superintendencia. NDAs y DPAs disponibles a solicitud.

Checklist de entregables

• Especificación OpenAPI 3.1 / Swagger del conector Deuna Negocios
• Reporte de protocolo y autenticación (ciclo de vida de tokens, firma de webhooks, mapa de errores)
• Código fuente ejecutable (Python, Node.js o Go) para cobros, estado, reembolso y flujos de webhook
• Pruebas automatizadas, colección Postman y fixtures de sandbox
• Pack de cumplimiento: inventario de datos, notas LOPDP, plan de retención

Flujo de trabajo del engagement

1. Confirmación de alcance: escenarios de integración, lista de RUC, volumen esperado.
2. Análisis de protocolo y diseño de API (2–5 días hábiles).
3. Construcción y validación interna (3–8 días hábiles).
4. Documentos, ejemplos y casos de prueba (1–2 días hábiles).
5. Entrega típica inicial: 5–15 días hábiles, según complejidad.

Preguntas frecuentes

¿Qué necesitan de mí?

¿Cuánto tarda la entrega?

¿Cómo manejan el cumplimiento?