Descripción general

Qué es Prosperas #

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 #

El Consumer llega a través de un Origin (por ejemplo, un
mini-programa de un operador móvil).
Dentro de la experiencia de Prosperas, el Consumer explora ofertas y
selecciona una.
Prosperas recopila la información necesaria y arma la solicitud
(lead).
La solicitud se enruta al Lender correspondiente según la oferta
seleccionada.
El Lender procesa la solicitud e informa los resultados (aprobación,
desembolso, rechazo) mediante notificaciones de estado (postbacks).
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:

Viaja como trackingId en cada llamada
de API que Prosperas le hace a tu backend.
Viaja como clickId /
click_id en la URL de redirección del hand-off
(cuando le pasamos el Consumer a tu experiencia).
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 #

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:

Onboarding — Conseguí tus credenciales. Es el punto
de partida: obtenés acceso y quedan organizados tus entornos de staging
y producción.
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.
Postbacks — Enviános actualizaciones de estado. Nos
notificás cada cambio de estado de la solicitud (aprobación, desembolso,
rechazo), devolviendo el click_id.
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