Envío de solicitudes de Partners
Historial de revisiones
| Autor | Fecha | Cambios | Versión |
|---|---|---|---|
| Paco Lora | 15/09/2013 | Creación documento | 0.1 |
| Paco Lora | 19/09/2013 | Revisión del documento y publicación | 1.0 |
| Paco Lora | 24/05/2016 | URL por HTTPS e IBAN | 1.1 |
| Paco Lora | 14/06/2016 | Versión 2, funcionalidades nuevas | 2.0 |
| Paco Lora | 17/07/2018 | Cambio de formato. Versión 3, nueva api CPA | 3.0 |
| Paco Lora | 08/10/2018 | Revisión, pequeñas correcciones | 3.0.1 |
| Paco Lora | 16/10/2018 | Revisión del funcionamiento de CPA | 3.0.2 |
1- Envío de solicitudes a Préstamo10
Esquema del proceso
Se describe la secuencia de los pasos que se realizarán una vez integrado el sistema.
- Un usuario accede a la URL que tiene el formulario del partner. Ej: http://partner.com/solicitar_prestamo
- La página contiene el formulario que ha creado el partner. Es importante que este formulario contenga el campo oculto X-API-KEY con la clave del partner. El usuario rellena el formulario.
- El partner debe validar los datos introducidos por el usuario, normalmente mediante JavaScript o como considere. Si los datos del usuario son correctos y válidos, enviará los datos por POST a la URL de la API que corresponda, CPA o CPL.
- El sistema de Prestamo10 analiza la solicitud y genera una respuesta indicando si se ha procesado correctamente o hay algún error.
- El partner recibe la respuesta y la analiza para identificar si el resultado ha sido correcto o erróneo.
- Según el resultado, el partner hace lo que considere necesario de cara al usuario: mostrar errores, mostrar mensaje de éxito, etc. Dado que nuestro proceso requiere la validación de documentos que debe aportar el cliente, recomendamos reenviar al cliente al área privada (https://www.prestamo10.com/clientes), donde podrá adjuntar dichos documentos para que sean procesados. Cuando la respuesta de la API es positiva en la respuesta se incluyen varias URL para facilitar el reenvío del cliente.
1.1- Datos de integración
X-API-KEY
Para trabajar como partner de Prestamo10 debe registrarse y solicitar su alta. Si es aceptado recibirá una clave, X-API-KEY, imprescindible para cualquier comunicación con el API de Prestamo10.
RestAPI Préstamo10
Se encuentra en https://api.prestamo10.com. Se encarga de atender las solicitudes de los partners. Para interaccionar es imprescindible disponer de una X-API-KEY.
El sistema permitirá un máximo de 50 solicitudes por hora y dispone de sistemas de detección de intrusión, por lo que en caso de recibir parámetros incorrectos el sistema puede bloquear su código X-API-KEY e incluso su dirección IP.
2- API CPA
2.1- Loan
| Método | POST |
| URL | https://api.prestamo10.com/v3/cpa/loan |
| URL test | https://api.prestamo10.com/sandbox/cpa/loan |
Se le envían los datos de una solicitud de préstamo por POST. La API analiza y procesa los datos. Si todo es correcto la solicitud se incorpora al proceso de entrada de Préstamo10. Si se detecta algún problema se descartará.
Importante: Se aceptarán todas las solicitudes que contengan datos correctos, pero tenga en cuenta que la aceptación no implica que se conceda el préstamo. Una solicitud aceptada se incorpora al proceso de análisis y filtrado de Préstamo10, por lo que es posible que una solicitud que la API aceptó posteriormente sea rechazada por ejemplo por un operador que detecta documentos falsos.
2.1.1 - Parámetros
(*requeridos)
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| Generales | |||
| format | Permite especificar el formato de la respuesta. Por defecto JSON | String | [xml, json, jsonp, serialized, php, html, csv] |
| X-API-KEY * | Clave del partner. Puede venir por GET, POST, o en el HEADER de la petición | String | La clave que le asignó Prestamo10 cuando le dio de alta. |
| Campos de la solicitud | |||
| requested * | Importe del préstamo solicitado | Entero | [50…300] Solicitudes por importes menores no se aceptarán. Solicitudes con importes mayores solo para clientes. Debe ser un múltiplo de 5 sin decimales. |
| term * | Plazo de devolución del préstamo | Entero | [5…30] no se aceptarán solicitudes con plazo fuera del rango. |
| promocode | Código de promoción a aplicar | Texto | Si dispone de un código promocional lo puede incluir en la solicitud |
| in_ip | Ip del solicitante | xxx.xxx.xxx.xxx | Puede acelerar el procesamiento de la solicitud si nos envía la ip del solicitante |
| partner_code | Código de agente | Texto | Si tiene usted agentes propios puede preparar un formulario diferente para cada uno usando este campo. No es necesario para sus propias solicitudes. |
| a_name * | Nombre del solicitante | Texto | |
| a_first_name * | Primer apellido del solicitante | Texto | |
| a_last_name | Segundo apellido del solicitante | Texto | |
| a_sex * | Sexo del solicitante | Entero | Ver 4.1 - Sexo |
| a_doc_id * | DNI / NIE del solicitante | Formato correcto y validación de letras | |
| a_doc_type | Indica si a_doc_id es un DNI o un NIE. Si no se indica se calculará. | Entero | Ver 4.2 - Tipo de documento de identidad |
| a_birthday * | Fecha de nacimiento del solicitante | dd/mm/yyyy | Debe ser una fecha válida |
| a_account * | IBAN electrónico de la cuenta del solicitante | ESxxxxxxxxxxxxxxxxxxxxxx | Ejemplo: ES7921000813610123456789 |
| a_gsm_number * | Teléfono movil del solicitante | Numérico, sin espacios. No se debe añadir el prefijo internacional (+34) | xxxxxxxxx |
| a_landline | Teléfono fijo del solicitante | Número, sin espacios | xxxxxxxxx |
| a_email * | Correo electrónico del solicitante | Email correcto | |
| a_password | Contraseña del solicitante | String, mín. 6 caracteres. | Si el solicitante es un cliente nuevo y en la solicitud se incluye password podrá acceder al área privada de clientes. Si se incluye en la solicitud se incluirá también obligatoriamente el campo repeat (repetición del password). |
| repeat | Repetición del password | String, mín. 6 caracteres. | |
| a_address_1 * a_address_2 |
Dirección del solicitante, una o dos líneas | String | |
| a_zip * | Código postal del solicitante | String | |
| a_province * | Provincia del solicitante | String | |
| a_city * | Ciudad del solicitante | String | |
| a_region * | Región a la que pertenece el solicitante. Debe calcularla (vea el ejemplo) | Entero | Ver 4.3 - Regiones |
| Datos económicos del solicitante | |||
| bg_employment | Estado laboral del solicitante | Entero | Ver 4.4 - Tipo de empleo |
| bg_marital | Estado civil del solicitante | Entero | Ver 4.5 - Estados civiles |
| bg_income* | Ingresos mensuales demostrables del solicitante | Entero / Decimal | No se aceptan solicitudes sin ingresos. Si tiene decimales se separarán por punto, no coma. Ingresos por debajo de 600€ se deniegan. |
| bg_income_couple | Ingresos mensuales de la pareja del solicitante | Entero / Decimal | Si tiene decimales se separarán por punto, no coma. |
| bg_childrens | Hijos a cargo del solicitante | Entero | |
| bg_rent | Alquiler a cargo del solicitante | Entero / Decimal | Si tiene decimales se separarán por punto, no coma. |
| bg_loans | Importe mensual de otros préstamos del solicitante | Entero / Decimal | Si tiene decimales se separarán por punto, no coma. |
| bg_studies | Estudios completados | Entero | 4.6 - Nivel de estudios |
| bg_living | Vivienda del solicitante | Entero | 4.7 - Vivienda |
| bg_mortgage | Importe de la hipoteca del solicitante si es propietario | Entero | |
| Aceptación de condiciones | |||
| a_adv * | Aceptación del solicitante para recibir ofertas y promociones en su email. | [0,1] | El solicitante puede aceptar de forma opcional recibir ofertas y promociones por parte de Prestamo10 |
| a_adv3 | Aceptación del solicitante para recibir ofertas y promociones de empresas colaboradoras de Préstamo10 en su email | [0,1] | El solicitante puede aceptar de forma opcional recibir promociones de empresas colaboradoras de Préstamo10 |
| a_pp * | Aceptación de la política de privacidad por parte del solicitante. | 1 | Debe informar obligatoriamente al solicitante de la política de privacidad de Prestamo10 y éste debe aceptarla o la solicitud no se procesará. Prestamo10 le enviará su política de privacidad. Si usted tiene unos términos diferentes deberá mantener la política de privacidad de Prestamo10. |
| accept * | Aceptación de los términos y condiciones por parte del solicitante. | 1 | Debe informar obligatoriamente al solicitante de los términos y condiciones para realizar la solicitud, y éste debe aceptarlos. Recibirá los términos y condiciones de Prestamo10. Si los modifica asegúrese de mantener los términos y condiciones originales. |
2.1.2 - Respuesta
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| ok | Indica si la solicitud se ha procesado correctamente. | [0, 1] | 0=>Solicitud no aceptada 1=>Solicitud admitida |
| err | Si ok = 0 contiene los errores que provocaron que no se aceptara la solicitud. | Array | Consultar la tabla a continuación |
| Si ok=1 | |||
| password | Si se especificó un password en la solicitud será ese mismo. Si no, contiene el password generado para el cliente. Para acceder al área de cliente usará el email y este password | String | |
| login | Email del usuario | String | |
| loginURL | Dirección del área de clientes de Préstamo10 | String | |
| autoLoginURL | Dirección de login directo al área de clientes sin introducción de usuario y contraseña. Es válida una sola vez. Cuando el cliente ya ha accedido a la URL se desactiva | ||
| loan | Identificador de la solicitud de préstamo. Úsela para consultar el estado posteriormente. | ||
| thankYouPage | Página de Préstamo10 donde puede reenviar al cliente. En ella se indicarán los detalles del préstamo solicitado |
2.1.3 - Errores
| Error | Descripción |
|---|---|
| ‘requested’ must be between X and Y | El importe solicitado está fuera de los límites permitidos |
| ‘requested’ must be an integer | El importe solicitado no es correcto, debe ser un número sin decimales |
| ‘requested’ must be a multiple of 10 | El importe solicitado no es correcto, debe ser un númeromúltiplo de 10 |
| ‘term’ must be between X and Y days | El plazo de la solicitud está fuera de los límites permitidos |
| ‘term’ must be an integer | El plazo de la solicitud es incorrecto, debe se un número sin decimales |
| ‘a_sex’ wrong value, use 225 for male and 226 for female | Valor incorrecto para el campo a_sex |
| Bad customer-DNI | El DNI indicado no es válido |
| Wrong format for ‘a_birthday’, use dd/mm/yyyy | La fecha de nacimiento se indicó en un formato incorrecto |
| Client is X years old, exceeds age limit (Z - Y) | La edad del solicitante está fuera de los límites permitidos |
| ‘a_account’ is not a valid bank account | El IBAN indicado o su formato son incorrectos |
| ‘a_email’ is not a valid email | Email incorrecto |
| ‘a_region’ has an invalid value, check documentation | La región indicada es icorrecta, consulte la tabla de valores permitidos |
| ‘bg_employment’ has an invalid value, check documentation | El valor de *bg_employment |
| ‘bg_studies’ has an invalid value, check documentation | El valor de bg_studies es incorrecto, consulte la tabla de valores |
| ‘bg_marital’ has an invalid value, check documentation | Valor incorrecto para estado civil, consulte la tabla de valores permitidos |
| ‘bg_living’ has an invalid value, check documentation | Valor incorrecto para vivienda, consulte la tabla de valores permitidos |
| ‘a_pp’ must be 1 indicating that client accepts the privancy policy | No se aceptan solicitudes que no acepten la política de privacidad de Préstamo10 |
| ‘accept’ must be 1 indicating that client accepts the terms and conditions | No se aceptan solicitudes que no acepten los términos y condiciones de Préstamo10 |
| ‘a_password’ must be at least 6 characters long if present | Si se indica un password debe tener al menos seis caracteres |
| ‘a_password’ and ‘repeat’ must be identical if password is present | Si se indica un password se debe indicar también el campo repeat, que es la confirmación del password y deben ser idénticos |
| Client not accepted (X) | Préstamo10 no acepta al cliente que hace la solicitud. X indica un código interno con el motivo del rechazo |
| X is required | No se ha especificado un campo requerido |
| X can’t be empty | Se ha enviado un valor vacío para un campo requerido |
| Bad status (X). Contact us | El resultado del proceso de la solicitud es incorrecto, contacte con nosotros para analizar el caso |
| System rejects client (X) | El sistema no aceptará solicitudes de este cliente |
| Client temporarily blocked | El sisteme no aceptará solicitudes de este cliente temporalmente |
| Unexpected error(X) | Se produjo un error no controlado. Contacte con nosotros para analizar el caso. |
| Open loan | El cliente tiene un préstamo en curso en nuestro sistema, no se admiten nuevas solicitudes hasta que el préstamo esté cerrado. |
| Rejected by system | El sistema ha rechazado la solicitud |
| Unknown error | Error no controlado, informe al equipo de Préstamo10 |
2.2- Loan status
| Método | GET |
| URL | https://api.prestamo10.com/v3/cpa/loan_status/[identificador |
| URL test | https://api.prestamo10.com/sandbox/cpa/loan_status/[identificador] |
Permite consultar el estado de una solicitud mediante su identificador.
2.2.1 - Parámetros
(* requeridos)
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| format | Permite especificar el formato de la respuesta. Por defecto json. | String | [xml, json, jsonp, serialized, php, html, csv] |
| X-API-KEY * | Clave del partner. Puede venir por GET, POST, o en el HEADER de la petición | String | La clave que le asignó Prestamo10 cuando le dio de alta. |
| [identificador] | Identificador que se recuperó al hacer la solicitud en al campo loan. Forma parte de la URL. Ej: https:/…loan_status/00067852 |
String / Entero |
2.2.2 - Respuesta
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| ok | Indica si la consulta es correcta. | [0, 1] | 0 => Identificador incorrecto, la solicitud no existe o el partner no es quien registró la solicitud, … 1 => Consulta correcta |
| status | Estado en que se encuentra la solicitud sobre la que se pregunta | String | Ver siguiente tabla. |
| err | Si se produce un error contiene la descripción | Array | Unauthorized: el partner no es quien registró la solicitud Loan not found: No existe la solicitud. |
2.2.3 - Errores
Los únicos errores que contempla este método de la API son Loan not found cuando se consulta una solicitud que no existe y Unauthorized cuando se intenta consultar un Loan que no pertenece al partner indicado en la API-KEY.
3.2.4 - Estados de solicitudes
| Mensaje | Descripción |
|---|---|
| [id] not yet processed | La solicitud está en la cola de proceso |
| [id] Denied, not valid | El sistema descartó la solicitud. |
| [id] Denied, client is reported | Denegada porque el cliente no se considera fiable |
| [id] Denied, duplicated | El cliente tenía un préstamo en curso cuando llegó la solicitud |
| [id] Denied by scoring | El sistema descarta la solicitud por no considerar solvente al cliente |
| [id] Denied, PXL reports active loans | PréstamoXL informa que el usuario tiene préstamos abiertos. Se deniega para evitar sobreendeudamiento. |
| [id] Processing | Se está procesando la solicitud |
| [id] Unknow status | Estado desconocido, contacte con nosotros. |
| [id] App not found | Contacte con nosotros. |
| … (Archived) | Se indica además del estado de la solicitud. Indica que, independientemente de su estado final, esta solicitud se ha archivado y no se continuará procesando (ha caducado). |
| [id] Approved | Solicitud aprobada por Préstamo10 |
| [id] Rejected | Solicitud rechazada por Préstamo10 |
| [id] Rejected by client | Solicitud rechazada por el cliente |
| [id] Loan | Préstamo concedido |
3- API CPL
3.1- Check duplicate
| Método | POST |
| URL | https://api.prestamo10.com/v2/affiliate/check_duplicate |
| URL test | https://api.prestamo10.com/sandbox/affiliate/check_duplicate |
Esta llamada permite comprobar si un DNI / NIE ya existe en la base de datos de Préstamo 10.
La respuesta que se obtiene en la URL de test es la misma que en la URL real.
Cualquier llamada a register customer que contenga un DNI conocido por Préstamo10 será descartada. Utilice este método para comprobar si una solicitud será o no aceptada a trámite antes de enviarla.
3.1.1 - Parámetros
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| format | Permite especificar el formato de la respuesta. Por defecto json. | String | [xml, json, jsonp, serialized, php, html, csv] |
| X-API-KEY * | Clave del partner. Puede venir por GET, POST, o en el HEADER de la petición | String | La clave que le asignó Prestamo10 cuando le dio de alta. |
| customer-DNI | DNI / NIE a comprobar | String |
3.1.2 - Respuesta
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| ok | Indica si Préstamo10 aceptaría este DNI/NIE como nuevo cliente | [0, 1] | 0 => No se aceptaría como nuevo cliente. 1 => Se aceptaría como nuevo cliente |
| Err | Cuando ok = 0 contiene un array con los errores detectados. | Array | Siguiente tabla |
3.1.3 - Errores
| Error | Descripción |
|---|---|
| duplicate-customer | El DNI/NIE indicado ya es cliente de Préstamo10. |
| Bad customer-DNI | El DNI/NIE indicado no es válido. |
3.2- Register customer
| Método | POST |
| URL | https://api.prestamo10.com/v2/affiliate/register_customer |
| URL test | https://api.prestamo10.com/sandbox/affiliate/register_customer |
Esta llamada permite enviar una solicitud de préstamo de un cliente nuevo. Si el DNI / NIE proporcionado ya existe en la base de datos de Préstamo10 se rechazará.
La URL de test ejecuta el mismo proceso que la real, pero una vez se guarda la solicitud no se continua con su proceso.
3.2.1 - Parámetros
(* requeridos)
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| format | Permite especificar el formato de la respuesta. Por defecto json. | String | [xml, json, jsonp, serialized, php, html, csv] |
| X-API-KEY * | Clave del partner. Puede venir por GET, POST, o en el HEADER de la petición | String | La clave que le asignó Prestamo10 cuando le dio de alta. |
| requested * | Importe del préstamo solicitado | Entero | [50…300] |
| term * | Plazo de devolución del préstamo | Entero | [5…30] |
| in_ip * | Ip del solicitante | IP | Puede acelerar el procesamiento de la solicitud si nos envía la ip del solicitante |
| partner_code | Código de agente | Texto | Si tiene usted agentes propios puede preparar un formulario diferente para cada uno usando este campo. No es necesario para sus propias solicitudes. |
| a_name * | Nombre del solicitante | Texto | |
| a_first_name * | Primer apellido del solicitante | Texto | |
| a_last_name | Segundo apellido del solicitante | Texto | |
| a_sex * | Sexo del solicitante | Entero | Ver 4.1 - Sexo |
| a_doc_id * | DNI / NIE del solicitante | DNI / NIE | |
| a_doc_type | Indica si a_doc_id es un DNI o un NIE. Si no se indica se calculará. | Entero | Ver 4.2 - Tipo de documento de identidad |
| a_birthday * | Fecha de nacimiento del solicitante | dd/mm/yyyy | Debe ser una fecha válida. Se usará para calcular la edad del solicitante. |
| a_account * | IBAN electrónico de la cuenta del solicitante | ESxxxxxxxxxxxxxxxxxxxxxx | Ejemplo: ES7921000813610123456789 |
| a_gsm_number * | Teléfono movil del solicitante | Numérico, sin espacios. No se debe añadir el prefijo internacional | xxxxxxxxx |
| a_landline | Teléfono fijo del solicitante | Número, sin espacios | xxxxxxxxx |
| a_email * | Correo electrónico del solicitante | Email correcto | |
| a_password | Contraseña del solicitante | String, mín. 6 caracteres. | Si en la solicitud se incluye el password el cliente podrá acceder al área privada de clientes. Si no se incluye se generará un password aleatorio. |
| a_address_1 * a_address_2 |
Dirección del solicitante, una o dos líneas | String | |
| a_zip * | Código postal del solicitante | String | |
| a_province * | Provincia del solicitante | String | |
| a_city * | Ciudad del solicitante | String | |
| a_region * | Región a la que pertenece el solicitante. Debe calcularla (vea el ejemplo) | Entero | Ver 4.3 - Regiones |
| bg_employment | Estado laboral del solicitante | Entero | Ver 4.4 - Tipo de empleo |
| bg_marital | Estado civil del solicitante | Entero | Ver 4.5 - Estados civiles |
| bg_income * | Ingresos mensuales demostrables del solicitante | Número | |
| bg_childrens | Hijos a cargo del solicitante | Entero | |
| bg_rent | Alquiler a cargo del solicitante | Número | Si tiene decimales se separarán por punto, no coma. |
| bg_loans | Importe mensual de otros préstamos del solicitante | Número | Si tiene decimales se separarán por punto, no coma. |
| bg_studies | Estudios completados | Entero | Ver 4.6 - Nivel de estudios |
| a_adv * | Aceptación del solicitante para recibir ofertas y promociones en su email. | 0 / 1 | El solicitante puede aceptar de forma opcional recibir ofertas y promociones por parte de Prestamo10 |
| a_pp * | Aceptación de la política de privacidad por parte del solicitante. | 1 | Debe informar obligatoriamente al solicitante de la política de privacidad de Prestamo10 y éste debe aceptarla o la solicitud no se procesará. Prestamo10 le enviará su política de privacidad. Si usted tiene unos términos diferentes deberá mantener la política de privacidad de Prestamo10. |
| accept * | Aceptación de los términos y condiciones por parte del solicitante. | 1 | Debe informar obligatoriamente al solicitante de los términos y condiciones para realizar la solicitud, y éste debe aceptarlos. Recibirá los términos y condiciones de Prestamo10. Si los modifica asegúrese de mantener los términos y condiciones originales. |
| a_ci * | Aceptación de la inclusión de los datos del cliente en el fichero CIREX | 1 | Debe informar obligatoriamente al solicitante de que sus datos serán incluidos en el fichero CIREX, recogiendo su consentimiento explícito. |
3.2.2 - Respuesta
| Parámetro | Descripción | Formato | Valores |
|---|---|---|---|
| ok | Indica si Préstamo10 ha aceptado la solicitud. La aceptación de una solicitud no implica la concesión del préstamo, pero sí la inclusión del nuevo cliente. | [0, 1] | 0 => No aceptada 1 => Aceptada |
| login | Usuario que el cliente usará para acceder a su área de cliente. | String | Es igual al email del cliente. |
| password | Password de acceso para el cliente. | String | Si se especificó password en la solicitud, es ese. Si no se genera uno aleatorio. |
| loginURL | URL del área privada del cliente | String | Ejemplo |
| autoLoginURL | URL específica para el cliente que hará un login automático la primera vez que se acceda | String | Ejemplo |
| loan | Identificador de la solicitud del cliente | String | Identificador numérico de la solicitud formateado a 8 dígitos, añadiendo ceros a la izquierda. Use este identificador para consultar el estado de la solicitud. |
| thankYouPage | Página intermedia para redirigir al cliente | String | Ejemplo |
| err | Cuando ok = 0 contiene un array con los errores detectados. | Array | Siguiente tabla |
| warn | Advertencias de errores leves que no implican la denegación de la solicitud. |
3.2.3 - Errores
| Error / Warning | Descripción |
|---|---|
| Wrong field [field name], removed | Se ha recibido un campo no permitido en el POST. Se elimina. |
| ‘[field name]’ is required | No se ha recibido uno un campo requerido. ok = 0 |
| ‘[field name]’ can’t be empty | Se ha recibido un valor vacío para un campo obligatorio. ok = 0 |
| duplicate-customer | El DNI/NIE pertenece a un cliente de Préstamo10. ok =0 |
| ‘requested’ must be between min and max | El importe de la solicitud es incorrecto. ok = 0 |
| ‘requested’ must be an integer | Se han incluido decimales en el importe solicitado. ok = 0 |
| ‘term’ must be between min and max days | Plazo incorrecto para el préstamo. ok = 0 |
| ‘a_sex’ wrong value, use 255 for male and 256 for female | Valor incorrecto para el campo a_sex. ok = 0 |
| Bad customer-DNI | DNI / NIE incorrecto. ok = 0 |
| Wrong format for ‘a_birthday’, use dd/mm/yyyy | Se indicó la fecha de nacimiento en un formato incorrecto. ok = 0 |
| Client is X years old, exceed age limit (Y) | La edad del solicitante no está dentro del rango aceptado por Préstamo10 (21…65). ok = 0 |
| ‘a_account’ is not a valid bank account | IBAN incorrecto. ok = 0 |
| ‘a_email’ is not a valid email | Email incorrecto. Se comprueba el formato y que el dominio exista. ok = 0 |
| ‘a_email’ already in use | El email pertenece a algún cliente de Préstamo10. ok = 0 |
| ‘a_gsm_number’ alredy in use | El teléfono móvil pertenece a algún cliente de Préstamo10. ok = 0 |
| ‘a_region’ has an invalid value, check documentation | El valor de a_region no es válido. ok = 0 |
| ‘a_pp’ must be 1 indicating that client accepts the privancy policy | El partner debe presentar al cliente la política de privacidad de Préstamo10 y éste debe aceptarla. ok = 0 |
| ‘accept’ must be 1 indicating that client accepts the terms and conditions | El partner debe presentar al cliente la política de privacidad de Préstamo10 y éste debe aceptarla. ok = 0 |
| ‘a_ci’ must be 1 indicating that client allows us to include his data on CIREX system | El partner debe presentar al cliente la información relativa a la política de Préstamo10 sobre el sistema CIREX y éste debe aceptarla. ok = 0 |
| ‘a_password’ must be at least 6 characters long if present | Si en los datos se indica el password para el cliente, éste debe tener al menos 6 caracteres. ok = 0 |
| Client not accepted (EC) | Préstamo10 no aceptará solicitudes para el cliente informado. EC es un código interno para identificar la causa concreta. |
| Otros errores | Si recibe cualquier otro mensaje de error, se trata de un error no controlado. Contacte con nosotros para resolverlo. |
3.3- Loan status
| Método | GET |
| URL | [https://api.prestamo10.com/v2/affiliate/loan_status/identificador] |
| URL test | [https://api.prestamo10.com/sandbox/affiliate/loan_status/identificador] |
Permite consultar el estado de una solicitud mediante su identificador.
La URL de test devolverá el estado de la solicitud. Tenga en cuenta que, al no continuar con el proceso, el estado será siempre el mismo.
3.3.1 - Parámetros
(* requeridos)
|Parámetro|Descripción|Formato|Valores|
|format|Permite especificar el formato de la respuesta. Por defecto json.|String|[xml, json, jsonp, serialized, php, html, csv]|
|X-API-KEY *|Clave del partner. Puede venir por GET, POST, o en el HEADER de la petición|String|La clave que le asignó Prestamo10 cuando le dio de alta.|
|[identificador]|Identificador que se recuperó al hacer la solicitud en al campo loan. Forma parte de la URL.
Ej: https:/…loan_status/00067852|String / Entero||
3.3.2 - Respuesta
|Parámetro|Descripción|Formato|Valores|
|ok|Indica si la consulta es correcta.|[0, 1]|0 => Identificador incorrecto, el partner no es quien registró la solicitud, …
1 => Consulta correcta|
|status|Estado en que se encuentra la solicitud sobre la que se pregunta|String|Ver siguiente tabla.|
|err|Si se produce un error contiene la descripción|Array|Unauthorized: el partner no es quien registró la solicitud|App not found: Error interno, contacte con nosotros.|
3.3.3 - Errores
Si consulta una solicitud que no existe o que no le corresponde a usted como partner recibirá un error Unauthorized. En cualquier otro caso recibirá el estado de la solicitud.
3.3.4 - Estados
| Mensaje | Descripción |
|---|---|
| [id] not yet processed | La solicitud está en la cola de proceso |
| [id] Denied, not valid | El sistema descartó la solicitud. |
| [id] Denied, client exists | Denegada porque el cliente ya existe |
| [id] Denied, client is reported | Denegada porque el cliente no se considera fiable |
| [id] Denied, duplicated | Ya existe una solicitud en cola para el mismo cliente |
| [id] Denied by scoring | El sistema descarta la solicitud por no considerar solvente al cliente |
| [id] Denied, PXL reports active loans | PréstamoXL informa que el usuario tiene préstamos abiertos. Se deniega para evitar sobreendeudamiento. |
| [id] Processing | Se está procesando la solicitud |
| [id] Unknow status | Estado desconocido, contacte con nosotros. |
| [id] App not found | Contacte con nosotros. |
| … (Archived) | Se indica además del estado de la solicitud. Indica que, independientemente de su estado final, esta solicitud se ha archivado y no se continuará procesando (ha caducado). |
| [id] Approved | Solicitud aprobada por Préstamo10 |
| [id] Rejected | Solicitud rechazada por Préstamo10 |
| [id] Rejected by client | Solicitud rechazada por el cliente |
| [id] Loan | Préstamo concedido |
4 - Tablas de referencia
4.1 - Sexo
| Valor | Clave |
|---|---|
| Hombre | 225 |
| Mujer | 226 |
4.2 - Tipo de documento de identidad
| Valor | Clave |
|---|---|
| DNI | 254 |
| NIE | 255 |
4.3 - Regiones
| Valor | Clave |
|---|---|
| Andalucía | 231 |
| Aragón | 232 |
| Asturias | 233 |
| Cantabria | 234 |
| Castilla la Mancha | 235 |
| Castilla León | 236 |
| Catalunya | 237 |
| Ceuta y Melilla | 238 |
| Comunitat Valenciana | 239 |
| Extremadura | 240 |
| Galicia | 241 |
| Islas Baleares | 242 |
| Islas Canarias | 243 |
| La Rioja | 244 |
| Madrid | 245 |
| Murcia | 246 |
| Navarra | 247 |
| País Vasco | 248 |
4.4 - Tipo de empleo
| Valor | Clave |
|---|---|
| Autónomo | 552 |
| Jornada completa | 45 |
| Media jornada | 46 |
| Sin empleo | 47 |
| Otros | 48 |
4.5 - Estados civiles
| Valor | Clave |
|---|---|
| Soltero / a | 39 |
| En pareja | 41 |
| Casado / a | 40 |
| Divorciado / a | 42 |
| Viudo / a | 43 |
4.6 - Nivel de estudios
| Valor | Clave |
|---|---|
| Bachillerato o FP | 251 |
| Diplomatura o Ingeniería Técnica | 252 |
| Graduado escolar | 250 |
| Licenciatura o Ineniería Superior | 253 |
| Si estudios | 249 |
4.7 - Vivienda
| Valor | Clave |
|---|---|
| Es propietario | 227 |
| Vivienda alquilada | 228 |
| Vive con los padres | 229 |
| Otros | 230 |