Qué necesita antes de empezar

Una cuenta activa en Yappy Comercial.

Permisos de administrador en esa cuenta, para poder generar credenciales.

Acceso al módulo de Facturación en Wispro, para crear pasarelas de pago.

La configuración tiene dos mitades. Primero genera dos juegos de credenciales en Yappy Comercial —uno del Botón de Pago y otro de Integración API—, y después los carga en Wispro.

🚧
Yappy entrega dos claves secretas distintas
Una pertenece al Botón de Pago y otra a la Integración API. No son intercambiables y no se pueden volver a consultar después de generarlas.
Al copiarlas, anote de cuál de las dos pantallas salió cada una. Es el error más frecuente en esta integración.

1- Configurar el Botón de Pago en Yappy

Ingrese a Yappy Comercial con su usuario administrador.
En el menú lateral izquierdo, vaya a Métodos de cobro > Botón de Pago Yappy.
En «¿En qué plataforma está construida tu página web?», elija WooCommerce o una plataforma de desarrollo propio.
Complete los datos solicitados:
- Nombre del botón de pago.
- Dirección del sitio web (URL) del comercio.
- Cuenta bancaria donde recibirá los pagos.
- Correo electrónico de contacto y confirmación.
Haga clic en Activar.

El botón queda en estado Pendiente: todavía falta generar la clave secreta.

Haga clic en Generar clave secreta y confirme con Generar.

Yappy le mostrará dos valores:

ID de comercio
Clave secreta (la del Botón de Pago)

Anote también la URL exactamente como la cargó
La dirección del sitio web que registró en este paso debe coincidir carácter por carácter con la que va a cargar después en Wispro. Wispro la envía a Yappy para validar la pasarela: si difiere, la verificación falla.

2- Generar las credenciales de Integración API

En el menú lateral de Yappy, seleccione Integraciones.
Haga clic en Generar credenciales y confirme con Sí, generar.

❗️
Generar credenciales nuevas rompe la conexión existente
Si ya había generado estas credenciales antes —por ejemplo, para otra integración— al generar unas nuevas la conexión anterior deja de funcionar.
Si ya tiene Yappy vinculado a Wispro y vuelve a generarlas, deberá cargar las nuevas en la pasarela.

Yappy le mostrará tres valores:
- Código de semilla
- Clave secreta (la de Integraciones)
- API Key
Copie cada valor con el ícono correspondiente y guárdelos en un lugar seguro.

3- Crear la pasarela en Wispro

Ingrese a Facturación > Parámetros > Pasarelas de pago.
Haga clic en Crear nueva pasarela de pago.
Seleccione Yappy.
Escriba un Nombre para identificar la pasarela dentro de Wispro.
Complete los dos bloques de credenciales según la tabla de abajo.

Qué valor va en cada campo

Bloque en Wispro	Campo en Wispro	Valor que debe pegar
Botón de pago	Clave API	La Clave secreta del Botón de Pago (paso 1)
Botón de pago	ID comercio	El ID de comercio (paso 1)
Botón de pago	Sitio web	La URL del sitio web registrada en el Botón de Pago (paso 1)
Integración API	Api Key	La API Key de Integraciones (paso 2)
Integración API	Código semilla	El Código de semilla de Integraciones (paso 2)
Integración API	Clave secreta	La Clave secreta de Integraciones (paso 2)

❗️
"Clave API" no es la API Key
A pesar del nombre, el campo Clave API del bloque Botón de pago espera la Clave secreta que generó en el Botón de Pago.
La API Key de Yappy va en el campo Api Key del bloque Integración API. Si los invierte, la pasarela puede verificarse igual pero los pagos de sus clientes no se registrarán.

Los seis campos son obligatorios. Haga clic en Crear.

Cada credencial se puede usar una sola vez
Wispro no admite dos pasarelas Yappy con el mismo ID de comercio, el mismo sitio web, la misma semilla, la misma API Key ni la misma clave secreta de integración. Si recibe un error de dato repetido, revise si ya existe otra pasarela Yappy creada en su cuenta.

4- Verificar la pasarela

Crear la pasarela no la deja operativa. Hay que verificarla.

