API Technical Docs

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

Perfil de cobro, QR y transferencia

Estado documental: Propuesto. Este documento define el perfil principal de cobro de la empresa y las dos opciones de pago documentadas para POS vía chat.

Perfil principal de cobro

Por lo general, cada empresa opera con un perfil principal de cobro.

YUPY configura ese perfil durante el setup inicial junto con la empresa.

Posteriormente, la empresa puede modificarlo desde su consola, de acuerdo con sus permisos y conservando auditoría.

El perfil reúne:

  • QR autorizado de Yape y/o Plin;
  • cuenta bancaria o CCI cuando la transferencia esté habilitada;
  • nombre receptor;
  • moneda;
  • instrucciones;
  • presentación básica;
  • reglas operativas acordadas.

Opciones disponibles

1. QR

La empresa puede habilitar:

  • Yape;
  • Plin;
  • ambos, cuando corresponda.

2. Transferencia bancaria

La empresa puede habilitar:

  • número de cuenta;
  • CCI;
  • banco;
  • moneda;
  • nombre del receptor;
  • instrucciones.

La documentación formal no presupone pools, rotaciones ni perfiles múltiples como funcionamiento ordinario.

Configuración inicial

Durante el setup, YUPY y la empresa definen:

  • qué opción u opciones se muestran;
  • datos receptores;
  • nombre visible;
  • instrucciones;
  • vigencias y reglas aplicables;
  • responsables para cambios posteriores.

Cambios posteriores

La empresa puede actualizar su perfil desde consola cuando tenga los permisos necesarios.

Todo cambio sensible debe registrar:

  • usuario responsable;
  • fecha y hora;
  • valor anterior;
  • valor nuevo;
  • activación;
  • desactivación;
  • motivo u observación cuando corresponda.

Selección de la opción

El flujo configurado determina si se presenta:

  • solo QR;
  • solo transferencia;
  • ambas alternativas.

El vendedor no debe sustituir manualmente el QR, la cuenta ni el receptor por datos no autorizados.

Información mostrada

La experiencia debe mostrar:

  • monto;
  • moneda;
  • QR o datos bancarios;
  • nombre receptor;
  • instrucciones;
  • código de transacción;
  • estado operativo.

Instrucciones para QR recibido en el mismo teléfono

Cuando el comprador recibe el QR en el dispositivo desde el cual pagará, YUPY puede mostrar:

Guarda o descarga el QR.
Abre Yape o Plin.
Elige leer un QR desde una imagen.
Selecciona el archivo.
Verifica monto y receptor.

Instrucciones para transferencia

La presentación puede incluir:

Banco
Tipo de cuenta
Número de cuenta
CCI
Titular
Moneda
Monto
Código de transacción

El comprador debe utilizar exactamente el monto indicado y verificar al receptor.

Captura o fotografía de la constancia

Después del pago, el vendedor puede:

  • recibir la captura del comprador;
  • tomar una fotografía de la pantalla del teléfono;
  • adjuntar una constancia de transferencia o depósito.

YUPY procesa la imagen mediante OCR, la vincula con la transacción y registra la señal equivalente a “Ya pagó”.

La evidencia visual complementa la conciliación; no reemplaza el movimiento financiero.

Validación del perfil

Antes de presentar los datos, YUPY debe comprobar:

  • que el perfil pertenezca a la empresa;
  • que esté activo;
  • que la opción se encuentre habilitada;
  • que la moneda corresponda;
  • que los datos obligatorios estén completos;
  • que la transacción pertenezca al turno y dispositivo indicados.

Trazabilidad histórica

Cada transacción conserva la referencia de los datos de cobro que se utilizaron al crearla.

Un cambio posterior del perfil no debe alterar retrospectivamente una operación anterior.

Criterios de aceptación

  1. Existe un perfil principal por empresa como configuración ordinaria.
  2. YUPY configura el perfil durante el setup.
  3. La empresa puede modificarlo posteriormente con permisos.
  4. Las opciones formales son QR y transferencia bancaria.
  5. El vendedor no reemplaza los datos receptores.
  6. Las instrucciones muestran monto y receptor.
  7. El QR recibido en el mismo teléfono incluye instrucciones de uso.
  8. La constancia puede enviarse como captura o fotografía.
  9. OCR vincula la evidencia con la transacción.
  10. Los cambios del perfil conservan auditoría e historia.