Al finalizar esta guía tendrás la llave pública, llave privada, secreto de eventos, secreto de integridad y URL de Eventos listos para conectar Wompi en Brain Studio.
Antes de comenzar
Necesitas:- Una cuenta activa de Wompi
- Acceso al dashboard de Wompi con permisos para ver credenciales técnicas
- Permisos para configurar la URL de Eventos
- Definir si conectarás credenciales de Sandbox o de Producción
Ambientes en Wompi
Wompi separa las credenciales por ambiente:- Sandbox: ambiente de pruebas. Permite simular pagos sin mover dinero real.
- Producción: ambiente real. Procesa transacciones con dinero real.
Parte 1 — Preparar credenciales Sandbox
En Desarrollo → Programadores encontrarás las credenciales técnicas del ambiente de pruebas y el campo URL de Eventos. Usa esta sección para copiar las llaves y secretos Sandbox, y para guardar la URL donde Wompi notificará los cambios de estado de las transacciones.
Wompi Dashboard (Sandbox): llaves y secretos técnicos del comercio
1
Entrar al dashboard de Wompi
Inicia sesión en el dashboard de Wompi con la cuenta del comercio.
2
Confirmar modo de pruebas
Verifica que el modo de pruebas esté activo. En el dashboard deberías ver una indicación de Sandbox o modo de pruebas.Solo continúa si las credenciales muestran prefijos de prueba:
pub_test_, prv_test_, test_events_ y test_integrity_.3
Abrir Desarrollo → Programadores
En el menú lateral, abre Desarrollo y luego Programadores.
4
Copiar llaves y secretos Sandbox
En Llaves del API para integración técnica, copia la Llave pública y la Llave privada.En Secretos para integración técnica, copia Eventos e Integridad.
5
Configurar URL de Eventos
En Seguimiento de transacciones, pega exactamente esta URL:Luego haz clic en Guardar.
6
Confirmar configuración Sandbox
Verifica que la URL de Eventos conserve la URL de Jelou después de guardar y que las credenciales copiadas sean todas de Sandbox.
Si la URL de eventos queda guardada en Wompi, Brain Studio podrá recibir actualizaciones de estado de las transacciones.
Parte 2 — Preparar credenciales de Producción
Las credenciales de Producción se preparan en la misma pantalla Desarrollo → Programadores. Confirma que el modo de pruebas esté desactivado antes de copiar las llaves y secretos. En este ambiente también debes guardar la URL de Eventos, para que Brain Studio reciba los cambios de estado de pagos reales.
Wompi Dashboard (Producción): llaves y secretos técnicos del comercio
1
Desactivar modo de pruebas
En el dashboard de Wompi, desactiva el modo de pruebas para volver al ambiente de Producción.
2
Abrir Desarrollo → Programadores
En el menú lateral, abre Desarrollo y luego Programadores.
3
Copiar llaves y secretos productivos
Copia las credenciales del ambiente productivo y verifica que todos los valores usen estos prefijos:
- Llave pública (
pub_prod_...) - Llave privada (
prv_prod_...) - Eventos (
prod_events_...) - Integridad (
prod_integrity_...)
4
Configurar URL de Eventos en Producción
En Seguimiento de transacciones, confirma que la URL de Eventos esté guardada con:Si no está configurada, pégala y haz clic en Guardar.
5
Usar credenciales productivas en Brain Studio
Cuando pases Wompi a producción en Brain Studio, usa este set productivo completo. No reutilices credenciales Sandbox.
Usar credenciales en Brain Studio
Al instalar Wompi, Brain Studio solicita:- Llave pública
- Llave privada
- Secreto de eventos
- Integridad
- IVA aplicado
Validar credenciales por ambiente
Antes de pegar credenciales en Brain Studio, revisa los prefijos para confirmar que todos los valores pertenecen al mismo ambiente.Credenciales Sandbox
Credenciales Sandbox
Prefijos que verás en el dashboard para el ambiente de pruebas:
pub_test_...prv_test_...test_events_...test_integrity_...
Credenciales de Producción
Credenciales de Producción
Prefijos que verás en el dashboard para el ambiente real:
pub_prod_...prv_prod_...prod_events_...prod_integrity_...
Resolución de problemas
¿Cómo pruebo un pago con credenciales Sandbox?
¿Cómo pruebo un pago con credenciales Sandbox?
Para probar pagos con credenciales Sandbox, usa los datos de prueba publicados por Wompi para tarjetas, Nequi, PSE y otros medios disponibles en el checkout.El paso completo está documentado en Uso y configuración.
No encuentro las credenciales técnicas
No encuentro las credenciales técnicas
Verifica que estés en el dashboard correcto de Wompi y que tu usuario tenga permisos para acceder a Desarrollo → Programadores.Si no ves las llaves o secretos, solicita acceso al administrador de la cuenta Wompi.
Brain Studio no acepta las credenciales
Brain Studio no acepta las credenciales
Revisa que hayas copiado los valores completos y que todos correspondan al mismo ambiente.No mezcles, por ejemplo, una llave
pub_test_... con un secreto prod_events_....El flujo no avanza después del pago
El flujo no avanza después del pago
Verifica que la URL de Eventos esté configurada exactamente como:También confirma que estés usando las credenciales del mismo ambiente que configuraste en Brain Studio.
Estoy probando en Sandbox y quiero pasar a producción
Estoy probando en Sandbox y quiero pasar a producción
Debes usar credenciales productivas:
pub_prod_...prv_prod_...prod_events_...prod_integrity_...
Buenas prácticas
No mezclar ambientes
No mezclar ambientes
Mantén separadas las credenciales Sandbox y Producción. Usa siempre llaves y secretos del mismo ambiente.
Proteger secretos
Proteger secretos
No compartas la llave privada, el secreto de eventos ni el secreto de integridad en canales inseguros.Si sospechas exposición, rota las credenciales desde Wompi y actualiza la instalación en Brain Studio.
Validar eventos antes de producción
Validar eventos antes de producción
Antes de operar con pagos reales, confirma que Wompi pueda enviar eventos a la URL configurada y que el flujo en Brain Studio avance por las salidas esperadas.
Próximo paso
Conectar en Brain Studio
Instala Wompi usando las credenciales del ambiente que vas a usar y define el IVA aplicado para la integración.