API Technical Docs

Mantente al día con las innovaciones tecnológicas que están transformando el mercado.

Qué es YUPY

YUPY es una plataforma de cobros y conciliación omnicanal para pagos mediante Yape, Plin y transferencias bancarias. Permite que una empresa reciba pagos desde WhatsApp, el chat propio de YUPY, otros canales conversacionales, una pasarela de pagos web, una tienda virtual, un sistema interno o un POS; después identifica a qué venta corresponde cada ingreso y actualiza los sistemas del negocio.

La propuesta central de YUPY: cobrar desde distintos canales, recibir el dinero directamente en la cuenta bancaria de la empresa y conciliar automáticamente cada pago con la venta u operación correspondiente.

El problema que resuelve

Recibir un pago no significa necesariamente saber a qué operación pertenece. Cuando una empresa cobra mediante Yape, Plin o transferencia bancaria, suele necesitar que una persona revise movimientos, mensajes, capturas y sistemas internos para responder preguntas como estas:

  • ¿Quién pagó?
  • ¿A qué pedido, venta, reserva o atención corresponde?
  • ¿El monto recibido coincide con el monto esperado?
  • ¿El pago llegó realmente a la cuenta?
  • ¿La venta ya puede continuar?
  • ¿Existe otro pago por el mismo monto que pueda generar confusión?

Sin una conciliación centralizada, esas preguntas producen trabajo manual para administración, ventas, operaciones, finanzas, contabilidad y atención al cliente.

Venta o pedido
      +
Pago recibido
      +
Información bancaria
      +
Reglas de conciliación
      =
Operación identificada y actualizada

Qué hace YUPY

YUPY incorpora una capa de control entre el sistema que origina la venta, la experiencia de pago y la cuenta bancaria de la empresa.

  1. Recibe o crea una orden de pago.
  2. Relaciona la orden con una venta, comprador, canal y monto esperado.
  3. Entrega la experiencia de pago en el canal correspondiente.
  4. Registra señales auxiliares, como el botón Ya pagué, mensajes o constancias.
  5. Obtiene movimientos de las cuentas bancarias autorizadas.
  6. Compara órdenes pendientes con movimientos recibidos.
  7. Detecta coincidencias, diferencias, ambigüedades, duplicados o pagos tardíos.
  8. Conciliada la operación, actualiza y notifica a los sistemas del negocio.
  9. Conserva evidencia y trazabilidad para revisión y reportes.

Medios de pago

La primera arquitectura de YUPY contempla tres familias principales:

Medio Uso Resultado esperado
Yape Pago mediante QR o transferencia desde la aplicación. Movimiento reflejado en la cuenta receptora de la empresa.
Plin Pago mediante QR o transferencia desde una aplicación afiliada. Movimiento reflejado en la cuenta receptora correspondiente.
Transferencia bancaria Transferencia entre cuentas del mismo banco o de bancos distintos. Movimiento bancario disponible para detección y conciliación.

La plataforma puede ampliarse a otros medios siempre que exista información suficiente para detectar el ingreso, identificarlo y relacionarlo con una operación.

Modalidades y canales de cobro

YUPY no está limitado a una sola interfaz. Una orden puede originarse y atenderse mediante distintas modalidades, manteniendo un mismo núcleo de conciliación.

POS vía chat

El POS vía chat es la modalidad conversacional de venta y cobro. Puede operar por WhatsApp, por el chat propio de YUPY o por otros chats y canales conversacionales. El canal transporta la conversación; la lógica de POS, identificación del vendedor, turno, orden y conciliación pertenece a YUPY.

  • WhatsApp: canal posible para conversar, entregar instrucciones y registrar acciones.
  • Chat propio de YUPY: interfaz conversacional administrada directamente por YUPY.
  • Otros chats: asistentes, bandejas de atención o plataformas conversacionales integradas mediante API, eventos o webhooks.

Pasarela o medio de pago web

Una web, tienda virtual o sistema de reservas puede ofrecer YUPY como alternativa de pago. La integración puede devolver una URL segura o abrir un componente de checkout administrado por YUPY.

Integración con un POS existente

