Front Dinámico

Apis para integración con front dinámico

Generar Token Seguridad

POST /token

Generar Url Webview

POST /v1/generaUrlTokenFrontDinamico

POST /token

Servicio de generación de token de autenticación.

Cliente: Geopagos Proveedor: APIs Front dinámico

URL QA: https://access.intvnt.com/auth/realms/procesamiento-qa/protocol/openid-connect/token

Request body

Object

grant_type

string

Estatico: client_credentials

Example:

client_credentials

client_id

string

provisto por Vendemás

Example:

xxxxxxxx

client_secret

string

provisto por Vendemás

Example:

xxxxxxx

Responses

200 OK

Body

Object

access_token

string

Token de acceso para consumo de API generarUrl

Example:

eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJGd1k3RWk5dnplVVlhbzhEVVF2dlFvLTdCWmdjODV2ZHcwdTQtazk5OXR3In0.eyJqdGkiOiJiN2I3YzUzZC1iNTlhLTQxZTMtYmMxMy1jZjgyNmI5N2E5ZGEiLCJleHAiOjE2MjAxNDk0MDgsIm5iZiI6MCwiaWF0IjoxNjIwMTQ5MTA4LCJpc3MiOiJodHRwczovL3NlY3VyZS1zc28tc3NvLW9jcC5hcHBzLmludHZudC5jb20vYXV0aC9yZWFsbXMvaW50ZWdyYWNpb24iLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiMmEyZDY3MmEtZjYwZi00ZTNiLTllNmEtMGEyNThiMDQxZTMzIiwidHlwIjoi

expires_in

integer

tiempo de expiración del token (debe generarse un nuevo token por cada petición)

Example:

300

refresh_expires_in

integer

tiempo de expiración del token

Example:

1800

refresh_token

string

Token de refresco

Example:

token_type

string

tipo de token. estático: bearer

Example:

bearer

not-before-policy

integer

Example:

13465278524

session_state

string

Example:

d3267e22-adcf-11eb-8529-0242ac130003

scope

string

Example:

email profile

POST /v1/generaUrlTokenFrontDinamico

Authentication

OAuth2

API para generación de URl a renderizar en Front dinámico

Cliente: Geopagos Proveedor: APIs Front dinámico

URL QA: https://<<host>>/v1/generaUrlTokenFrontDinamico

Request headers

Content-Type

string optional

estático: application/json

Example:

application/json

authorization

string optional

Token de autenticación provisto por servicio Generar Token

Example:

Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJGd1k3RWk5dnplVVlhbzhEVVF2dlFvLTdCWmdjODV2ZHcwdTQtazk5OXR3In0.eyJqdGkiOiJiN2I3YzUzZC1iNTlhLTQxZTMtYmMxMy1jZjgyNmI5N2E5ZGEiLCJleHAiOjE2MjAxNDk0MDgsIm5iZiI6MCwiaWF0IjoxNjIwMTQ5MTA4LCJpc3MiOiJodHRwczovL3NlY3VyZS1zc28tc3NvLW9jcC5hcHBzLmludHZudC5jb20vYXV0aC9yZWFsbXMvaW50ZWdyYWNpb24iLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiMmEyZDY3MmEtZjYwZi00ZTNiLTllNmEtMGEyNThiMDQxZTMzIiwidHlwIjoi

Request body

Object

dateTime

string required

Fecha y Hora enviada desde el terminal en formato “yyyyMMddHH24mmss” donde: yyyy: año, MM: mes, dd: dia, HH: hora, mm: minutos, ss: segundos

Pattern: yyyyMMddHH24mmss

Example:

20210510142100

clientId

string required

Es el código del cliente. Estático provisto por Procesamiento-Niubiz

Max length: 6

Example:

clientName

string

Es el nombre del Cliente. Estático provisto por Procesamiento-Niubiz

Max length: 40

Example:

GEOPAGOS

programId

string required

Es el código del programa. Estático provisto por Procesamiento-Niubiz

Max length: 6

Example:

programName

string

Es el nombre del programa. Estático provisto por Procesamiento-Niubiz

Max length: 40

Example:

GEOPAGOS

channelld

string required

Es el código del Canal

Enumeration:

Android

IOS

Huawei

channelName

string

Es el nombre del Canal

Max length: 40

Example:

Android

projectId

string required

Es el código del proyecto. Estático provisto por Procesamiento-Niubiz

