Configurar URLs de callback de miembros externos
Las áreas de miembros externas dependen de una URL de callback o integración para que AtomicPay indique a la plataforma externa cuándo crear acceso. Esto es diferente de la entrega por link, donde los compradores abren URLs manualmente, y diferente de la entrega y acceso de miembros nativa cuando esa ruta está disponible para el tipo de producto.
Usa la entrega por callback cuando la experiencia del comprador vive en MemberKit u otra plataforma de miembros externa y el acceso debe crearse automáticamente después de una venta aprobada.
Cuándo encaja la entrega por callback
| Usa URLs de callback cuando | Usa otro método cuando |
|---|---|
| El acceso debe crearse en una plataforma de miembros externa | Los compradores solo necesitan URLs estáticas. Consulta entrega por link. |
| Ya tienes documentación de integración específica de la plataforma | El producto es un ebook descargable. Consulta entrega de ebook. |
| El cumplimiento manual es demasiado lento para el volumen de lanzamiento | MemberKit tiene una ruta de configuración dedicada. Comienza con configuración de MemberKit. |
| Las reglas de acceso de suscripción o pago único se gestionan externamente | Solo necesitas eventos de venta en herramientas CRM vía webhooks |
Cómo funciona la entrega por callback
- El comprador completa el checkout y la venta alcanza el estado aprobado esperado en Ventas.
- AtomicPay envía el evento de acceso usando la URL de callback configurada.
- La plataforma externa crea o desbloquea la cuenta del comprador.
- El comprador inicia sesión en la plataforma externa.
- Soporte verifica el acceso usando tanto los datos de venta de AtomicPay como el registro de usuario de la plataforma externa.
La entrega por callback depende del mapeo correcto del producto, del estado de pago aprobado y de un endpoint accesible en el lado externo.
Flujo de configuración
- Confirma el espacio de trabajo del negocio correcto.
[Captura: Encabezado de la app — espacio de trabajo del negocio correcto seleccionado.]
- Completa primero la configuración de la plataforma externa en el lado de miembros.
[Captura: Admin de plataforma externa — curso o área listo antes de la configuración de callback.]
- Abre la configuración de entrega del producto.
[Captura: Pestaña de entrega del producto — sección de área de miembros externa visible.]
- Elige área de miembros externa como método de entrega.
[Captura: Método de entrega — Área de miembros externa seleccionada.]
- Selecciona la plataforma externa cuando esté disponible.
[Captura: Menú desplegable de plataforma — plataforma externa objetivo seleccionada.]
- Pega la URL de callback de la plataforma externa exactamente como se proporciona.
[Captura: Campo de URL de callback — URL completa pegada sin errores tipográficos.]
- Guarda el producto y confirma que la configuración de entrega persistió.
[Captura: Producto guardado — URL de callback almacenada en el producto.]
- Crea precios y publica el checkout.
[Captura: Checkout publicado — oferta vinculada al producto con entrega por callback.]
- Ejecuta una compra de prueba controlada a través del flujo de primera venta.
[Captura: Checkout de prueba — pago completado en link en vivo.]
- Confirma que el acceso aparece en el sistema externo para el comprador de prueba.
[Captura: Plataforma externa — cuenta del comprador de prueba creada con acceso correcto.]
- Documenta la escalación de soporte cuando el acceso se retrasa o falta.
[Captura: Documento interno de soporte — pasos de escalación para fallos de entrega por callback.]
Problemas comunes
| Problema | Qué verificar |
|---|---|
| No se creó acceso | Precisión de la URL de callback, estado de aprobación de la venta, mapeo externo |
| Curso o área incorrecta desbloqueada | Mapeo de producto u oferta de la plataforma externa |
| Acceso retrasado | Pago incompleto tratado como aprobado demasiado pronto. Consulta pagos incompletos. |
| Funcionó en prueba pero no en vivo | Mapeo diferente de oferta, producto o entorno externo |
| Suscripción cancelada pero el acceso permanece | Regla de plataforma externa más revisión de cancelación de suscripción |
Qué verificar antes del lanzamiento
| Verificación | Por qué importa |
|---|---|
| La URL de callback coincide con la documentación de la plataforma externa | Los errores tipográficos rompen toda la creación de acceso |
| El mapeo de producto y oferta es correcto en ambos lados | Un mapeo incorrecto envía compradores al área equivocada |
| El texto del checkout indica a los compradores que inicien sesión externamente | Reduce tickets de acceso del comprador |
| La venta de prueba está aprobada, no solo iniciada | El timing del callback depende del estado de la venta |
| Soporte sabe qué plataforma gestiona el acceso | Acelera las investigaciones |
| Los webhooks están configurados solo si las automatizaciones externas también los necesitan | Callbacks y webhooks resuelven problemas diferentes |
Buenas prácticas
- Prueba una compra real por producto y ruta de oferta antes de escalar tráfico.
- Mantén una tabla de mapeo entre productos de AtomicPay y áreas de plataforma externa.
- Usa configuración de MemberKit cuando MemberKit sea la plataforma objetivo.
- Monitorea tickets de soporte de la primera semana por retrasos de acceso después del lanzamiento.
- Revisa productos de suscripción con manejo de morosidad y política de cancelación.
Errores comunes
- Pegar una URL de callback de staging en un producto en vivo.
- Cambiar oferta o plan sin actualizar el mapeo externo.
- Asumir que la entrega por callback reemplaza los flujos de soporte de acceso del comprador.
- Lanzar antes de completar la aprobación de producto o la publicación del checkout.
- Solucionar la plataforma externa antes de confirmar la aprobación de la venta en Ventas.
Preguntas frecuentes
¿La entrega por callback es lo mismo que los webhooks?
No. Las URLs de callback forman parte de la entrega del producto para crear acceso de miembros. Los webhooks envían eventos de negocio a tus propios endpoints o herramientas de automatización.
¿Por dónde debo empezar con MemberKit?
Usa primero conectar MemberKit para entrega. Regresa aquí cuando necesites el modelo de callback más amplio explicado.
¿Qué pasa si el acceso falla para un solo comprador?
Compara la venta del comprador en Ventas con el registro de cuenta externa, luego sigue solución de problemas de acceso del comprador.
¿Los reembolsos eliminan el acceso externo automáticamente?
No asumas que lo hacen. Revisa reembolsos, la política del producto y el comportamiento de la plataforma externa en conjunto.