# Guion del vídeo, para comentar o para lo que necesites.
# Es una PROYECCIÓN del nuestro: lleva el contenido —qué se dice, qué se ve, en
# qué orden y cuánto dura— y no la maquinaria que lo convierte en vídeo.
id: productos-success-url
title: 'Success URL: verifica el status desde tu backend'
audience: Desarrollador que ya recibe pagos y va a cerrar el pedido y a conciliar contra el banco
objetivo: >
  Al terminar, el espectador sabe que la redirección no confirma nada y cuáles son las dos formas
  correctas de confirmar, qué mostrarle a su cliente en esa pantalla, y con qué campo casa la línea
  de su extracto bancario. Se lleva además la trampa de forma: el mismo dato cuelga de sitios
  distintos según lo leas del webhook o del status.
cta: 'Siguiente: ''Manejar notificaciones'' o ''Transacción a dos fases''.'
target_duration_s: 177
storyboard:
  - 'n': 1
    on_screen: La tentación, y por qué no
    narracion: >-
      Cuando la persona termina, SPIDI la redirige a tu URL de éxito. Y es tentador marcar el pedido
      como pagado ahí mismo. No lo hagas: llegar a esa URL solo dice que la persona volvió a tu
      sitio. No prueba que el pago se completó — alguien podría abrir esa dirección directamente, o
      volver sin haber pagado.
    visual: >-
      Alguien volviendo a la pantalla de éxito, y un pedido marcándose como pagado sin comprobar
      nada.
    duracion_s: 22
  - 'n': 2
    on_screen: Las dos formas correctas
    narracion: >-
      Hay dos formas de confirmarlo de verdad, y lo ideal es combinarlas. La primera es preguntar:
      desde tu backend, nunca desde el navegador, consultas el estado real de la sesión, y marcas el
      pedido como pagado solo si dice pagado. La segunda es escuchar: procesas el aviso firmado que
      SPIDI envía a tu URL de webhook, que es la vía más fiable porque no depende de que la persona
      vuelva. El aviso te avisa en cuanto ocurre; la consulta te sirve de respaldo.
    visual: 'Dos caminos correctos: el backend preguntando, y el aviso llegando solo.'
    duracion_s: 32
  - 'n': 3
    on_screen: Qué mostrarle a tu cliente ahí
    narracion: >-
      Y ya que tienes esa pantalla, hay dos datos que te llegan y conviene enseñar, porque son justo
      lo que tu cliente te va a pedir después. El identificador de la transacción en SPIDI, que es
      la referencia con la que se resuelve cualquier consulta posterior. Y el enlace al comprobante
      oficial: un botón hacia ahí le evita escribirte para pedirlo.
    visual: La pantalla del cliente con el número de transacción y un botón al comprobante.
    duracion_s: 23
  - 'n': 4
    on_screen: Y si no la configuras, no pasa nada grave
    narracion: >-
      Y si no configuras esa URL, tu cliente no se queda en el aire: SPIDI muestra su propia
      pantalla de confirmación con los detalles del pago. Tener la tuya sirve para que la
      experiencia no salga de tu sitio, no para que exista.
    visual: La pantalla propia del pagador que muestra SPIDI si no configuras la tuya.
    duracion_s: 17
  - 'n': 5
    on_screen: Conciliar contra el banco
    visual: Lámina de sección, sin voz.
    duracion_s: 3
  - 'n': 6
    on_screen: En el banco ves la acreditación
    narracion: >-
      Queda cuadrar cuentas, y ahí hay algo que sorprende: cuando revises el banco vas a ver la
      acreditación, no el débito. Y para casarla necesitas el número que usa el banco, no el de
      SPIDI. Está en la consulta de estado, dentro de los detalles del crédito, y es la referencia
      exacta que aparece reflejada en tu cuenta.
    visual: El extracto bancario mostrando la acreditación, no el débito, y el campo que las casa.
    duracion_s: 22
  - 'n': 7
    on_screen: 'La trampa: cuelga de sitios distintos'
    narracion: >-
      Pero cuidado con una trampa de forma, porque falla en silencio. El mismo dato viaja por los
      dos canales y no viene igual. En la consulta de estado los créditos cuelgan de
      session_payment; en el aviso llegan un nivel más arriba, al mismo nivel que él. Si lees las
      dos fuentes con el mismo código, una de las dos te devolverá indefinido, sin ningún error. Y
      otro detalle: en la consulta, los créditos son un objeto con el owner y los partners, no un
      arreglo.
    visual: El mismo dato colgando de dos sitios distintos según venga del webhook o del status.
    duracion_s: 33
  - 'n': 8
    on_screen: Guárdalo cuando llegue la acreditación
    narracion: >-
      Y un consejo para el cierre de mes: esa referencia nace con la fase dos, así que si tu
      conciliación es mensual, persístela al recibir el aviso de acreditación y te ahorras consultar
      sesión por sesión. Porque recuerda: pagado confirma el débito. Que te llegue el dinero es la
      acreditación, y la conoces por el aviso o por los créditos de la propia consulta.
    visual: >-
      Cierre de marca; la referencia guardada al llegar la acreditación, evitando consultar sesión
      por sesión.
    duracion_s: 25