Max length: 6

Example:

projectName

string

Nombre del proyecto. Estático provisto por Procesamiento-Niubiz

Max length: 40

Example:

VENDEMAS

userId

string

Id de usuario en la base de datos del sistema asociado para login

Example:

123241

dataMap

Object required

sectionId

string required

Es el código de la sección. Estático provisto por Procesamiento-Niubiz

Max length: 6

Example:

sectionName

string

Nombre de la sección. Estático provisto por Procesamiento-Niubiz

Max length: 40

Example:

RECARGAS

merchantId

string required

Código del comercio (logueado en app)

Max length: 9

Example:

035214214

merchantName

string

Nombre completo del comercio (formateado para json utf8)

Max length: 100

Example:

IMPORTACIONES Y SERVICIOS SAC

coreAccountId

string required

Llave del comercio en backend Account ID

Example:

ownerId

string required

Llave del comercio en backend Owner ID

Example:

cardAcceptorId

string required

Llave del comercio en backend “Acceptor ID”

Example:

terminalId

string required

Llave del comercio en backend “Terminal ID”

Example:

emailUser

string required

Email del usuario en sesion

Example:

jcamacho@vendemas.niubiz.com.pe

codeMcc

string required

Codigo MCC de Comercio

Example:

5812

merchantLogo

string required

Ruta del logo del comercio

Example:

https://backend.geopagos.com/comercio/2345345/logo.png

geolocation

string

Localizacion del instante donde es usada el front dinamico

Pattern: X,Y

Responses

200 OK

Body

Object

responseCode

string required

Código de Respuesta

Enumeration:

Correcto

Error de sistema

Trama de petición del request no válida (max length y obligatoriedad)

Error controlado

responseMessage

string required

Mensaje de respuesta del servicio

Example:

EXITO

object

Object

url

string required

Url para renderizar en el webview

Example:

https://wv-front.qa.vmas.com.pe/marketplace/gateway/21af4f8c66a3d50233d6ac90adf581116c332e829fa205194ec6a31d2d881780bdf10d03479924db7cb885371517f8b0

token

string required

Token para rastrear todo el proceso en providers y en front dinamico

Example:

21af4f8c66a3d50233d6ac90adf581116c332e829fa205194ec6a31d2d881780bdf10d03479924db7cb885371517f8b0

403 Forbidden

text/plain

Examples

Ejemplo con 00 = Exito

POST /v1/generaUrlTokenFrontDinamico HTTP/1.1 

Content-Type: application/json

{
    "dateTime": "20210609172525",
    "clientId": "1",
    "clientName": "GEOPAGOS",
    "programId": "1",
    "programName": "GEOPAGOS",
    "channelId": "1",
    "channelName": "Android",
    "projectId": "1",
    "projectName": "VENDEMAS",
    "userId":"4551562",
    "dataMap": {
        "sectionId": "1",
        "sectionName": "RECARGAS",
        "merchantId": "035214214",
        "merchantName": "IMPORTACIONES Y SERVICIOS SAC",
        "coreAccountId": "4354645745745fdfgdfg",
        "ownerId": "54gfdg45gfdgh",
        "cardAcceptorId": "dfhgdfy5345235",
        "terminalId": "435fdgdsgt",
        "emailUser": "jcamacho@vendemas.niubiz.com.pe",
        "codeMcc": "5812"
    },
    "merchantLogo": "https://backend.geopagos.com/comercio/2345345/logo.png",
    "geolocation": "-12,15"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "responseCode": "00",
    "responseMessage": "EXITO",
    "object": {
        "url": "https://d29d8oq682bpuu.cloudfront.net/#/token/567d2ff733490a9cf13bbb95016e7b651168b602f583f0759df5e5aee2fdca90.eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJuNHA4YURxcURaeU45aTN5aGRkbDZzeUQ0Qi1SM2lwQW1pWlZvY19EUkQwIn0.eyJleHAiOjE2Njk3NTMwMDMsImlhdCI6MTY2OTczNTAwMywianRpIjoiYTVkNDVjYjQtMzRmZC00MWRlLWIxZDUtZmRiYTE2MWVhYTQ0IiwiaXNzIjoiaHR0cHM6Ly9hY2Nlc3MuaW50dm50LmNvbS9hdXRoL3JlYWxtcy9wcm9jZXNhbWllbnRvLXFhIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6IjhjNDBiY2JhLTgzMjEtNGNlYi05MTEyLTJkYzMyNmY3MGM5OSIsInR5cCI6IkJlYXJlciIsImF6cCI6IjcwZTBmOTY4IiwiYWNyIjoiMSIsInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJwcm9maWxlIGVtYWlsIiwiY2xpZW50SWQiOiI3MGUwZjk2OCIsImNsaWVudEhvc3QiOiIxNzcuOTEuMjUzLjYiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsInByZWZlcnJlZF91c2VybmFtZSI6InNlcnZpY2UtYWNjb3VudC03MGUwZjk2OCIsImNsaWVudEFkZHJlc3MiOiIxNzcuOTEuMjUzLjYifQ.U0_mo9cxU_96lAXMq5qItV5vcU-G-R_2-kPb9DGZ4yHSjAtQIzFHrmTUDDJLp4DX6aLUqrdN3OkHrJ5dlDLNRn0bDTQrUd5xJfD3lFLJGZC7FF__mKWNz_Ysamo4iAkQd20X3K-0xenw4jWkTsV1o--RYh2znYPxfVPNhtO_a2WeqVgVmLEUL-Kk3rTg2-YodCqpF6VHDjh30G0uKCn4g85GS9s17L0h9QnrerVibLJpljCqaigsks7aYiIH8jeFIcBUVA-08t9hAWuqQsbPFypPFjcT0iimM3fqmmr3MWWg_SHDEjBg9P7etdj6zuohaKtZ9zf_5hOzq7XEGofalQ",
        "token": "567d2ff733490a9cf13bbb95016e7b651168b602f583f0759df5e5aee2fdca90"
    }
}

