Qué hace
Ualá Bis permite ofrecer cobro online desde el checkout. Structura inicia el flujo y necesita recibir el resultado para actualizar el estado del pago.
Antes de configurar
Necesitás una cuenta de Ualá Bis habilitada para el producto que vas a integrar y las credenciales correspondientes al ambiente que vas a utilizar.
No mezcles credenciales de STAGE con producción. Una prueba técnicamente exitosa en STAGE no demuestra que producción esté configurada.
Configuración
La configuración se realiza desde Configuración → Pagos seleccionando Ualá Bis.
La pantalla solicita las credenciales del proveedor que corresponden al ambiente seleccionado por la integración. Esas credenciales deben provenir del panel de desarrolladores/comercios de Ualá Bis y mantenerse como secretos del tenant.
Reglas de los campos
- Las credenciales son valores sensibles y no deben copiarse a la tienda pública.
- El ambiente de prueba y el de producción son conjuntos de credenciales distintos.
- Un campo vacío/incompleto impide considerar el proveedor correctamente configurado.
- Guardar credenciales no equivale necesariamente a haber ejecutado un pago real.
Cuando el runtime indique que faltan datos, completá los valores en el formulario de configuración en lugar de intentar forzar el checkout.
Guardar y activar
Primero guardá la configuración. Después verificá que el proveedor figure como configurado/activo en el centro de pagos.
Si el proveedor aparece visible pero no puede seleccionarse para un cobro, separá tres condiciones: plan/capability, configuración y estado operativo.
Flujo de checkout
Cliente → checkout Structura → inicio de pago Ualá Bis → autorización/rechazo → retorno/webhook → actualización del pago en Structura → pedido refleja el estado correspondiente.
El retorno del navegador no es por sí solo prueba suficiente de cobro confirmado cuando el proveedor trabaja de forma asincrónica.
Prueba correcta
- Usá STAGE cuando estés probando integración.
- Creá una compra de prueba.
- Seleccioná Ualá Bis.
- Completá el flujo del proveedor.
- Volvé a Structura.
- Revisá Pagos → Transacciones.
- Revisá el pedido y su estado de pago.
- Confirmá que no quedó solamente como
pendingsi esperabas aprobación.
Estados y diagnóstico
Pendiente: no lo marques como cobrado. Verificá si falta confirmación del proveedor/webhook.
Rechazado: revisá la respuesta del proveedor y los datos de la operación antes de reintentar.
Aprobado en Ualá pero pendiente en Structura: el problema debe diagnosticarse en retorno/webhook/actualización del pago, no creando otro pedido.
No aparece Ualá como medio: revisá capability/plan y configuración.
Credenciales inválidas: confirmá ambiente y valores emitidos por Ualá.
Seguridad
Nunca publiques secretos de Ualá en frontend, repositorio, capturas del Help o tickets públicos. El Help describe el procedimiento, no expone credenciales reales.
Documentación oficial
Consultá la documentación oficial de Ualá Bis para obtener credenciales, endpoints, checkout y requisitos del ambiente utilizado.