Modo de prueba

Selgeo proporciona un entorno de prueba completo para que pueda verificar su integración de extremo a extremo sin procesar pagos reales ni enviar correos electrónicos a socios reales. Todas las funciones del modo de prueba usan API versión v1.

Comparación prueba vs. live

Aspecto	Modo de prueba	Modo live
Claves API	`pk_test_`, `sk_test_`	`pk_live_`, `sk_live_`
Datos	Completamente aislados: los datos de prueba nunca aparecen en los informes live	Datos de producción
Stripe	Se conecta al entorno de prueba de Stripe	Se conecta al entorno live de Stripe
Correos electrónicos	Suprimidos: no se envía ningún correo a socios ni comerciantes	Se entregan normalmente
Webhooks	Entregados a puntos de conexión de modo de prueba (se requiere HTTPS)	Entregados a puntos de conexión de modo live (se requiere HTTPS)
Límites de tasa	Límites idénticos en ambos modos	Límites idénticos en ambos modos
Detección de fraude	Activa: las mismas reglas que en modo live	Activa
Borrado RGPD	Totalmente funcional	Totalmente funcional

Aislamiento de datos

Los modos de prueba y live están totalmente separados. Los socios, clics, conversiones, comisiones y puntos de conexión webhook creados en modo de prueba son invisibles en modo live, y viceversa. Puede ejecutar escenarios de prueba con total libertad sin afectar a los datos de producción.

Obtener sus claves de prueba

Inicie sesión en el panel de control de comerciante de Selgeo.
Vaya a Configuración > Claves API.
Su clave pública de prueba (pk_test_*) se muestra junto a la de live. Pulse Generar clave secreta en el modo Test para emitir sk_test_*: las claves secretas se crean cuando las necesita, no de antemano.

Ciclo de prueba paso a paso

Siga esta guía para verificar el flujo de atribución completo: clic, atribución, conversión y comisión.

Paso 1 — Instalar el snippet con su clave pública de prueba

Añada el snippet de seguimiento de Selgeo a una página de prueba de su sitio (o a un entorno de desarrollo local). Use su clave pública de prueba:

<script
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
  async
></script>

Paso 2 — Crear un socio de prueba

En el panel de control, cree un programa de prueba (o use uno existente) y apruebe a un socio de prueba. Los enlaces de referencia los crean los socios en el portal de socios: inicie sesión como el socio de prueba, abra Enlaces y cree un enlace. Copie su URL. Tendrá un aspecto similar a este:

https://susitio.com/?ref=abc123

Paso 3 — Simular un clic

Abra el enlace de referencia en su navegador. El snippet de Selgeo captura el clic y crea una atribución pendiente. Puede verificarlo en el panel de control, en Analytics > Clics.

El snippet almacena un click_id que vincula a este visitante con el socio que lo refirió.

Paso 4 — Reportar una conversión de prueba

Tras el clic simulado, active una conversión. El método depende de su integración:

Stripe Checkout
API de conversión

Complete un pago de prueba de Stripe usando una tarjeta de prueba de Stripe (p. ej., 4242 4242 4242 4242). Selgeo recibe el webhook de Stripe y crea la conversión automáticamente.

Envíe una conversión directamente a través de la API usando su clave secreta de prueba:

curl -X POST https://app.selgeo.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "EL_CLICK_ID_DEL_PASO_3",
    "event_type": "purchase",
    "external_transaction_id": "test_txn_001",
    "amount_cents": 9900,
    "currency": "EUR"
  }'

Paso 5 — Verificar la conversión y la comisión

Vaya a la página Analytics en el panel de control. Debería ver la conversión registrada.
Navegue a Comisiones. Se debería haber calculado una comisión según las reglas de comisión de su programa.
Si sus reglas de comisión incluyen un periodo de retención, la comisión estará en estado pending. Se aprobará automáticamente cuando finalice el periodo de retención.

Paso 6 — Probar webhooks

Si tiene puntos de conexión webhook registrados en modo de prueba, consulte el registro de entregas en Configuración > Webhooks. Debería ver entregas para los eventos conversion.created y commission.created.

Los puntos de conexión webhook deben usar HTTPS y ser accesibles públicamente, también en modo de prueba. Para el desarrollo local, exponga su servidor local a través de un túnel como ngrok y registre la URL HTTPS del túnel (p. ej., https://your-tunnel.ngrok.app/webhooks/selgeo).

Entorno de prueba de Stripe

Selgeo se conecta a su entorno de prueba de Stripe cuando funciona en modo de prueba. Esto significa que:

Los números de tarjeta de prueba funcionan como se espera (p. ej., 4242 4242 4242 4242 para un cargo con éxito)
Los reembolsos de prueba activan eventos commission.refunded
Las suscripciones de prueba generan eventos de conversión recurrentes
Los webhooks de Stripe de su entorno de prueba se procesan y atribuyen normalmente

Cuando conecta su clave restringida de modo de prueba de Stripe en Configuración > Stripe, Selgeo registra automáticamente el punto de conexión del webhook de prueba: no necesita copiar ninguna URL de webhook en Stripe manualmente. Asegúrese de que la clave restringida incluya el permiso webhook_endpoints:write.

Números de tarjeta de prueba de Stripe

Número de tarjeta	Comportamiento
`4242 4242 4242 4242`	Tiene éxito
`4000 0000 0000 3220`	Requiere autenticación 3D Secure
`4000 0000 0000 0002`	Rechazada (card_declined)

Consulte la documentación de pruebas de Stripe para ver la lista completa.

Restablecer datos de prueba

Cuando quiera empezar de cero, use el botón Restablecer datos de prueba en el panel de control de Selgeo (página Configuración, modo de prueba). Esto elimina todos los datos del modo de prueba de su espacio de trabajo en una sola acción:

Socios y participantes
Clics y eventos de atribución
Conversiones y comisiones
Registros de entrega de webhooks
Registros de notificaciones

También puede restablecerlos mediante programación a través de la API:

curl -X DELETE https://app.selgeo.com/api/v1/workspace/test-data \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

aviso

Esta acción es irreversible. Todos los datos del modo de prueba se eliminarán permanentemente.

Consejos

Restablezca los datos de prueba con regularidad. Use el botón de restablecimiento o el punto de conexión de la API anterior para empezar de cero en lugar de limpiar manualmente registros individuales.
Pruebe los webhooks pronto. Configure los puntos de conexión webhook en modo de prueba antes de pasar a producción. Verifique que su servidor gestiona todos los tipos de evento que necesita.
Pruebe los casos límite. Pruebe escenarios como ventanas de atribución expiradas, conversiones duplicadas, reembolsos y socios suspendidos para asegurarse de que su integración los gestiona correctamente.
Compruebe la supresión de correos. Recuerde que en modo de prueba no se envía ningún correo. Si necesita verificar qué notificaciones se habrían enviado, consulte el registro de notificaciones de prueba integrado en la aplicación (la bandeja de pruebas) en el panel de control.
Cuando esté listo, siga la Lista de verificación de puesta en producción para pasar a producción.

Comparación prueba vs. live​

Obtener sus claves de prueba​

Ciclo de prueba paso a paso​

Paso 1 — Instalar el snippet con su clave pública de prueba​

Paso 2 — Crear un socio de prueba​

Paso 3 — Simular un clic​

Paso 4 — Reportar una conversión de prueba​

Paso 5 — Verificar la conversión y la comisión​

Paso 6 — Probar webhooks​

Entorno de prueba de Stripe​

Números de tarjeta de prueba de Stripe​

Restablecer datos de prueba​

Consejos​