Callback Transacciones

POST /v1/registrarTransaccion

Permitirá registrar una transaccion en el proveedor respectivo

Request body

Object

tokenFront

string required

Token de la sesion de front dinamico

Example:

21af4f8c66a3d50233d6ac90adf581116c332e829fa205194ec6a31d2d881780bdf10d03479924db7cb885371517f8b0

datetime

string required

Fecha en que se realizó la transacción (unixtimestamp), no debe ser de una fecha superior al momento donde se ejecuta el registro

responseCode

string required

Código de respuesta del API

Enumeration:

Aprobado

Denegado

Error controlado

Error no esperado

responseMessage

string required

Detalle de respuesta del servicio

Example:

Saldo: 885.639,77

retrievalReferenceNumber

string required

Valor string (numérico de 12-15 longitud) que identifica la operación

Example:

909717603696

authorizationId

string required

Código de trackeo

Example:

68696

messageType

string

Identificador de la operación (campo legacy)

Example:

authorization

productCode

string required

Para saber si es recarga o servicio

Enumeration:

services

Pago de servicios

recharge

Recarga de celulares u otros

activate

Activación de Tarjetas

balance

Saldo de Tarjeta TPP

systemTraceNumber

string required

Numero de rastreo

serviceData

Object required

amount

string required

Monto de la recarga o del pago de servicio

Example:

20.4

currencyCode

string required

Moneda

Enumeration:

604

Soles

serviceName

string required

Nombre de la empresa

Example:

Claro, Bitel, Entel, DirectTV

customerServiceId

string required

Número de la entidad recarga, o del codigo del servicio pagado

Examples:

942470933 (telefono)43423535235235523 (tarjeta de transporte)66421415 (Número del suministro luz del sur)

productName

string required

Nombre del producto

Example:

3PLAY

customerName

string

Nombre del cliente del servicio afectado

Example:

FLORES MA (ejem Fullcarga)

receiptNumber

string

Numero del recibo

description

string

Descripcion adicional

Example:

Compra con pagoEfectivo

coreAcctInitialBalance

number

Saldo inicial del comercio

Example:

293.555

earnedFee

string required

Comisión ganada por el comercio

Example:

0.600

coreAcctCurrentBalance

number

Saldo final del comercio

Example:

264.355

Responses

200 OK

Body

Object

codigoRespuesta

string required

Codigo de respuesta del registro

Enumeration:

Correcto

Error interno

Trama errada

Example:

mensajeRespuesta

string required

Resultado de la operacion

Example:

EXITO

token

string required

Token de rastreo de transaccion entre provider y Front Dinamico

Example:

66a3d50233d6ac90adf581116c332e829fa205194ec6a31d2d881780bdf10d03479924db7cb885371517f8b0