¿Qué es Prosperas?

Para: Lenders (equipo de integración)

Prosperas es un marketplace de crédito. La plataforma conecta a personas que buscan crédito con instituciones financieras capaces de otorgarlo, integrándose a través de aplicaciones que los consumidores ya usan a diario, como operadores móviles, billeteras digitales y apps de pago.

Esta guía está pensada para el equipo de integración de una entidad prestamista (banco o fintech). No asume conocimiento previo de la operación interna de Prosperas: acá vas a encontrar el modelo de negocio, el vocabulario común y el orden recomendado para construir tu integración.

El modelo B2B2C

Prosperas opera bajo un modelo B2B2C (business-to-business-to-consumer) que involucra tres roles principales:

Origin → Consumer → Lender — (origina el lead) / (usuario final) / (procesa la solicitud)

• Origin: La aplicación o plataforma donde las personas interesadas en un crédito inician su búsqueda (operador móvil, billetera digital, app de pago). El Origin genera el interés inicial y dirige al usuario hacia la experiencia de Prosperas.
• Consumer: El usuario final que busca crédito y que completa su solicitud dentro del flujo de Prosperas usando el catálogo de ofertas disponible.
• Lender: El banco o fintech aliado que recibe la solicitud, la evalúa y decide sobre el otorgamiento del crédito. Este es tu rol si estás leyendo esta guía.

Cómo viaja una solicitud

1. El Consumer llega a través de un Origin (por ejemplo, un mini-programa de un operador móvil).
2. Dentro de la experiencia de Prosperas, el Consumer explora ofertas y selecciona una.
3. Prosperas recopila la información necesaria y arma la solicitud (lead).
4. La solicitud se enruta al Lender correspondiente según la oferta seleccionada.
5. El Lender procesa la solicitud e informa los resultados (aprobación, desembolso, rechazo) mediante notificaciones de estado (postbacks).
6. Prosperas mantiene la comunicación con el Consumer a lo largo de todo el proceso.

El ciclo de vida del Tracking ID

Este es el concepto más importante que tenés que implementar bien. Un mismo identificador acompaña a cada solicitud desde que nace hasta que llega su último estado. Si lo manejás correctamente, cada postback que nos envíes se asocia sin ambigüedad a la solicitud correcta. Si lo manejás mal, tus actualizaciones de estado se pierden.

Un solo UUID por journey

Prosperas genera un UUID único por cada journey del Consumer (es nuestra referencia interna de sesión). Vos nunca lo generás: lo recibís y lo devolvés.

Cómo viaja ese identificador

El mismo valor recorre toda la integración bajo distintos nombres, según el canal:

1. Viaja como trackingId en cada llamada de API que Prosperas le hace a tu backend.
2. Viaja como clickId / click_id en la URL de redirección del hand-off (cuando le pasamos el Consumer a tu experiencia).
3. Lo devolvés (echo) en CADA postback que nos mandás.

Alias — es el mismo valor

tracking ID = clickId (en la redirección) = el campo click_id (en los postbacks). Un único valor con tres nombres según dónde aparezca.

Regla de oro

REGLA DE ORO

Guardá el click_id que te enviamos y devolvelo byte por byte en cada postback. Nunca lo generes, lo transformes ni lo trunques. Tratalo como una cadena opaca: puede llegar como un UUID plano o como orgname_UUID (exactamente un guion bajo, por ejemplo claro_7e1c...); NO lo dividas ni lo parsees por el guion bajo.

Tratarlo como cadena opaca significa: no lo interpretes, no le saques prefijos, no lo normalices a minúsculas, no le recortes espacios. Copiá exactamente lo que recibiste.

Ejemplo ilustrativo de la URL de hand-off

La redirección que te entrega el Consumer trae el click_id como parámetro de query. El siguiente es un ejemplo ilustrativo (los valores no son reales):

https://tu-dominio.com/solicitud?click_id=claro_7e1c9f24-3b8a-4d21-9e77-2a0f1c6b5d3e&product_id=ln_personal_01

Guardá el valor de click_id tal cual llega y devolvelo en todos tus postbacks para esa solicitud.

Ruta de integración recomendada (orden de operaciones)

Si estás arrancando, este es el orden en el que conviene construir. Cada paso habilita al siguiente:

1. Onboarding — Conseguí tus credenciales. Es el punto de partida: obtenés acceso y quedan organizados tus entornos de staging y producción.
2. Embedded Flow — Exponé tus 2 capacidades de API. Es donde tu backend recibe la solicitud en tiempo real, la evalúa y responde con una decisión.
3. Postbacks — Enviános actualizaciones de estado. Nos notificás cada cambio de estado de la solicitud (aprobación, desembolso, rechazo), devolviendo el click_id.
4. Product Data — Enviános la información de tus productos. Nos das los datos de tus productos para que el marketplace los muestre correctamente al Consumer.

Glosario de términos clave

Término	Definición
Origin	La aplicación o plataforma que origina el interés del Consumer y lo dirige hacia Prosperas (operador móvil, billetera digital, app de pago).
Consumer	El usuario final que busca crédito y completa su solicitud dentro del flujo de Prosperas.
Lender	El banco o fintech que recibe la solicitud, la evalúa y decide si otorga el crédito.
Lead	La solicitud de crédito generada por un Consumer; el objeto central que viaja del Origin al Lender y cuyo estado se reporta a lo largo del tiempo.
Listing	La forma en que la oferta de crédito de un Lender se le presenta al Consumer dentro de la experiencia de Prosperas; la vidriera de un producto.
Campaign	La configuración que define cómo y cuándo se muestra la oferta de un Lender: qué producto se promociona, con qué presupuesto y bajo qué condiciones de entrega de leads.
Product	El producto financiero específico que ofrece un Lender (crédito personal, crédito de nómina), con condiciones particulares.
Tracking ID	El identificador único que acompaña a una solicitud durante todo su recorrido, permitiendo que cada notificación de estado coincida con la solicitud correcta. Es el mismo valor que viaja como clickId en la redirección y como click_id en los postbacks.
product_id	El identificador de un producto del Lender que Prosperas le asigna. Viaja en las llamadas de API para que puedas reconciliar cada lead con el producto correcto de tu catálogo.
listing_id	El identificador del listing (la oferta publicada) que Prosperas le asigna. Junto con el product_id, permite atribuir con precisión a qué Lender y a qué oferta pertenece un lead.
Hand-off	El momento en que Prosperas entrega el Consumer a tu experiencia, típicamente mediante una redirección que incluye el click_id y datos de contexto de la solicitud.
Out-of-band	Entrega de credenciales por un canal separado y seguro (no dentro de las llamadas de API ni de la app). Se usa para compartir secretos de integración durante el onboarding.
Egress IP	La dirección IP de salida desde la cual Prosperas origina sus llamadas hacia tu backend. Podés usarla para incluirla en listas de permitidos (allowlist) en tu perímetro.
Pre-aprobación (pre-approval)	Un estado en el que el Lender indica una aprobación preliminar sujeta a validaciones posteriores, antes de la decisión y el desembolso definitivos.

Próximos pasos

• Onboarding y aprovisionamiento — acceso a credenciales y organización de entornos de staging y producción.
• Embedded Flow — integración institucional dentro de la experiencia de Prosperas para evaluar y procesar solicitudes en tiempo real.
• Sistema de Postbacks — notificar a Prosperas los cambios de estado de cada solicitud.
• Requisitos de datos de producto — información necesaria sobre los productos para su correcta presentación en el marketplace.

---

Última verificación: 2026-07-01 · v1.1