Un POS físico o sistema de ventas existente puede crear una orden YUPY, mostrar o enviar la experiencia de pago y esperar la confirmación conciliada antes de cerrar la venta. Esta integración es distinta del POS vía chat: aquí YUPY se conecta con un sistema de punto de venta ya existente.

El dinero llega directamente a la empresa

El pagador transfiere hacia el QR o la cuenta bancaria de la empresa. YUPY no necesita recibir ni custodiar el dinero para después liquidarlo.

Pagador
   ↓
Yape, Plin o transferencia
   ↓
Cuenta bancaria de la empresa
   ↓
YUPY detecta, identifica y concilia

Este modelo evita una capa innecesaria de custodia y permite que el comercio conserve el control directo de sus fondos.

Conciliación: el núcleo de YUPY

Mostrar un QR o registrar que una persona dijo haber pagado no es suficiente. El valor principal de YUPY está en relacionar la evidencia bancaria con la operación comercial correcta.

Para hacerlo, el motor puede considerar:

  • monto y moneda;
  • fecha y hora;
  • cuenta receptora;
  • ventana de conciliación;
  • canal de origen;
  • comprador, vendedor, local o POS;
  • órdenes simultáneas por el mismo monto;
  • movimientos ya utilizados;
  • reportes y constancias como señales auxiliares.

Cuando no existe una coincidencia suficientemente clara, YUPY debe marcar la operación como ambigua o pendiente de revisión en vez de asignar el dinero arbitrariamente.

Tres hechos diferentes

El usuario informó que pagó

El comprador presionó Ya pagué, envió un mensaje o compartió una constancia. Esto ayuda a priorizar la búsqueda, pero todavía no confirma el ingreso.

El movimiento fue detectado

YUPY encontró un movimiento bancario potencialmente relacionado. Todavía puede necesitar evaluar monto, tiempo, duplicados y otras operaciones similares.

El pago fue conciliado

YUPY pudo relacionar el movimiento con la orden correcta usando evidencia suficiente. Este es el hecho que permite confirmar el pago al sistema comercial.

“Ya pagué”             ≠ pago confirmado
Captura o constancia   ≠ pago confirmado
Movimiento detectado   ≠ necesariamente conciliado
Movimiento conciliado  = pago confirmado por YUPY

Ahorro operativo

YUPY busca reducir tareas repetitivas que hoy consumen horas de diferentes equipos.

Área Trabajo manual habitual Aporte de YUPY
Ventas Preguntar si el pago llegó y coordinar con administración. Recibir el estado conciliado dentro del mismo flujo comercial.
Administración Revisar cuentas, capturas, montos y pedidos uno por uno. Automatizar coincidencias y concentrar excepciones.
Operaciones Esperar confirmaciones antes de liberar una reserva, entrega o servicio. Continuar automáticamente cuando el pago se concilia.
Finanzas y contabilidad Reconstruir la relación entre ingresos y ventas. Conservar correlación, evidencia y reportes estructurados.
Atención al cliente Investigar pagos no identificados o montos diferentes. Consultar el historial completo de la operación.

Menor costo total

YUPY está diseñado para ser significativamente más económico que muchas alternativas existentes, no solo por la tarifa tecnológica, sino por el costo operativo que elimina.

El costo total de un cobro incluye:

  • comisiones o cargos de la solución;
  • horas de administración y ventas;
  • revisión manual de pagos;
  • errores de identificación;
  • demoras en la confirmación;
  • trabajo de soporte y reclamos;
  • tiempo de cierre y elaboración de reportes.

La ventaja económica de YUPY combina un modelo de menor costo con el ahorro de trabajo administrativo, comercial y operativo. El dinero, además, llega directamente a la cuenta de la empresa.

Qué no es YUPY

  • No reemplaza a Yape, Plin ni al banco.
  • No necesita custodiar el dinero de la empresa.
  • No confirma pagos únicamente por una captura o declaración del usuario.
  • No debe conciliar arbitrariamente operaciones ambiguas.
  • No es solamente un generador de QR.

Resumen

Orden comercial
   → experiencia omnicanal de pago
   → ingreso directo a la cuenta de la empresa
   → detección bancaria
   → conciliación
   → actualización de ventas, administración y operaciones

YUPY convierte cobros dispersos en operaciones identificadas, conciliadas y listas para continuar dentro del negocio.