Marketplace API

Proyecto que disponibiliza operaciones para la integración de las entidades financieras con el nuevo marketplace. Para todas las operaciones del catálogo es necesario autenticarse en el servidor Oauth2 para generación de token, mismo que debe viajar por header en cada petición del API.

Autenticación:

https://auth2.qa.vmas.com.pe/vm-api-autorizacion/oauth/token

Generación de token para el uso de los servicios del api prestamos

Generar Token

Marketplace Base URL:

https://api-marketplace.qa.vmas.com.pe/v1/

Códigos de estado:

00 : EXITO
10 : Error Interno
50 : El comercio ya tiene un contrato asignado (Creacion Oferta)
51 : El código de oferta original ya fue registrado (Creacion Oferta)
52 : El código de oferta original no se encuentra registrado (Cancelar Oferta)
53 : El código de oferta original ya se encuentra cancelado (Cancelar Oferta)

POST /v1/creacionOferta

Servicio que permite generar una nueva oferta de prestamo al comercio en el marketplace

Request body

Object

fecha

string

Fecha de la transacción

Example:

2021-01-05

hora

string

Hora de la transacción

Example:

16:31:15

cliente

string

Código de cliente, a cada proveedor se le dará un código respectivo

Example:

ENTIDAD1

programa

string

Programa de cliente, a cada proveedor se le dará un código respectivo

Example:

PROGRAMA1

datos

Object

codigoComercio

string

Código NBO del cliente

Example:

843634989

montoPrestamo

number required

Monto del prestamo. Máximo dos decimales

Example:

492.25

valorCuota

number

Valor de la cuota. Máximo dos decimales

Example:

40.4

idOriginalOferta

string

Id de oferta en plataforma del cliente

Example:

abc-123-bxo

cantidadCuotas

integer

Número de cuotas

Example:

fechaVigencia

string

Fecha limite en el cual aparecera la oferta en el marketplace

Example:

2020-01-10

frecuenciaCobro

string

Frecuencia de cobro

Example:

Diario, Semanal y Mensual

tasa

number required

Tasa efectiva mensual de interes. Máximo dos decimales

Example:

Examples

{
    "fecha": "2021-01-05",
    "hora": "16:31:15",
    "cliente": "ENTIDAD1",
    "programa": "PROGRAMA1",
    "datos": {
        "codigoComercio": "843634989",
        "montoPrestamo": 492.25,
        "valorCuota": 40.4,
        "idOriginalOferta": "abc-123-bxo",
        "cantidadCuotas": 15,
        "fechaVigencia": "2020-01-10",
        "frecuenciaCobro": "Diario",
        "tasa": 25
    }
}

Responses

200 OK

Body

Object

fecha

string

Fecha de la transacción

Example:

2020-01-05

hora

string

Hora de la transaccion

Example:

17:54:25

cliente

string

Código de cliente, a cada proveedor se le dará un código respectivo

Example:

ENTIDAD1

programa

string

Programa de cliente, a cada proveedor se le dará un código respectivo

Example:

PROGRAMA1

codigoRespuesta

string

Código respuesta del endpoint

Example:

mensajeRespuesta

string

Mensaje de respuesta del endpoint

Example:

EXITO

operacion

string

Nombre de la operación

Example:

creacionOferta

datos

Object

idOferta

string

Código generado para la oferta en plataforma vendemas

Example:

1234512

idOriginalOferta

string

Id de oferta en plataforma del cliente (Referencia si se quiere cancelar la oferta)

Example:

abc-123-bxo

Examples

{
    "fecha": "2020-01-05",
    "hora": "17:54:25",
    "cliente": "ENTIDAD1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "creacionOferta",
    "datos": {
        "idOferta": "1234512",
        "idOriginalOferta": "abc-123-bxo"
    }
}

POST /v1/cancelarOferta

Servicio que permite cancelar la oferta de prestamo que se encuentra en el marketplace

Request body

Object

fecha

string

Fecha de la transaccion

Example:

2021-01-05

hora

string

Hora de la transacción

Example:

16:31:15

cliente

string

Código de cliente, a cada proveedor se le dará un código respectivo

Example:

ENTIDAD1

programa

string

Programa de cliente, a cada proveedor se le dará un código respectivo

Example:

PROGRAMA1

datos

Object

idOriginalOferta

string

Id de oferta en plataforma del cliente (Referencia si se quiere cancelar la oferta)

Example:

abc-123-bxo

Examples

{
    "fecha": "2021-01-05",
    "hora": "16:31:15",
    "cliente": "ENTIDAD1",
    "programa": "PROGRAMA1",
    "datos": {
        "idOriginalOferta": "abc-123-bxo"
    }
}

Responses

200 OK

Body

Object

fecha

string

Fecha de la transaccion

Example:

2021-01-05

hora

string

Hora de la transacción

Example:

16:31:15

cliente

string

Código de cliente, a cada proveedor se le dará un código respectivo

Example:

ENTIDAD1

programa

string

Programa de cliente, a cada proveedor se le dará un código respectivo

Example:

PROGRAMA1

codigoRespuesta

string

Código respuesta del endpoint

Example:

mensajeRespuesta

string

Mensaje de respuesta del endpoint

Example:

EXITO

operacion

string

Nombre de la operación

Example:

cancelacionOferta