En el listado de Pasarelas de pago, use la acción Verificar sobre la pasarela Yappy recién creada. Wispro se conecta a Yappy y comprueba los dos juegos de credenciales por separado.

Mensaje	Qué revisar
Claves de botón inválidas	El ID comercio y el Sitio web. La URL debe coincidir exactamente con la registrada en el Botón de Pago.
Claves de integración inválidas	La Api Key, el Código semilla y la Clave secreta del bloque Integración API.

🚧
Al verificarse, las credenciales quedan bloqueadas
Una vez verificada la pasarela, los seis campos pasan a ser de solo lectura y no se pueden editar. Revise cada valor antes de verificar.

El campo "Clave API" no se comprueba en la verificación
La verificación valida el ID de comercio, el sitio web y las tres credenciales de integración, pero no la Clave API del Botón de Pago. Ese valor recién se usa cuando Yappy le avisa a Wispro que un cliente pagó.
Por eso es posible que la pasarela quede verificada y, aun así, los pagos no se registren solos. Si le pasa eso, ese es el campo a revisar.

5- Asignar la pasarela a sus clientes

Diríjase al apartado Clientes.
Edite el cliente correspondiente.
En la pestaña Pasarelas de pago, seleccione Yappy.

📘
Asignación masiva
Puede vincular Yappy a todos sus clientes de una vez siguiendo Actualización masiva de clientes.

6- Cómo paga el cliente

Yappy solo opera sobre facturas ya emitidas. Las prefacturas o borradores no se pueden pagar por esta vía.

El cliente abre Alerta Internet y elige pagar con Yappy.
Ingresa su Número de teléfono, que es su alias de Yappy.
Wispro genera la orden y le indica: "Ingrese a Yappy ahora y confirme el pago. Tiene 5 minutos."
El cliente abre su app de Yappy y confirma la operación.
Yappy le avisa a Wispro y el pago se registra automáticamente sobre la factura.

🚧
El intento vence a los 5 minutos
Si el cliente no confirma dentro de ese lapso, la operación queda sin efecto y debe iniciarla de nuevo desde la aplicación.

Qué puede pasar con una operación

Resultado	Qué significa
El pago fue realizado / El pago fue aprobado	La operación se completó y el pago se registra en Wispro.
El usuario no completó el proceso de pago todavía	El cliente inició la operación pero aún no la confirmó.
El cliente no confirmó dentro de los 5 minutos	El intento venció.
El pago fue rechazado	Yappy rechazó la operación.
El pago fue anulado	La operación se revirtió del lado de Yappy.
Hubo un error en el pago	Falla en el procesamiento.

El pago se registra por el monto bruto
Wispro registra el importe completo que pagó el cliente. La comisión que retiene Yappy queda guardada en el detalle de la transacción, y puede consultarla al buscar la transacción.

7- Buscar una transacción y registrar el pago

El registro automático depende de que Yappy le notifique a Wispro cada pago. No hay un proceso que reintente esa notificación más tarde, así que si la comunicación se interrumpe, el pago queda hecho en Yappy pero no aparece en Wispro.

Para esos casos, la pasarela incluye una búsqueda manual de transacciones.

Ingrese a Facturación > Parámetros > Pasarelas de pago.
Sobre la pasarela Yappy, haga clic en el ícono de lupa.
Ingrese el número de transacción que le proporcionó Yappy.
Wispro consulta la operación en Yappy y le muestra el número de transacción, el valor, la fecha de pago, el método de pago y la comisión.
Si la operación existe y fue aprobada, puede registrarla en Wispro desde esa misma ventana. Al terminar verá el mensaje "Transacción procesada en Wispro".

La lupa aparece solo en pasarelas verificadas
Si no la ve, revise que la pasarela esté verificada.

Mensajes que puede recibir

Mensaje	Qué significa
Ya se generó un pago para este número de transacción	Esa operación ya está registrada en Wispro. Al mostrarla verá también el ID del pago.
Transacción no encontrada	Yappy no reconoce ese número. Verifique que lo haya copiado completo.
El número de transacción no puede estar en blanco	Falta completar el campo.
Credenciales inválidas	Wispro no pudo autenticarse contra Yappy. Revise las credenciales de Integración API.

¿Consultas?

Contáctenos al chat de Soporte, desde el botón (?)