Lista de verificación de puesta en producción
Siga esta lista de verificación cuando esté listo para pasar del modo de prueba al modo live. Complete cada elemento antes de habilitar su programa para socios y clientes reales. Todos los puntos de conexión hacen referencia a API versión v1.
1. Reemplazar claves de prueba por claves live
| Reemplazar | Con |
|---|---|
pk_test_* (en el snippet de seguimiento) | pk_live_* |
sk_test_* (en código del lado del servidor / variables de entorno) | sk_live_* |
Dónde verificar:
- Atributo
data-merchantdel snippet de seguimiento en su HTML/template - Variables de entorno del lado del servidor para la API de conversión
- Secretos del pipeline CI/CD o configuración de despliegue
- Cualquier script o trabajo cron que llame a la API de Selgeo
peligro
Nunca confirme claves secretas live (sk_live_*) en el control de versiones. Use variables de entorno o un gestor de secretos.
2. Verificar la conexión live de Stripe
- En el panel de control de Selgeo, vaya a Configuración > Stripe.
- Confirme que su cuenta de Stripe live está conectada.
- Verifique que los siguientes eventos estén habilitados en su webhook de Stripe:
checkout.session.completedinvoice.paidcharge.refunded
3. Eliminar datos de prueba
- Eliminar socios de prueba que no deban transferirse
- Archivar o eliminar programas de prueba
- Borrar puntos de conexión webhook de prueba que apunten a localhost
4. Verificar puntos de conexión webhook
- Vaya a Configuración > Webhooks en el panel de control.
- Cree (o verifique) sus puntos de conexión webhook en modo live. Los puntos de conexión live deben usar HTTPS.
- Suscríbase a los eventos que necesita su aplicación.
- Haga clic en Enviar ping de prueba para cada punto de conexión.
- Guarde el secreto de firma (
whsec_...) de forma segura. - Verifique que su servidor valida correctamente las firmas de webhook.
5. Revisar límites de tasa
| Zona | Límite |
|---|---|
Seguimiento (POST /v1/clicks) | 1.000 sol./min por clave pk_* |
API de conversión (POST /api/v1/conversions) | 120 sol./min por clave sk_* |
| API general | 300 sol./min por dirección IP |
6. Revisar reglas de comisión
Vaya a Programas > [Su Programa] > Reglas de comisión y verifique que los porcentajes, montos fijos, períodos de retención y configuraciones de aprobación automática son correctos para producción.
7. Probar el flujo completo una vez más
- Abra su enlace de referido en un navegador.
- Complete una compra real (puede reembolsarla después).
- Verifique que el clic, la conversión y la comisión aparecen en el panel de control.
- Verifique que los eventos webhook se entregaron a sus puntos de conexión.
- Reembolse la transacción en Stripe y confirme que el evento
commission.refundedse activa.
8. Activar su programa
- Establezca el estado de su programa en Activo en el panel de control.
- Comparta los enlaces de invitación al programa con sus socios.
- Monitoree el panel de control para los primeros registros de socios y conversiones.
Monitoreo post-lanzamiento
- Registro de entrega de webhooks — verifique las entregas fallidas o dead-letter
- Registro de auditoría de atribución — revise las decisiones de atribución
- Alertas de fraude — monitoree los eventos
conversion.fraud_detected - Cola de revisión de comisiones — apruebe o rechace las comisiones que requieren revisión manual