Resumen de la integración
La integración con el Sistema de Afiliados tiene tres partes:
- Login — tu backend se autentica y recibe un access token.
- Webhooks — tu plataforma expone dos endpoints (depósitos y retiros) que nosotros llamamos para notificarte de las transacciones.
- Launch — incrustas el sistema de afiliados en un iframe usando el token.
El orden importa
El problema de integración más común surge de hacer estos pasos en el orden equivocado. Los webhooks van primero; el lanzamiento del sistema se desbloquea solo después de que tus webhooks pasen nuestra QA.
Recibir un 403 al abrir el sistema es lo esperado
Antes de que tus webhooks pasen la QA, abrir el sistema de afiliados (el iframe) devuelve 403. Esto es correcto, no es un error. Tu login sigue funcionando desde el inicio — devuelve un token válido de inmediato, así que puedes desarrollar y probar el login mientras la QA está pendiente. Solo el lanzamiento del iframe está bloqueado. Una vez que tus webhooks pasan la QA, el lanzamiento se habilita y devuelve 200.
Los pasos
- Revisa la estructura de las notificaciones en esta documentación — los payloads que enviamos para depósitos y retiros, y la respuesta que esperamos de tus endpoints.
- Implementa tus dos endpoints de webhook (depósitos y retiros) y valida la firma, usando esa estructura documentada. No se necesitan credenciales para este paso.
- Quedas registrado y recibes tus credenciales de staging. Una vez que tus endpoints estén listos, comparte tus endpoints con tu contacto en Apuestería; ellos te registran y te entregan tus credenciales de staging por un enlace de un solo uso. Desde este punto tu login funciona y devuelve un token válido de inmediato.
- Corremos la QA de webhooks contra tus endpoints reales.
- El lanzamiento del sistema se habilita en staging una vez que la QA pasa.
- Salida a producción — emitimos tus credenciales de producción y la URL de producción.