# 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: empezar-primer-pago title: Recibe tu primer pago con SPIDI audience: Desarrollador que va a seguir el tutorial paso a paso contra el simulador hosteado objetivo: > Al terminar, el espectador recibió un pago de prueba de punta a punta: lo creó, lo llevó a pagado, lo confirmó desde su backend y procesó el aviso firmado. Y se lleva las dos lecciones que el tutorial existe para enseñar: la redirección no confirma nada, y `paid` no es dinero acreditado. cta: 'Siguiente: Solicitud de pago, Split o pasar a producción.' target_duration_s: 238 storyboard: - 'n': 90 on_screen: Este es el camino a pie narracion: >- Antes de empezar, una aclaración que te puede ahorrar el vídeo entero. Esto es el camino a pie: lo vas a hacer tú, paso a paso, y así entiendes cada pieza. Si lo que quieres es estar integrado hoy, hay otro camino: pedírselo a tu agente de inteligencia artificial con la skill de SPIDI. Hace esto mismo, solo. Si prefieres entenderlo, sigue aquí. visual: >- Dos caminos hacia la misma integración; se resalta el de la izquierda, el que se recorre a mano. duracion_s: 24 - 'n': 1 on_screen: Tu primer pago, de punta a punta narracion: >- En unos minutos vas a recibir tu primer pago de prueba con SPIDI: lo creas, lo llevas a pagado y confirmas que te llegó el aviso. Todo contra el simulador hosteado, sin dinero real y sin credenciales en vivo. Solo necesitas curl para los ejemplos y un poco de Node para recibir el aviso. visual: Un contador que va de cero a pagado, con tres checkpoints marcados por el camino. duracion_s: 21 - 'n': 2 on_screen: Paso 0 · Tus credenciales visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 3 on_screen: El alta te da tres piezas, y no son intercambiables narracion: >- Empiezas registrándote contra el simulador, con una sola llamada. Y el alta te entrega tres piezas de una vez, que conviene no confundir. El token de API, que es el que autentica todos los pasos de este tutorial. El token de consola, para la traza y tus receptores de avisos. Y unas credenciales de login, para que ejercites el camino de autenticación que en producción es obligatorio. Guarda las tres: cruzarlas devuelve un cuatrocientos uno, y ese error significa token equivocado, no token inválido. visual: El alta devolviendo tres piezas distintas, cada una con su etiqueta. duracion_s: 32 - 'n': 4 on_screen: Crear y pagar visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 5 on_screen: Paso 1 · Tu destino narracion: >- Con tu token, lo primero es crear el destino, que en la API se llama acuerdo de liquidación: defines a qué cuenta se acredita el dinero y qué métodos aceptas. La respuesta te entrega su identificador, y ese es tu primer checkpoint. Ojo con dónde viene: cuelga de data, no de la raíz. visual: El acuerdo creándose; en la respuesta, su identificador resaltado como primer checkpoint. duracion_s: 20 - 'n': 6 on_screen: Paso 2 · La sesión de Botón narracion: >- Ese identificador es justo lo que pide el paso siguiente: creas la sesión de pago de tipo Botón. La respuesta trae la URL de pago y el identificador de la sesión, los dos dentro de data, y el status arranca en pendiente. Segundo checkpoint. visual: La sesión de Botón creándose sobre ese acuerdo; salen la URL de pago y el status pendiente. duracion_s: 17 - 'n': 7 on_screen: Paso 3 · Lleva a quien paga narracion: >- Esa URL es lo que le das a quien te paga: el enlace lleva a la persona a la pantalla de pago, un formulario de Pago Móvil con su clave. En el simulador puedes abrirlo tú mismo, y las claves de prueba te dejan provocar cada desenlace a mano: la de seis ceros paga, y las demás fallan cada una con su motivo. visual: El enlace llevando a la pantalla de Pago Móvil del simulador, con su campo de clave. duracion_s: 24 - 'n': 8 on_screen: Y ahora, confirmarlo bien visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 9 on_screen: Paso 4 · Confirma desde tu servidor narracion: >- Y aquí está la primera de las dos lecciones que este tutorial existe para enseñar: la redirección a tu URL de éxito no garantiza que te pagaron. Solo dice que la persona volvió. Pregúntale a SPIDI desde tu backend: forzamos el desenlace desde el plano de control y consultamos el estado real, que confirma pagado. Tercer checkpoint, y este sí vale. visual: >- La redirección volviendo al sitio, con un interrogante encima; al lado, el backend preguntando de verdad. duracion_s: 23 - 'n': 10 on_screen: Paso 5 · Recibe y valida el aviso narracion: >- Al llegar a pagado, el simulador te envía el aviso. Trae un sello HMAC-SHA256 calculado sobre la marca de tiempo, un punto y el cuerpo crudo; esa misma marca de tiempo; y una clave de idempotencia. Tu endpoint verifica la firma, deduplica y responde 2xx. Y dos cosas hay que respetar o la verificación falla: que la marca de tiempo entra en la cadena firmada, y que el cuerpo son los bytes recibidos, no el JSON re-serializado. visual: El aviso firmado llegando al endpoint propio, que verifica, deduplica y responde. duracion_s: 30 - 'n': 11 on_screen: Paso 6 · Y así llega el dinero narracion: >- Aviso validado, y con eso acabas de recibir tu primer pago: lo creaste, lo confirmaste desde tu servidor y procesaste el aviso. Queda la segunda lección: el dinero se debita en la fase uno y luego se acredita al receptor en la fase dos, ya descontada la comisión del banco. Eso llega por un segundo aviso, y no cambia el status, que se queda en pagado. También lo puedes consultar en receiver_credits. visual: 'Línea de tiempo final: el débito, la acreditación, y el segundo aviso.' duracion_s: 28 - 'n': 12 on_screen: Siguientes pasos narracion: >- Ahí lo tienes: ya tienes tu flujo de punta a punta. Desde aquí puedes explorar la Solicitud de pago, el Split, o prepararte para pasar a producción. visual: 'Cierre de marca; tres caminos abiertos: Solicitud, Split, producción.' duracion_s: 10