Saltar al contenido principal

Stripe Payment Links

La integración más sencilla de Selgeo — no se requiere código de backend. El snippet de seguimiento reescribe automáticamente los Stripe Payment Links en su página para incluir el click_id, y Selgeo lo lee del webhook de Stripe cuando el cliente paga.

Versión de API: v1

Requisitos previos​

  • El snippet de Selgeo está instalado en su sitio web (Configuración del snippet)
  • Usa Stripe Payment Links (URLs https://buy.stripe.com/...) en su sitio
  • Su cuenta de Stripe está conectada a Selgeo en el panel de control (Configuración > Stripe)

Cómo funciona​

El snippet detecta todos los <a> tags apuntando a https://buy.stripe.com/... y agrega ?client_reference_id=CLICK_ID. El flujo completo es automático:

  1. Instalar el snippet.
  2. Poner Stripe Payment Links en su página.
  3. Conectar Stripe a Selgeo.

Configuración​

Paso 1: Instalar el snippet​

<script
  async
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
></script>
<a href="https://buy.stripe.com/test_abc123">Suscribirse al Plan Pro</a>
<a href="https://buy.stripe.com/test_def456">Suscribirse al Plan Enterprise</a>

Paso 3: Conectar Stripe​

En el panel de control de Selgeo, vaya a Configuración > Stripe y conecte su cuenta de Stripe.

Lo que reescribe el snippet​

Antes:

https://buy.stripe.com/test_abc123

Después (cuando hay un click_id almacenado):

https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-58cc-4372-a567-0e02b2c3d479

Protección contra sobreescritura del comerciante​

Si establece client_reference_id en un Payment Link usted mismo, el snippet no sobrescribirá su valor:

<!-- Su client_reference_id personalizado se conserva -->
<a href="https://buy.stripe.com/test_abc123?client_reference_id=mi_cliente_123">
  Suscribirse
</a>

Pruebas​

  1. Consiga un enlace de seguimiento. Los enlaces de seguimiento los crean los socios en el portal de socios (en Enlaces), no en el panel del comerciante — para una prueba por su cuenta, inicie sesión como socio de prueba y cree uno.
  2. Visite su sitio usando el enlace de seguimiento: https://su-sitio.com/?ref=SU_REF_PRUEBA
  3. Inspeccione el Payment Link — haga clic derecho en el enlace y seleccione «Inspeccionar» o «Copiar dirección del enlace». Verifique que se haya añadido client_reference_id.
  4. Haga clic en el Payment Link y complete la compra con la tarjeta de prueba de Stripe 4242 4242 4242 4242.
  5. Compruebe el panel de control — la conversión debería aparecer en Analytics, atribuida al socio.

Modo de depuración​

Añada data-debug a la etiqueta del snippet para ver la actividad de reescritura en la consola:

[selgeo] Stripe payment link rewritten https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-...

Limitaciones​

  • Solo se detectan los enlaces buy.stripe.com. Si redirige Stripe Payment Links a través de su propio dominio, el snippet no puede detectarlos.
  • El visitante debe llegar primero a través de un enlace de seguimiento. Si no hay click_id en sessionStorage, no se produce ninguna reescritura.
  • Sesión limitada a la pestaña. El sessionStorage es específico de la pestaña.

Próximos pasos​