# 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-split title: 'Split: repartir un pago entre varias cuentas' audience: Desarrollador de un marketplace o plataforma que necesita distribuir un pago objetivo: > Al terminar, el espectador sabe que el reparto lo ejecuta el banco y no él, cuál de los dos caminos para dar de alta un receptor le toca, que el alta de un partner lanza una verificación real contra el banco de un tercero, y dónde va cada pieza del reparto. cta: 'Siguiente: ''Botón web'' o ''Transacción a dos fases'', para ver dónde se aplica el reparto.' target_duration_s: 264 storyboard: - 'n': 1 on_screen: Un pago, varias cuentas narracion: >- Hay negocios donde lo que entra hay que repartirlo: un marketplace que vende para otros, una plataforma que trabaja con proveedores. Tu cliente paga una vez, y ese pago tiene que terminar distribuido entre varias cuentas. Eso es lo que hace un Split: reparte. visual: Un cliente pagando una vez, y ese mismo pago terminando distribuido en tres cuentas distintas. duracion_s: 17 - 'n': 2 on_screen: Y lo reparte el banco, no tú narracion: >- Y lo reparte el banco, no tú. Declaras una vez cómo se distribuye, a quién le toca qué, y a partir de ahí cada pago que entre por ese destino se reparte solo, en el momento de acreditarse. No recibes el total y repartes después: a cada cuenta le llega directamente su parte ya separada. Quien paga no ve nada de esto: paga una vez, un solo monto. visual: El pago entrando al banco y saliendo ya separado; el integrador mirando, sin tocar el dinero. duracion_s: 26 - 'n': 3 on_screen: Cuál de los dos caminos es el tuyo visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 4 on_screen: Dos operaciones, dos situaciones narracion: >- Antes de nada, una elección que si haces mal cuesta tiempo. Hay dos operaciones que devuelven el identificador de un receptor, y no son dos formas de hacer lo mismo: son para dos situaciones distintas. Si le vas a repartir a alguien que no está en SPIDI, das de alta un partner, y lo haces tú. Si le repartes a un negocio que ya opera con SPIDI, es él quien genera su identificador sobre su propia cuenta y te lo comparte. visual: Dos operaciones que devuelven el mismo tipo de identificador, para dos situaciones distintas. duracion_s: 31 - 'n': 5 on_screen: El partner no necesita hacer nada narracion: >- Y ese primer camino es el que decide si un marketplace puede repartir o no. Das de alta al partner por API, sin que él haga nada: ni un correo, ni una clave, ni una confirmación. No se crea ninguna cuenta en SPIDI: es un receptor de fondos, sin usuario y sin acceso a la plataforma. Lo único que hace falta es que sus datos bancarios sean correctos. visual: El alta de un partner hecha por el integrador, sin correo ni clave para el receptor. duracion_s: 26 - 'n': 6 on_screen: Pero esa alta toca un banco de verdad narracion: >- Y aquí va la advertencia más importante de esta guía: esa operación no es un alta administrativa. SPIDI lanza una verificación real contra el banco de la persona que estás registrando, y el error lo devuelve el banco, no SPIDI. Si te dice que los datos del cliente no corresponden a la cuenta, el teléfono existe en ese banco pero la cédula no cuadra. Si te dice que el teléfono no está registrado, casi siempre es el código de banco equivocado. visual: >- El alta lanzando una verificación real contra el banco del receptor, con el error viniendo del banco. duracion_s: 31 - 'n': 7 on_screen: El banco no se adivina probando narracion: >- De ahí lo que importa: el banco no se adivina probando. Cada intento toca la cuenta de un tercero que no es tu cliente. Pide los datos completos —banco, teléfono y cédula tal como los tiene en su Pago Móvil— antes de la primera llamada. Y ojo, la operación no es idempotente: repetirla con los mismos datos crea otro partner, con otro identificador. Guarda el que te devuelve. visual: >- Un intento a ciegas tocando la cuenta de un tercero; al lado, los datos completos pedidos por adelantado. duracion_s: 26 - 'n': 8 on_screen: Para probar, repártete a ti mismo narracion: >- Y si solo quieres probar el reparto sin involucrar a nadie, puedes repartirte a ti mismo: generas tu propio identificador de recepción sobre tu cuenta, sin verificación de por medio, y lo usas en la distribución. No es solo para probar: es la forma de repartir entre varias cuentas propias. visual: El propio integrador generando su identificador de recepción sobre su propia cuenta. duracion_s: 19 - 'n': 9 on_screen: Dónde va cada pieza visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 10 on_screen: El acuerdo habilita; la sesión detalla narracion: >- Con los receptores listos, queda armar el reparto, y se arma en dos sitios que conviene no confundir. Tu acuerdo de liquidación solo habilita: el campo de reparto es un booleano y no lleva ningún detalle. La distribución concreta va en cada sesión de pago, con la lista de quién recibe cuánto en esa transacción. Y dos campos que el contrato no marca como obligatorios y lo son: tu cuenta bancaria por defecto en el acuerdo, y la URL de fallo en la sesión. visual: El acuerdo con el reparto habilitado, y la sesión con la distribución detallada. duracion_s: 32 - 'n': 11 on_screen: La diferencia se acredita a ti narracion: >- La suma de los montos que repartes tiene que ser menor que el total de la sesión, porque la diferencia se te acredita a ti. Y todas las partes se llaman igual: la de cada partner y la tuya son cuotapartes, porque todas responden a lo mismo, al acuerdo por el que se reparten esa venta. La comisión del banco es otra cosa, y se aplica aparte, sobre cada crédito. visual: La suma de las partes por debajo del total, y la diferencia acreditándose al owner. duracion_s: 27 - 'n': 12 on_screen: Un solo webhook, varias llamadas narracion: >- Y al acreditar, un detalle de tu receptor de avisos: configuras una sola URL de webhook, la misma que en cualquier pago, pero ese mismo endpoint recibe varias llamadas por una sola sesión. Una por cada receptor al acreditarse su parte, más una de cierre. No hay una URL por receptor: un receptor es una cuenta bancaria, no una dirección web. visual: Cierre de marca; un solo endpoint recibiendo varias llamadas por una misma sesión. duracion_s: 23