Recargas-Servicios

Operaciones
Seguridad
POST /auth/realms/rys-qa/protocol/openid-connect/
Autenticación
POST /auth/realms/rys-qa/protocol/openid-connect/

La ruta de este endpoint en QA es https://access.intvnt.com/auth/realms/rys-qa/protocol/openid-connect/token Esto nos devolverá un token el cual mandaremos en la cabecera “Authorization” a cada peticion de recargas-servicios en la forma “Bearer <<token>>”

Request body

application/x-www-form-urlencoded
Object
client_id
string required

Identificador

client_secret
string required

Hash de cliente

grant_type
string required

Tipo de solicitud

Examples

Valores de ejemplo que van como parte del formulario

{
    "client_id": "2d3aeabc",
    "client_secret": "217129777a2ebb65359061e61df007c8",
    "grant_type": "client_credentials"
}

Responses

200 OK
Body
Object
access_token
string

Este valor es el que pasaremos en el header para autenticar a cada petición a recargas

Example:
eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJjV3RyOS1ZckNtcEc0ZFVvb3VzSzVnZ21IUlg2MlJOblBDS0lKeHVHMG1vIn0.eyJqdGkiOiI1ZTFjNmE2MS1hM2M4LTQ3YTctYmM4Mi0zMWJlMzdlMzcyNTQiLCJleHAiOjE2MTQyNjk4ODQsIm5iZiI6MCwiaWF0IjoxNjE0MjY5NTg0LCJpc3MiOiJodHRwczovL2FjY2Vzcy5pbnR2bnQuY29tL2F1dGgvcmVhbG1zL3J5cy1xYSIsImF1ZCI6ImFjY291bnQiLCJzdWIiOiI3YWE3MDg4ZS1jZWQ3LTQyMDQtOTBlNi0zMjkxY2MyNTgyZWYiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiIyZDNhZWFiYyIsImF1dGhfdGltZSI6MCwic2Vzc2lvbl9zdGF0ZSI6IjJjMzQwODQ1LWQwMDMtNDEwZC05M2I2LWFiZWMzN2Y5ODlkMyIsImFjciI6IjEiLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsib2ZmbGluZV9hY2Nlc3MiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoiZW1haWwgcHJvZmlsZSIsImNsaWVudEhvc3QiOiJpcC0xMC0yMTktMjQwLTY4LmVjMi5pbnRlcm5hbCIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiY2xpZW50SWQiOiIyZDNhZWFiYyIsInByZWZlcnJlZF91c2VybmFtZSI6InNlcnZpY2UtYWNjb3VudC0yZDNhZWFiYyIsImNsaWVudEFkZHJlc3MiOiIxMC4yMTkuMjQwLjY4IiwiZW1haWwiOiJzZXJ2aWNlLWFjY291bnQtMmQzYWVhYmNAcGxhY2Vob2xkZXIub3JnIn0.fbL-drMRvXyPQoElZ9ctC2Eh_mXzleKLoHokw6hpNN65DuS97JpqtB3bimhGHnQD6q-13-Bxq-YFeN-6GmJEqKbOByns_0dC7ZpDJGohx_SVgM-sKVOCAsSy-zjBCOBEzR823m94T8XS2a4wrcz6yRCkqOlWUMGrt0Qvh5zx30yIiPfKfcp6PmJQqnmDt5sSr87kLpkyn0SAISn2JOBdGDCQei94Wq_LgU3NVOeI7vSITJ8sBQ-NXagRrr2AhlSxCg3leD9UBJR46XMBZzgiMRXypjNmxiYHNmW9aJGav2Py4MryA5uZdqGiO9Vf3wig3LmdIyfANsDQPB8wqu5THA
expires_in
integer
Example:
298
refresh_expires_in
integer
Example:
1799
refresh_token
string
Example:
eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI5YzliZTU1OS00ZGY0LTRmZGUtOWJiZS0wMGQwODIyNzY2YTkifQ.eyJqdGkiOiI5MDRlODQxMS1mZmRmLTQ5NzYtYTBhNS1iYjUyNjlkMGQyOTQiLCJleHAiOjE2MTQyNzEzODYsIm5iZiI6MCwiaWF0IjoxNjE0MjY5NTg2LCJpc3MiOiJodHRwczovL2FjY2Vzcy5pbnR2bnQuY29tL2F1dGgvcmVhbG1zL3J5cy1xYSIsImF1ZCI6Imh0dHBzOi8vYWNjZXNzLmludHZudC5jb20vYXV0aC9yZWFsbXMvcnlzLXFhIiwic3ViIjoiN2FhNzA4OGUtY2VkNy00MjA0LTkwZTYtMzI5MWNjMjU4MmVmIiwidHlwIjoiUmVmcmVzaCIsImF6cCI6IjJkM2FlYWJjIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiMmMzNDA4NDUtZDAwMy00MTBkLTkzYjYtYWJlYzM3Zjk4OWQzIiwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwidW1hX2F1dGhvcml6YXRpb24iXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6ImVtYWlsIHByb2ZpbGUifQ.LhOwNS4b7dYnk63cDo9JcnmU3EJMAwT6AhAuOwqjBA0
token_type
string
Example:
bearer
not-before-policy
integer
Example:
0
session_state
string
Example:
2c340845-d003-410d-93b6-abec37f989d3
scope
string
Example:
email profile
Examples
{
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJjV3RyOS1ZckNtcEc0ZFVvb3VzSzVnZ21IUlg2MlJOblBDS0lKeHVHMG1vIn0.eyJqdGkiOiI1ZTFjNmE2MS1hM2M4LTQ3YTctYmM4Mi0zMWJlMzdlMzcyNTQiLCJleHAiOjE2MTQyNjk4ODQsIm5iZiI6MCwiaWF0IjoxNjE0MjY5NTg0LCJpc3MiOiJodHRwczovL2FjY2Vzcy5pbnR2bnQuY29tL2F1dGgvcmVhbG1zL3J5cy1xYSIsImF1ZCI6ImFjY291bnQiLCJzdWIiOiI3YWE3MDg4ZS1jZWQ3LTQyMDQtOTBlNi0zMjkxY2MyNTgyZWYiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiIyZDNhZWFiYyIsImF1dGhfdGltZSI6MCwic2Vzc2lvbl9zdGF0ZSI6IjJjMzQwODQ1LWQwMDMtNDEwZC05M2I2LWFiZWMzN2Y5ODlkMyIsImFjciI6IjEiLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsib2ZmbGluZV9hY2Nlc3MiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoiZW1haWwgcHJvZmlsZSIsImNsaWVudEhvc3QiOiJpcC0xMC0yMTktMjQwLTY4LmVjMi5pbnRlcm5hbCIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiY2xpZW50SWQiOiIyZDNhZWFiYyIsInByZWZlcnJlZF91c2VybmFtZSI6InNlcnZpY2UtYWNjb3VudC0yZDNhZWFiYyIsImNsaWVudEFkZHJlc3MiOiIxMC4yMTkuMjQwLjY4IiwiZW1haWwiOiJzZXJ2aWNlLWFjY291bnQtMmQzYWVhYmNAcGxhY2Vob2xkZXIub3JnIn0.fbL-drMRvXyPQoElZ9ctC2Eh_mXzleKLoHokw6hpNN65DuS97JpqtB3bimhGHnQD6q-13-Bxq-YFeN-6GmJEqKbOByns_0dC7ZpDJGohx_SVgM-sKVOCAsSy-zjBCOBEzR823m94T8XS2a4wrcz6yRCkqOlWUMGrt0Qvh5zx30yIiPfKfcp6PmJQqnmDt5sSr87kLpkyn0SAISn2JOBdGDCQei94Wq_LgU3NVOeI7vSITJ8sBQ-NXagRrr2AhlSxCg3leD9UBJR46XMBZzgiMRXypjNmxiYHNmW9aJGav2Py4MryA5uZdqGiO9Vf3wig3LmdIyfANsDQPB8wqu5THA",
    "expires_in": 298,
    "refresh_expires_in": 1800,
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI5YzliZTU1OS00ZGY0LTRmZGUtOWJiZS0wMGQwODIyNzY2YTkifQ.eyJqdGkiOiI5MDRlODQxMS1mZmRmLTQ5NzYtYTBhNS1iYjUyNjlkMGQyOTQiLCJleHAiOjE2MTQyNzEzODYsIm5iZiI6MCwiaWF0IjoxNjE0MjY5NTg2LCJpc3MiOiJodHRwczovL2FjY2Vzcy5pbnR2bnQuY29tL2F1dGgvcmVhbG1zL3J5cy1xYSIsImF1ZCI6Imh0dHBzOi8vYWNjZXNzLmludHZudC5jb20vYXV0aC9yZWFsbXMvcnlzLXFhIiwic3ViIjoiN2FhNzA4OGUtY2VkNy00MjA0LTkwZTYtMzI5MWNjMjU4MmVmIiwidHlwIjoiUmVmcmVzaCIsImF6cCI6IjJkM2FlYWJjIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiMmMzNDA4NDUtZDAwMy00MTBkLTkzYjYtYWJlYzM3Zjk4OWQzIiwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwidW1hX2F1dGhvcml6YXRpb24iXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6ImVtYWlsIHByb2ZpbGUifQ.LhOwNS4b7dYnk63cDo9JcnmU3EJMAwT6AhAuOwqjBA0",
    "token_type": "bearer",
    "not-before-policy": 0,
    "session_state": "2c340845-d003-410d-93b6-abec37f989d3",
    "scope": "email profile"
}
Pago de Servicios
Rimac Seguros
POST /api/2.1.0/rysServices
POST /api/2.1.0/rysServices
Consulta de Placa
POST /api/2.1.0/rysServices

Servicio para consultar la placa de la cual pagaremos la póliza (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "",
    "providerCode": "900003",
    "companyCode": "700001",
    "customerServiceId": "AMA611",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "traceId": "",
            "timestamp": "09/16/2020 12:42:43",
            "placaVigente": "AMA611",
            "codUsoVehiculo": "004",
            "desusoVehiculo": "AMBULANCIA",
            "codTipoPersona": "001",
            "desTipoPersona": "JURIDICA",
            "fechaInicio": "2020-09-16"
        }
    }
}

Responses

200 OK
Body
Examples

Ejemplo todo OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "servicePayment",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "response": {
            "trace": {
                "traceId": "1fd222ae5ae1bebba0c8733d3ed76806c998c92b2857f98c9645516969ea725130bc20735b807bac4b21b3a2a097f9ed65b9a1c3762ef56526de03f6176c666bfac1351a0b2607d23dad737a0717b605b777df53cc48359dc6b700c9c7337fde",
                "consumerId": "ID_APP_BROKER",
                "serviceId": "API-CANAL",
                "moduleId": "ID_MODULE_APP_BROKER",
                "channelCode": "WEB",
                "timestamp": "1600278165983",
                "copyright": "RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados"
            },
            "payload": {
                "cotizacion": "57ab6452-779f-41c4-a88c-39fb15c90134",
                "primaNeta": 69.93,
                "primaBruta": 85,
                "indicadorInspeccion": 1,
                "financiamiento": 821,
                "fechaInicio": "2020-09-16",
                "fechaFinal": "2021-09-16",
                "numeroCuotas": 1,
                "cuotasFinanciamiento": [
                    {
                        "cuota": 1,
                        "monto": 85,
                        "fechaVencimiento": "2020-10-16"
                    }
                ]
            },
            "status": {
                "success": "true"
            }
        }
    },
    "expires_in": "300"
}

Ejemplo NO OK Controlado

{
    "retrievalReferenceNumber": "343547348471",
    "authorizationId": "31615",
    "responseCode": "00",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "7f9cea29-a558-4a06-b2e4-6bb6af7bc614",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/343547348471",
        "method": "get"
    },
    "serviceData": {
        "response": {
            "trace": {
                "traceId": "775958701ff3a62b4084b332b3b7c4d78aebd4b4aa1",
                "consumerId": "ZUM",
                "serviceId": "API-CANAL",
                "moduleId": "ZUM",
                "channelCode": "WEB",
                "timestamp": 1597442551245,
                "copyright": "RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados"
            },
            "payload": null,
            "status": {
                "success": false,
                "error": {
                    "code": "000097",
                    "httpCode": 400,
                    "messages": [
                        "data/datosParticulares/0 debe tener la propiedad requerida valor",
                        "data/datosParticulares/1 debe tener la propiedad requerida valor"
                    ]
                }
            }
        }
    },
    "expires_in": 300
}

Ejemplo no OK - Otro

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}
Pago de Placa
POST /api/2.1.0/rysServices

Servicio para pagar la póliza del vehículo consultado previamente (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "servicepayment",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "554897499035",
    "providerCode": "900001",
    "companyCode": "700002",
    "customerServiceId": "AMA611",
    "amount": 85,
    "currencyCode": "604",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "traceId": "554897499035",
            "tipoDocumento": "2",
            "numeroDocumento": "12345678",
            "cotizacion": "57ab6452-779f-41c4-a88c-39fb15c90134",
            "desusoVehiculo": "PARTICULAR",
            "monto": "85",
            "correo": "jcamacho@vendemas.niubiz.com.pe",
            "telefono": "987654321"
        }
    }
}

Responses

200 OK
Body
Examples

Ejemplo OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "servicePayment",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "response": {
            "trace": {
                "traceId": "6b10480f-af20-4676-a8e0-1df84dd7cdb6",
                "consumerId": "ID_APP_BROKER",
                "serviceId": "API-CANAL",
                "moduleId": "ID_MODULE_APP_BROKER",
                "channelCode": "WEB",
                "copyright": "RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados"
            },
            "payload": {
                "cotizacion": "bfa43d46-2322-4efb-b6a1-9085dc218bf9",
                "poliza": "2101-16897",
                "primaNeta": 1,
                "primaBruta": "1213.52",
                "indicadorInspeccion": "0",
                "indicadorGps": "0",
                "envioElectronico": "S",
                "financiamiento": "1753",
                "fechaInicio": "2019-07-23",
                "fechaFinal": "2020-07-23",
                "numeroCuotas": 12,
                "cuotasFinanciamiento": [
                    {
                        "cuota": 1,
                        "monto": 1,
                        "fechaVencimiento": "2019-07-30"
                    }
                ],
                "contratante": {
                    "tercero": 25752127,
                    "tipoDocumento": "1",
                    "numeroDocumento": "43461755",
                    "apellidoMaterno": "CUMPA",
                    "apellidoPaterno": "PAEZ",
                    "nombres": "JORGE ANTONIO",
                    "fechaNacimiento": "1985-12-04",
                    "sexo": "M",
                    "tipoVia": "CL",
                    "nombreVia": "IMAGINARIA",
                    "numeroVia": "29",
                    "distrito": "150103",
                    "nombreDistrito": "ATE",
                    "correo": "correo@gmail.com",
                    "telefono": "987654321"
                },
                "responsablePago": {
                    "tercero": "25752127",
                    "tipoDocumento": "1",
                    "numeroDocumento": "43461755",
                    "apellidoMaterno": "CUMPA",
                    "apellidoPaterno": "PAEZ",
                    "nombres": "JORGE ANTONIO",
                    "fechaNacimiento": "1985-12-04",
                    "sexo": "M",
                    "tipoVia": "CL",
                    "nombreVia": "IMAGINARIA",
                    "numeroVia": "29",
                    "distrito": "150103",
                    "nombreDistrito": "ATE",
                    "correo": "correo@gmail.com",
                    "telefono": "1234566789"
                },
                "asegurado": {
                    "tercero": 1,
                    "tipoDocumento": "2",
                    "numeroDocumento": "",
                    "apellidoMaterno": "",
                    "apellidoPaterno": "",
                    "nombres": "",
                    "fechaNacimiento": "",
                    "sexo": "",
                    "tipoVia": "",
                    "nombreVia": "",
                    "numeroVia": "",
                    "distrito": "",
                    "nombreDistrito": "",
                    "correo": "",
                    "telefono": ""
                },
                "endosatario": {
                    "porcentajeParticipacion": 100,
                    "monto": "22953"
                }
            },
            "status": {
                "success": "true"
            }
        }
    },
    "expires_in": "300"
}

Ejemplo NO OK Controlado

{
    "retrievalReferenceNumber": "452-dd1d-dd1d-dd2",
    "authorizationId": "78661",
    "responseCode": "00",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "60604049-2139-4ecd-bb2d-1f63c21b3532",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/452-dd1d-dd1d-dd2",
        "method": "get"
    },
    "serviceData": {
        "response": {
            "trace": {
                "traceId": "1fd222ae5ae1bebba0c8733d3ed76806c998c92b2857f98c9645516969ea7251c6c5d5157c9368a32048ccdd5cdfe14fc641a6e48acfcb4b113aae32e153f413bfa7f6e23cf0cd78c069b1c14d7899e9c26ffe442e13c3ca7f758f2273bcb169",
                "consumerId": "ID_APP_BROKER",
                "serviceId": "API-CANAL",
                "moduleId": "ID_MODULE_APP_BROKER",
                "channelCode": "WEB",
                "timestamp": 1589562590528,
                "copyright": "RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados"
            },
            "payload": null,
            "status": {
                "success": false,
                "error": {
                    "code": "000097",
                    "httpCode": 400,
                    "messages": "El/La PLACA_DE_RODAJE -> AMA611, tiene un Seguro Vigente."
                }
            }
        }
    },
    "expires_in": 300
}

Ejemplo no OK - Otro

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}
Banbif
POST /api/2.1.0/rysServices
POST /api/2.1.0/rysServices
Consulta de Servicio Banbif
POST /api/2.1.0/rysServices

Servicio para consultar el CODIGO del recibo, suministro, etc que pagaremos (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "servicepayment",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "906805311445",
    "providerCode": "900001",
    "companyCode": "700001",
    "customerServiceId": "543410",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "codigoConvenio": "2",
            "idServicio": "543410",
            "idTransaccionOrigen": "20200916054748",
            "fechaHora": "20200916054748"
        }
    }
}

Responses

200 OK
Body
Examples

Respuesta OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "meta": {
            "mensajes": [
                {
                    "codigo": "ESM00",
                    "mensaje": "Proceso Exitoso",
                    "tipo": "info"
                }
            ],
            "totalRegistros": 1,
            "idTransaccion": "590626774843027"
        },
        "datos": [
            {
                "fechaVencimiento": "2020-02-21",
                "cliente": {
                    "id": ""
                },
                "glosaCampana": "PAGO DE RECIBOS SOLES CALIDDA",
                "montoSaldoOrigen": 1,
                "montoDescuentoOrigen": 1,
                "montoMultaOrigen": 1,
                "montoVencidoOrigen": 1,
                "montoInteresOrigen": 1,
                "montoReajusteOrigen": 1,
                "montoTotalOrigen": 1,
                "montoSaldoDestino": 1,
                "montoDescuentoDestino": 1,
                "montoMultaDestino": 1,
                "montoVencidoDestino": 1,
                "montoInteresDestino": 1,
                "montoReajusteDestino": 1,
                "montoTotalDestino": 1,
                "montoRedondeo": 1,
                "comisionCliente": 1,
                "documento": {
                    "numero": "S00100136783"
                },
                "idConsulta": "7022724",
                "convenio": {
                    "codigo": "13"
                },
                "servicios": [
                    {
                        "id": "543408"
                    }
                ],
                "moneda": "SOL",
                "fechaFactura": "2020-02-06",
                "datosAdicionales": [
                    {
                        "nombre": "Nombre",
                        "valor": "20200206"
                    }
                ]
            }
        ]
    },
    "expires_in": "300"
}

Contrato Respuesta NOOK- Controlado

{
	"retrievalReferenceNumber": "103410106659",
	"authorizationId": "01583",
	"responseCode": "98",
	"terminalId": "fNpYz87v",
	"cardAcceptorId": "EF86j9iLjdw2sCP",
	"messageType": "receiptsInquiry",
	"messageTypeIdentifier": "200",
	"productCode": "services",
	"systemTraceNumber": "88e3389a-e355-460e-809e-9ffb24a56704",
	"responseMessage": "transacción completada satisfactoriamente",
	"selfLink": {
		"href": "/self/self/request/103410106659",
		"method": "get"
	},
	"serviceData": {
		"meta": {
			"mensajes": [{
				"codigo": "ESM06",
				"mensaje": "Cliente no tiene deudas.",
				"tipo": "error"
			}],
			"totalRegistros": 0,
			"idTransaccion": "597075739188006"
		}
	},
	"expires_in": 300
}

Ejemplo NO OK - OTRO

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}
Pago de Servicio Banbif
POST /api/2.1.0/rysServices

Servicio para pagar la póliza del vehículo consultado previamente (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "servicepayment",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "554897499035",
    "providerCode": "900001",
    "companyCode": "700002",
    "customerServiceId": "543410",
    "amount": 85,
    "currencyCode": "804",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "codigoConvenio": "1",
            "nombreConvenio":"Calidda",
            "comisionUsuario":1,
            "idTransaccionOrigen": "32132331",
            "montoDescuentoDestino": 1,
            "montoSaldoDestino": 1,
            "montoMultaDestino": 1,
            "montoVencidoDestino": 1,
            "montoInteresDestino": 1,
            "montoReajusteDestino": 1,
            "montoTotalDestino": 1,
            "fechaVencimiento": "",
            "fechaHora": "",
            "monto": "",
            "documento": {
                "numero": ""
            },
            "servicios": [
                {
                    "id": ""
                }
            ],
            "idConsulta": "",
            "montoSaldoOrigen": 1
            "montoDescuentoOrigen": 1
            "montoMultaOrigen": 1,
            "montoVencidoOrigen": 1,
            "montoInteresOrigen": 1,
            "montoReajusteOrigen": 1,
            "montoTotalOrigen": 1,
            "idServicio": ""
        }
    }
}

Responses

200 OK
Body
Examples

Ejemplo todo OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "servicePayment",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "meta": {
            "mensajes": [
                {
                    "codigo": "ESM00",
                    "mensaje": "Proceso Exitoso",
                    "tipo": "info"
                }
            ],
            "totalRegistros": 1,
            "idTransaccion": "590626774843027"
        },
        "datos": [
            {
                "fechaVencimiento": "2020-02-21",
                "cliente": {
                    "id": ""
                },
                "glosaCampana": "PAGO DE RECIBOS SOLES CALIDDA",
                "montoSaldoOrigen": 1,
                "montoDescuentoOrigen": 1,
                "montoMultaOrigen": 1,
                "montoVencidoOrigen": 1,
                "montoInteresOrigen": 1,
                "montoReajusteOrigen": 1,
                "montoTotalOrigen": 1,
                "comisionCliente": 1,
                "documento": {
                    "numero": "000000100199775"
                },
                "idConsulta": "1178992",
                "servicios": [
                    {
                        "id": "106920"
                    }
                ],
                "moneda": "SOL",
                "datosAdicionales": [
                    {
                        "nombre": "Nombre",
                        "valor": "AVILA MONTANO LUISA MARIELA"
                    }
                ],
                "pagos": [
                    {
                        "monto": 11.4,
                        "cuentaCargo": {
                            "numero": ""
                        },
                        "tipoOperacion": "PAGO_TOTAL_CUOTA",
                        "datosAdicionales": [
                            {}
                        ],
                        "comprobante": "",
                        "numeroPago": "118651"
                    }
                ]
            }
        ]
    },
    "expires_in": "300"
}

Ejemplo no OK (respuesta errónea interna)

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}

Ejemplo NOOK (controlado)

{
    "retrievalReferenceNumber": "875966491473",
    "authorizationId": "85792",
    "responseCode": "98",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "c33904cc-18f2-49ee-9563-a0094a76aa0d",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/875966491473",
        "method": "get"
    },
    "serviceData": {
        "meta": {
            "mensajes": [
                {
                    "codigo": "ESM10",
                    "mensaje": "Error",
                    "tipo": "Datos invalidos"
                }
            ]
        }
    },
    "expires_in": 300
}
Pagoefectivo
POST /api/2.1.0/rysServices
POST /api/2.1.0/rysServices
Consulta de Servicio PagoEfectivo
POST /api/2.1.0/rysServices

Servicio para consultar el CODIGO del recibo, suministro, etc que pagaremos (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "servicepayment",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "554897499035",
    "providerCode": "900001",
    "companyCode": "700001",
    "customerServiceId": "2555590",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "orderNumber": "2555590",
            "operationNumber": "554897499035",
            "terminalNumber": "12345567"
        }
    }
}

Responses

200 OK
Body
Examples

Ejemplo todo OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "servicePayment",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "code": "100",
        "message": "Solicitud exitosa",
        "data": {
            "responseDate": "2020-08-06T15:17:11-05:00",
            "user": "Prueba",
            "terminalNumber": "12345567",
            "operationNumber": "875966491473",
            "orderNumber": "2555590",
            "documentsQuantity": 1,
            "portal": "PagoEfectivo",
            "variable1": "",
            "variable2": "",
            "documentsDetail": [
                {
                    "cip": "2555590",
                    "total": 1,
                    "amount": 1,
                    "latePaymentFee": 1,
                    "currency": "PEN",
                    "issueDate": "2020-07-09T14:57:30-05:00",
                    "expirationDate": "2020-08-14T12:19:00-05:00",
                    "description": "Compra con PagoEfectivo",
                    "agreementCode": "001200"
                }
            ]
        }
    },
    "expires_in": "300"
}

Ejemplo NO OK

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}
Pago de Servicio PagoEfectivo
POST /api/2.1.0/rysServices

Servicio para pagar el servicio consultado previamente (el endpoint para consultar y pagar, tanto en RIMAC, BANBIF y PAGOEFECTIVO es el mismo, solo cambiará el payload de consumo)

Request body

Examples
{
    "messageType": "servicepayment",
    "messageTypeIdentifier": "200",
    "productCode": "authorization",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "retrievalReferenceNumber": "554897499035",
    "providerCode": "900001",
    "companyCode": "700002",
    "customerServiceId": "2555590",
    "amount": 85,
    "currencyCode": "604",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "datamapping": {
        "params": {
            "orderNumber": "2555590",
            "operationNumber": "554897499035",
            "terminalNumber": "12345567",
            "documentsDetail": [
                {
                    "cip": "2555590",
                    "total": 1,
                    "amount": 1,
                    "latePaymentFee": 1,
                    "currency": "PEN",
                    "issueDate": "2020-07-09T14:57:30-05:00",
                    "expirationDate": "2020-08-14T12:19:00-05:00",
                    "description": "Compra con PagoEfectivo",
                    "agreementCode": "001200"
                }
            ],
            "responseDate": ""
        }
    }
}

Responses

200 OK
Body
Examples

Ejemplo OK

{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "ab4b4ec1-fd1d-4334-b010-13ab18eb693e",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "code": "100",
        "message": "",
        "data": {
            "responseDate": "",
            "movementNumber": "",
            "salePointCode": "",
            "terminalNumber": "",
            "operationNumber": "",
            "documentsQuantity": "",
            "documentsDetail": [
                {
                    "movementNumber": "692903",
                    "cip": "2555590"
                }
            ],
            "variable1": "",
            "variable2": ""
        }
    },
    "expires_in": "300"
}

Ejemplo NO OK Controlado

{
    "retrievalReferenceNumber": "620181567850",
    "authorizationId": "06176",
    "responseCode": "98",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "productCode": "services",
    "systemTraceNumber": "8b270877-4b1b-409d-82c5-298b5bde7e54",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/620181567850",
        "method": "get"
    },
    "serviceData": {
        "code": 111,
        "message": "Solicitud con datos inválidos.",
        "data": [
            {
                "code": 151,
                "message": "Recurso no encontrado.",
                "field": "agreementCode"
            }
        ]
    },
    "expires_in": 300
}

Ejemplo NO OK - OTRO

{
    "retrievalReferenceNumber": "514951739794",
    "authorizationId": "343759",
    "responseCode": "96",
    "responseMessage": "Los valores permitidos para productCode son: Services, authorization",
    "terminalId": "fNpYz87v",
    "cardAcceptorId": "EF86j9iLjdw2sCP",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "200",
    "systemTraceNumber": "c0057308-ae66-4cf3-ae91-3683f936713a",
    "selfLink": {
        "href": "/self/self/request/514951739794",
        "method": "get"
    },
    "expires_in": 300
}
Movistar
Movistar Movil
POST /authorization
Consulta de Servicio Movistar Movil
POST /receiptsInquiry

Consulta de servicio Movistar Movil

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECTLF02",
        "customerServiceId": "953616571"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago de Servicio Movistar Movil
POST /authorization

Pago de servicio Movistar Movil

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECTLF02",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Movistar Fijo
POST /receiptsInquiry
POST /authorization
Consulta de Servicio Movistar Fijo
POST /receiptsInquiry

Consulta de servicio Movistar Fijo

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECTLF02",
        "customerServiceId": "953616571"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago de Servicio Movistar Fijo
POST /authorization

Pago de servicio Movistar Fijo

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECTLF02",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Movistar TV
POST /receiptsInquiry
POST /authorization
Consulta de Servicio Movistar TV
POST /receiptsInquiry

Consulta de servicio Movistar TV

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECTLF03",
        "customerServiceId": "953616571"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago de Servicio Movistar TV
POST /authorization

Pago de servicio Movistar TV

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECTLF03",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Movistar Sertel
Consulta de Servicio Movistar Sertel
POST /receiptsInquiry

Consulta de servicio Movistar Sertel

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECTLF08",
        "customerServiceId": "953616571"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago de Servicio Movistar Sertel
POST /authorization

Pago de servicio Movistar Sertel

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECTLF08",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Movistar Renta Publica
Consulta de Servicio Movistar Renta Publica
POST /receiptsInquiry

Consulta de servicio Movistar Renta Publica

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECTLF08",
        "customerServiceId": "953616571"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago de Servicio Movistar Renta Publica
POST /authorization

Pago de servicio Movistar Renta Publica

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECTLF08",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Claro
Claro Telefonía DNI
Consulta Servicio Claro Telefonia DNI
POST /receiptsInquiry

Consulta de servicio Claro Telefonía DNI

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECLAR15",
        "customerServiceId": "48121213"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Claro Telefonía DNI
POST /authorization

Pago de servicio Claro Telefonía DNI

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECLAR15",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Claro Soles
POST /receiptsInquiry
POST /authorization
Consulta Servicio Claro Soles
POST /receiptsInquiry

Consulta de servicio Claro Soles

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECLARO3",
        "customerServiceId": "01415287"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Claro Soles
POST /authorization

Pago de servicio Claro Soles

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECLARO3",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Claro Distribuidores
Consulta Servicio Claro Distribuidores
POST /receiptsInquiry

Consulta de servicio Claro Distribuidores

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECLAR10",
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Claro Distribuidores
POST /authorization

Pago de servicio Claro Distribuidores

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECLAR10",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Claro TVSAT
POST /receiptsInquiry
POST /authorization
Consulta Servicio Claro TVSAT
POST /receiptsInquiry

Consulta de servicio Claro TVSAT

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECLARO7",
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Claro TVSAT
POST /authorization

Pago de servicio Claro Distribuidores

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECLARO7",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Claro Telefonía
POST /receiptsInquiry
POST /authorization
Consulta Servicio Claro Telefonía
POST /receiptsInquiry

Consulta de servicio Claro Telefonía DNI

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "RECLARO1",
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Claro Telefonía
POST /authorization

Pago de servicio Claro Telefonía

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "RECLARO1",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Bitel
POST /receiptsInquiry
POST /authorization
Consulta Servicio Bitel
POST /receiptsInquiry

Consulta de Servicio Luz del Bitel

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "VIET0002"
        "customerServiceId": "yJIof2T9bSTyxcJwN4p"
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Bitel
POST /authorization

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "VIET0002",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Entel
POST /receiptsInquiry
POST /authorization
Consulta Servicio Entel
POST /receiptsInquiry

Consulta de Servicio Luz del Sur

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "ENTEL000"
        "customerServiceId": "yJIof2T9bSTyxcJwN4p"
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Entel
POST /authorization

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "ENTEL000",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Luz del Sur
POST /receiptsInquiry
POST /authorization
Consulta Servicio Luz del Sur
POST /receiptsInquiry

Consulta de Servicio Luz del Sur

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "LUZSUR01
        "customerServiceId": "yJIof2T9bSTyxcJwN4p
}

Responses

Pago Servicio Luz del Sur
POST /authorization

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "serviceCode": "LUZSUR01",
        "referenceId": "124519000970",
        "paymentType": "1"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Distriluz
Hidrandina
POST /receiptsInquiry
POST /authorization
Consulta Servicio Hidrandina
POST /receiptsInquiry

Consulta de Servicio Hidrandina

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700002",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "DIZLUZ01"
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Hidrandina
POST /authorization

Pago de Servicio Hidrandina

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "paymentType": "1551",
        "serviceCode": "DISLUZ01",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Electrocentro
POST /receiptsInquiry
POST /authorization
Consulta Servicio Electrocentro
POST /receiptsInquiry

Consulta de Servicio Hidrandina

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700002",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "DIZLUZ03"
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Electrocentro
POST /authorization

Pago de Servicio Hidrandina

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "paymentType": "1551",
        "serviceCode": "DISLUZ03",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Electronoroeste
POST /receiptsInquiry
POST /authorization
Consulta Servicio Electronoroeste
POST /receiptsInquiry

Consulta de Servicio Hidrandina

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700002",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "DIZLUZ01"
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Electronoroeste
POST /authorization

Pago de Servicio Hidrandina

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "paymentType": "1551",
        "serviceCode": "DISLUZ01",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Electronorte
POST /receiptsInquiry
POST /authorization
Consulta Servicio Electronorte
POST /receiptsInquiry

Consulta de Servicio Hidrandina

Request body

Examples
{
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700002",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceCode": {
        "serviceCode": "DIZLUZ02"
        "customerServiceId": "yJIof2T9bSTyxcJwN4pL"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "expires_in": "300"
}
Pago Servicio Electronorte
POST /authorization

Pago de Servicio Hidrandina

Request body

Examples
{
    "retrievalReferenceNumber": "92817283937812",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "services",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "paymentType": "1551",
        "serviceCode": "DISLUZ02",
        "referenceId": "124519000970",
        "receiptId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "customerServiceId": "953616571",
        "serviceName": "Cel. pospago/RPM",
        "customerName": "BENITO    ALLCA CHAHUARES",
        "receipts": [
            {
                "receiptId": "M000000915",
                "receiptAmount": "50.00",
                "receiptServiceFee": "1.00",
                "receiptPayingAmount": "51.00",
                "receiptIssueDate": "08-07-2017"
            }
        ],
        "referenceId": "124519000970"
    },
    "receiptId": "M000000915",
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Recargas
Claro
POST /authorization
Recarga Movil Claro
POST /authorization

Recarga de celulares operador claro

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "companyCode": "700002",
    "currencyCode": "604",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "rechargeInfo": {
        "telephoneNumber": "997670262",
        "telcoId": "CLARO000"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Entel
POST /authorization
Recarga Movil Entel
POST /authorization

Recarga de celulares operador entel

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "companyCode": "700002",
    "currencyCode": "604",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "rechargeInfo": {
        "telephoneNumber": "980492107",
        "telcoId": "NEXTEL00"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Bitel
POST /authorization
Recarga Movil Bitel
POST /authorization

Recarga de celulares operador bitel

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "companyCode": "700002",
    "currencyCode": "604",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "rechargeInfo": {
        "telephoneNumber": "931083539",
        "telcoId": "VIET0001"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
DirectTV
POST /authorization
Recarga DirectTV
POST /authorization

Recarga de celulares operador bitel

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "companyCode": "700002",
    "currencyCode": "604",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "rechargeInfo": {
        "telephoneNumber": "000789672672",
        "telcoId": "DIRECTV0"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
Tarjetas Prepagas
POST /activateTPP
POST /receiptsInquiry
POST /authorization
Activacion Tarjeta Prepagada
POST /activateTPP

Activacion de tarjeta prepagada

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "companyCode": "700001",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "activateInfo": {
        "customerId": "70814369",
        "param1": "4894861000001582",
        "param2": "",
        "param3": ""
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "activate",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "productData": {
        "productNumber": "4894865100022273",
        "productId": "TRANSP01",
        "currentBalance": "6.00",
        "promo": "1",
        "idTxn": "5046039969"
    }
}
Balance Tarjeta Prepagada
POST /receiptsInquiry

Activacion de tarjeta prepagada

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "productInfo": {
        "productNumber": "4894861100009188",
        "productId": "TRANSP01"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "balance",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/456540554752",
        "method": "get"
    },
    "productData": {
        "productNumber": "4894865100022273",
        "productId": "TRANSP01",
        "currentBalance": "6.00"
    }
}
Recarga Tarjeta Prepagada
POST /authorization

Recarga tarjeta prepagada

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "companyCode": "700001",
    "currencyCode": "604",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "rechargeInfo": {
        "rechargeNumber": "4894861100009188",
        "telcoId": "TRANSP01"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "coreAcctInitialBalance": "845550.675",
    "coreAcctEarnedFee": "0.350",
    "coreAcctCurrentBalance": "845500.025",
    "expires_in": "300"
}
General
Balance
Consultar balance comercio
POST /core

Servicio para consultar el saldo actual de la cuenta cupo de un comercio

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "amount": "3",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "pointOfInteraction": {
        "gpsLocation": {
            "latitude": "10.037990",
            "longitude": "-84.081742"
        },
        "email": "test@test.test",
        "telephone": "981212912",
        "userIdentification": "48121213"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Saldo: 51.349,63",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "balances": {
        "accountBalance1": {
            "balanceName": "Ledger balance",
            "balanceCurrencyCode": "604",
            "balance": "315"
        }
    },
    "expires_in": "300"
}
Usuario
POST /createAccount
Crear usuario
POST /createAccount

Servicio para asociar un comercio a una nueva cuenta cupo

Request body

Examples
{
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "newAccount": {
        "accountCurrencyCode": "604"
    },
    "commerce": {
        "commerceName": "Comercio Ict250",
        "merchantCategoryCode": "5661",
        "commerceId": "341198217",
        "companyCode": "700001",
        "address": {
            "commerceCountryAlphaCode": "PE",
            "commerceStateAlphaCode": "LIM",
            "commerceCity": "Lima"
        },
        "terminal": {
            "terminalSeries": "24940273",
            "model": "ICT 220"
        },
        "commerceTelephone": "2202409",
        "legalRepresentative": {
            "representativeName": "Visanet Ict220",
            "representativeIdType": "1",
            "representativeId": "37204955",
            "representativeTelephone": "990456222",
            "representativeEmail": "jessica.mellina@gmail.com"
        }
    }
}

Responses

201 Created
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "authorization",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "Cuenta creada",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "accountCurrencyCode": "604",
    "ownerId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
    "newAccountId": "yJIof2T9bSTyxcJwN4pL",
    "complementaryCode": "ijfs9dbiro",
    "newUserId": "47204972",
    "newPassword": "918448"
}
BBVA
Conduent
POST /conduent
POST /conduent
POST /conduent
POST /conduent
POST /conduent
POST /conduent
POST /conduent
POST /v1/venta/enviarConduent
GetVersion
POST /conduent

Obtiene la ultima versión del servicio de Conduent

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "conduent",
    "productCode": "getversion"
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58245",
    "responseCode": "00",
    "messageType": "receiptsInquiry",
    "productCode": "conduent",
    "responseMessage": "WS : 1.0.10.1 - 32",
    "expires_in": "300"
}
GetCardKeys
POST /conduent

Obtiene la llaves de las tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "conduent",
    "productCode": "getcardkeys",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "localTransactionDateTime": "2018-06-26T205958Z",
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pCardReaderId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "getcardkeys",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": "",
            "errorMessage": "",
            "millis": "1925",
            "transactionUUID": "",
            "executionDate": ""
        },
        "data": {
            "status": "0",
            "keys": [
                "63c03ae52657"
            ]
        },
        "externalTransactionId": "5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF"
    },
    "expires_in": "300"
}
GetCardInfo
POST /conduent

Obtiene información de la tarjeta ingresada

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "productCode": "getcardinfo",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "currencyCode": "604",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pCardReaderId": "M000000915",
        "pData": "9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...",
        "pSaleId": "200323102010965571997"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "getcardinfo",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": "",
            "errorMessage": "",
            "millis": "1925",
            "transactionUUID": "",
            "executionDate": ""
        },
        "data": {
            "status": "0",
            "cardState": "1",
            "cardId": "3280519501",
            "balance": "45",
            "minReloadAmount": "10",
            "maxReloadAmount": "48260",
            "cardPrice": "0",
            "tariff": "Tarjeta CC con valor anonymo",
            "userProfile": "Perfil anónimo",
            "endValidityDate": "20390228"
        },
        "externalTransactionId": "5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF"
    },
    "expires_in": "300"
}
LoadCard
POST /conduent

Servicio para activacion y recarga de una tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "receiptsInquiry",
    "productCode": "getcardinfo",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "currencyCode": "604",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pData": "9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...",
        "pLoadAmount": "25",
        "pSaleDate": "20200311193202",
        "pSalePointId": "0",
        "pSellerId": "0",
        "pServiceId": "0",
        "pSaleId": "2003111932022530603506",
        "pCardReaderId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "00",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "receiptsInquiry",
    "messageTypeIdentifier": "request",
    "productCode": "recharge",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": "",
            "errorMessage": "",
            "millis": "1925",
            "transactionUUID": "",
            "executionDate": ""
        },
        "data": {
            "status": "0",
            "cardFamily": "1",
            "reloadId": "",
            "cardId": "3280519501",
            "balance": "45",
            "actions": {
                "Action": [
                    {
                        "ActionType": "4",
                        "RecordNo": "8",
                        "Data": "209601000000000a299f7f0115220228",
                        "OrgRecordNo": "0",
                        "Value": "0"
                    }
                ]
            }
        },
        "externalTransactionId": "5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF"
    },
    "expires_in": "300"
}
ReloadCard
POST /conduent

Servicio para recarga de una tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "conduent",
    "productCode": "reloadcard",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "currencyCode": "604",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pData": "9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...",
        "pReloadAmount": "25",
        "pSaleDate": "20200311193202",
        "pSalePointId": "0",
        "pSellerId": "0",
        "pServiceId": "0",
        "pSaleId": "2003111932022530603506",
        "pCardReaderId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "reloadcard",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": "",
            "errorMessage": "",
            "millis": "1925",
            "transactionUUID": "",
            "executionDate": ""
        },
        "data": {
            "status": "0",
            "cardFamily": "1",
            "reloadId": "",
            "cardId": "3280519501",
            "balance": "45",
            "actions": {
                "Action": [
                    {
                        "ActionType": "4",
                        "RecordNo": "8",
                        "Data": "209601000000000a299f7f0115220228",
                        "OrgRecordNo": "0",
                        "Value": "0"
                    }
                ]
            }
        },
        "externalTransactionId": "5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF"
    },
    "expires_in": "300"
}
GetReloadTerminated
POST /conduent

Servicio para confirmar el nuevo saldo de la tarjeta cargada

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "conduent",
    "productCode": "getreloadterminated",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "currencyCode": "604",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pReloadAmount": "25",
        "pData": "9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...",
        "pSaleDate": "20200311193202",
        "pSalePointId": "0",
        "pSellerId": "0",
        "pServiceId": "0",
        "pSaleId": "2003111932022530603506",
        "pCardReaderId": "M000000915"
    }
}

Responses

200 OK
Body
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58524",
    "responseCode": "96",
    "terminalId": "5ZJIm9ni",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "getreloadterminated",
    "systemTraceNumber": "abc123abc245",
    "responseMessage": "transacción completada satisfactoriamente",
    "selfLink": {
        "href": "/self/self/request/554897499035",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": "",
            "errorMessage": "",
            "millis": "1925",
            "transactionUUID": "",
            "executionDate": ""
        },
        "data": {
            "status": "0",
            "claimId": "0",
            "cardFamily": "1",
            "cardId": "3280519501",
            "balance": "45"
        },
        "externalTransactionId": "5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF"
    },
    "expires_in": "300"
}
VerifyClaimId
POST /conduent

Servicio para registrar reclamo en caso de error en la recarga de la tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Examples
{
    "messageType": "conduent",
    "productCode": "verifyclaimid",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "12342abcde123",
    "localTransactionDateTime": "2018-06-26T205958Z",
    "currencyCode": "604",
    "cardAcceptorId": "WxZSbtwIbMjY5dA",
    "terminalId": "5ZJIm9ni",
    "accountInfo": {
        "coreAccountId": "3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG",
        "ownerId": "yJIof2T9bSTyxcJwN4pL"
    },
    "serviceInfo": {
        "pCardFamily": "1",
        "pCardId": "2530561746",
        "pData": "9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...",
        "pClaimId": "125502003112358460",
        "pSalePointId": "0",
        "pSaleId": "2003111932022530603506",
        "pCardReaderId": "M000000915"
    }
}
SMS Notificación
POST /v1/venta/enviarConduent

Servicio para enviar mensaje de texto

https://api-sms.qa.vmas.com.pe/v1/venta/enviarConduent

Request body

Object
nombreComercio
string

Nombre del comercio

Example:
COCQUITO
monto
string

Monto de la recarga

Example:
35
precioTarjeta
string

Costo de la tarjeta

Example:
4.5
idVenta
string

Id de la venta

Example:
20032018403412456789
claimId
string

Id de resolución transaccional devuelto por el servicio de “verifyClaimId”

Example:
123123
numero
string

Número telefónico a enviar el mensaje

Example:
966425661
tipo
string

Operación realizada

Enumeration:
A

Activación

R

Recarga

Conduent-POS
POST /v1/conduent
POST /v1/conduent
POST /v1/conduent
POST /v1/conduent
POST /v1/conduent
01-GetVersion-Pos
POST /v1/conduent

Obtiene la ultima versión del servicio de Conduent

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Object
messageType
string

Identificador de la operación

Example:
conduent
productCode
string

Código del producto

Example:
getversion
Examples
{
    "messageType": "conduent",
    "productCode": "getversion"
}

Responses

200 OK
Body
Object
retrievalReferenceNumber
string

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58245
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

messageType
string

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string

Código del producto

Example:
getVersion
responseMessage
string

Mensaje de retorno de la ejecución

Example:
WS : 1.0.10.1 - 32
expires_in
string
Example:
300
Examples
{
    "retrievalReferenceNumber": "554897499035",
    "authorizationId": "58245",
    "responseCode": "00",
    "messageType": "conduent",
    "productCode": "getVersion",
    "responseMessage": "WS : 1.0.10.1 - 32",
    "expires_in": "300"
}
02-GetCardKeys-Pos
POST /v1/conduent

Obtiene la llaves de las tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Object
messageType
string

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string

Código del producto

Example:
getcardkeys
messageTypeIdentifier
string

Identificador de la petición

Example:
request
systemTraceNumber
string

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (puede ser un timestamp

Example:
2
cardAcceptorId
string

Llave del comercio en backend “Acceptor ID”, debe enviarse encriptada con PKCS Padding 7

Example:
9C3F83C191A4AA21562C9CCCC6150624
terminalId
string

Llave del comercio en backend “Terminal ID”, debe enviarse encriptada con PKCS Padding 7

Example:
7E75E02298BF89F0AF39C38D507C43B1
origen
string

Tipo de terminal de origen

Enumeration:
D190

Poket Pro

S920

Poket Full

A910

Android

iv
string

Vector de inicializacion

Example:
2AE3BAAAB9165CC458E199CB89F51B13
accountInfo
Object
coreAccountId
string

Llave del comercio en backend Account ID, debe enviarse encriptada con PKCS Padding 7

Example:
27DBE658DFC703320635186A302F4AB66100F6611D69980BD597B24764C47A2247345F97E01FD167A4DCD3CC62E3C60B
ownerId
string

Llave del comercio en backend Owner ID, debe enviarse encriptada con PKCS Padding 7

Example:
E3DA3739D93B7F5B82B003D4148AFA68536A69DCC26023874AB7C3672C76BE53
currencyCode
string

Codigo de moneda, enviar 0604 para nuevos soles

Example:
0604
localTransactionDateTime
string

Fecha de la transacción

Example:
20221129110738
serviceInfo
Object

Datos propios del servicio externo de Conduent

pCardFamily
integer

Tipo de tarjeta

Example:
1
pCardId
string

ID de la tarjeta

Example:
3269566727
pCardReaderId
string

ID del terminal, se debe de concantenar el prefijo “NB-”

Example:
NB-61545911
Examples
{
    "messageType": "conduent",
    "productCode": "getcardkeys",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "2",
    "cardAcceptorId": "9C3F83C191A4AA21562C9CCCC6150624",
    "terminalId": "7E75E02298BF89F0AF39C38D507C43B1",
    "origen": "D190",
    "iv": "2AE3BAAAB9165CC458E199CB89F51B13",
    "accountInfo": {
        "coreAccountId": "27DBE658DFC703320635186A302F4AB66100F6611D69980BD597B24764C47A2247345F97E01FD167A4DCD3CC62E3C60B",
        "ownerId": "E3DA3739D93B7F5B82B003D4148AFA68536A69DCC26023874AB7C3672C76BE53"
    },
    "currencyCode": "0604",
    "localTransactionDateTime": "20221129110738",
    "serviceInfo": {
        "pCardFamily": 1,
        "pCardId": "3269566727",
        "pCardReaderId": "NB-61545911"
    }
}

Responses

200 OK
Body
Object
retrievalReferenceNumber
string

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

Example:
023770899146
authorizationId
string

Código de autorizacion

Example:
16806
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string

Serie del equipo

Example:
NB-61545911
cardAcceptorId
string

Llave del comercio en backend “Acceptor ID”

Example:
z6cKJM2cZnu6qFz
messageType
string

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string

Identificador de la petición

Example:
request
productCode
string

Código del producto

Example:
getcardkeys
systemTraceNumber
string

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
ok
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/023770899146
method
string

Tipo de metodo

Example:
get
serviceData
Object
header
Object
errorCode
integer

Código de error

errorMessage
string

Mensaje de error

Example:
OK
millis
integer
Example:
509
transactionUUID
string

UUID de la transacción

Example:
cba769f6-ac5e-46ee-983f-1d19d0330b1d
executionDate
integer

Fecha de ejecucion en unixtime

Example:
1669738076168
data
Object
status
integer

Estado

Example:
0
keys
Array

Llaves de la tarjeta

Example:
["ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","ae9d0499bc9f","bd54b4076898"]
string
Example:
ae9d0499bc9f
externalTransactionId
string

ID Transaccion externo

Example:
y7gIkJm0kahQOEuhNpurY8RZDh2TSh3E1k0H
expires_in
integer
Example:
300
Examples

Trama de respuesta con llaves de la tarjeta

{
    "retrievalReferenceNumber": "023770899146",
    "authorizationId": "16806",
    "responseCode": "00",
    "terminalId": "NB-61545911",
    "cardAcceptorId": "z6cKJM2cZnu6qFz",
    "messageType": "conduent",
    "messageTypeIdentifier": "request",
    "productCode": "getcardkeys",
    "systemTraceNumber": "2",
    "responseMessage": "ok",
    "selfLink": {
        "href": "/self/self/request/023770899146",
        "method": "get"
    },
    "serviceData": {
        "header": {
            "errorCode": 0,
            "errorMessage": "OK",
            "millis": 509,
            "transactionUUID": "cba769f6-ac5e-46ee-983f-1d19d0330b1d",
            "executionDate": 1669738076168
        },
        "data": {
            "status": 0,
            "keys": [
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "ae9d0499bc9f",
                "bd54b4076898"
            ]
        },
        "externalTransactionId": "y7gIkJm0kahQOEuhNpurY8RZDh2TSh3E1k0H"
    },
    "expires_in": 300
}
03-GetCardInfo-Pos
POST /v1/conduent

Obtiene la información de la tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Object
messageType
string

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string

Código del producto

Example:
getcardinfo
messageTypeIdentifier
string

Identificador de la petición

Example:
request
systemTraceNumber
string

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (puede ser un timestamp

Example:
12342abcde123
cardAcceptorId
string

Llave del comercio en backend “Acceptor ID”, debe enviarse encriptada con PKCS Padding 7

Example:
9C3F83C191A4AA21562C9CCCC6150624
terminalId
string

Llave del comercio en backend “Terminal ID”, debe enviarse encriptada con PKCS Padding 7

Example:
7E75E02298BF89F0AF39C38D507C43B1
origen
string

Tipo de terminal de origen

Enumeration:
D190

Poket Pro

S920

Poket Full

A910

Android

iv
string

Vector de inicializacion

Example:
2AE3BAAAB9165CC458E199CB89F51B13
accountInfo
Object
coreAccountId
string

Llave del comercio en backend Account ID, debe enviarse encriptada con PKCS Padding 7

Example:
7E75E02298BF89F0AF39C38D507C43B14324234
ownerId
string

Llave del comercio en backend Owner ID, debe enviarse encriptada con PKCS Padding 7

Example:
9C3F83C191A4AA21562C9CCCC61506244354336
currencyCode
string

Codigo de moneda, enviar 0604 para nuevos soles

Example:
604
localTransactionDateTime
string

Fecha de la transacción

Example:
20221129110738
serviceInfo
Object

Datos propios del servicio externo de Conduent

pCardFamily
string

Tipo de tarjeta

Example:
1
pCardId
string

ID de la tarjeta

Example:
2530561746
pCardReaderId
string

ID del terminal, se debe de concantenar el prefijo “NB-”

Example:
NB-61545911
pData
string
Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pSaleId
string

Id de la venta, es necesario generarlo según el formato indicado por Conduent, ya permitirá la traza durante toda la transacción

Example:
200323102010965571997
Examples
{
    "messageType": "conduent",
    "productCode": "getcardinfo",
    "messageTypeIdentifier": "request",
    "systemTraceNumber": "2",
    "cardAcceptorId": "431416C4A029A8863A99CBE9A3B2E40E",
    "terminalId": "B1A31F25C5982EA3733CE0C0D938A159",
    "origen": "s920",
    "iv": "E51C9737903343947E02086541E4C48A",
    "accountInfo": {
        "coreAccountId": "07E8C29D9A05F6528E583340FC8119E30EA15AD13A760CD7114AC4CA97C928BB62194E1969A8D2F17A951855DC0FD0BF",
        "ownerId": "58DCAC06108EABF182E23563543F6B1A0422820FBA83D9416C625E0AE4FDD7C3"
    },
    "currencyCode": "0604",
    "localTransactionDateTime": "20221129114238",
    "serviceInfo": {
        "pCardFamily": 1,
        "pCardId": "2522063252",
        "pCardReaderId": "NB-6R212899",
        "pData": [
            "94A15396F0080400A1B90C10457017200000000000043C0009154C494D4120200000000000000000009653A19403010000000000000070F87800000000000000005967C29967C0000000000000000000000000000000000000000000003E68980000000000000000009653A19403010000000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFB00000000C252628C8040400012C29D00000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFC0000000085A4665D6040400012C2B500000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F000000000000000000000000000000000000000000000000000000000000000000000000A3C45E000000000035A50E000000000000000000000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F00000000000000000000000000000000000000000000000000000000000000000000000032AF6600000000004C6BD4000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F000000000000004B0000B1006A2D795CA040400012C2B5A0080B94025800000000000000CD8CB44B0000B1006A2D7C5D6040400012C2B500000000000007887F00000000000000A0080BAC02580000000000000010C3F14B0000B1006A2D7A8C8040400012C29D8008119002580000000000000093175D00000000000007887F000000000000004B0000B1006A2D7A34A040400012C2B5A0080694025800000000000000B9D6DA0000000000000000000000000000000000000000000007887F000000000000003D8273361489D3E4758A52206780DEB02009215CC98A3AC0FF82CEDCBAD24296476E35D04B947A8753DE8BAEE69A576700000000000007887F00000000000000AF58D89703119627B548DF2311F9032359E62608C7E3F9085CDE9DEFC65D51258BCB56D4ED2ECD162FDCF4A0E1574B1600000000000007887F000000000000000000000000000000000000000000000002FFFF7FFD00008002FFFF7F0FF00FF003FFFF7FFC00008003FFFF7F0FF00FF000000000000066987900000000000000"
        ],
        "pSaleId": "2211291142382522063252"
    }
}

Responses

200 OK
Body
Object
retrievalReferenceNumber
string

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string

Identificador de la petición

Example:
request
productCode
string

Código del producto

Example:
getcardinfo
systemTraceNumber
string

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
cardState
string

Estado de la tarjeta

Example:
1
cardId
string

ID de la tarjeta

Example:
3280519501
balance
string

Saldo de la tarjeta

Example:
45
minReloadAmount
string

Monto minimo de recarga

Example:
10
maxReloadAmount
string

Monto máximo de recarga

Example:
48260
cardPrice
string

Precio de la tarjeta

Example:
0
tariff
string

Descripción de la tarjeta

Example:
Tarjeta CC con valor anonymo
userProfile
string

Perfil del usuario

Example:
Perfil anónimo
endValidityDate
string

Fecha de expiración

Example:
20390228
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
04-LoadCard-Pos
POST /v1/conduent

Realiza la activación de tarjeta y su primera recarga

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Object
messageType
string
Example:
receiptsInquiry
productCode
string
Example:
loadcard
messageTypeIdentifier
string
Example:
request
systemTraceNumber
string
Example:
12342abcde123
localTransactionDateTime
string
Example:
2018-06-26T205958Z
currencyCode
string
Example:
604
cardAcceptorId
string
Example:
WxZSbtwIbMjY5dA
terminalId
string
Example:
5ZJIm9ni
origen
string
iv
string
accountInfo
Object
coreAccountId
string
Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string
Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object
pCardFamily
string
Example:
1
pCardId
string
Example:
2530561746
pData
string
Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pLoadAmount
string
Example:
25
pSaleDate
string
Example:
20200311193202
pSalePointId
string
Example:
0
pSellerId
string
Example:
0
pServiceId
string
Example:
0
pSaleId
string
Example:
2003111932022530603506
pCardReaderId
string
Example:
M000000915

Responses

200 OK
Body
Object
retrievalReferenceNumber
string
Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string
Example:
00
terminalId
string
Example:
5ZJIm9ni
cardAcceptorId
string
Example:
WxZSbtwIbMjY5dA
messageType
string
Example:
receiptsInquiry
messageTypeIdentifier
string
Example:
request
productCode
string
Example:
recharge
systemTraceNumber
string
Example:
abc123abc245
responseMessage
string
Example:
transacción completada satisfactoriamente
selfLink
Object
href
string
Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
header
Object
errorCode
string
errorMessage
string
millis
string
Example:
1925
transactionUUID
string
executionDate
string
data
Object
status
string
Example:
0
cardFamily
string
Example:
1
reloadId
string
cardId
string
Example:
3280519501
balance
string
Example:
45
actions
Object
Action
Array
Object
ActionType
string
Example:
4
RecordNo
string
Example:
8
Data
string
Example:
209601000000000a299f7f0115220228
OrgRecordNo
string
Example:
0
Value
string
Example:
0
externalTransactionId
string
Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
05-ReloadCard-Pos
POST /v1/conduent

Realiza la recarga de la tarjeta

Ruta base del servicio https://api-rys.vmas.com.pe/v1/conduent

Request body

Object
messageType
string
Example:
conduent
productCode
string
Example:
reloadcard
messageTypeIdentifier
string
Example:
request
systemTraceNumber
string
Example:
2
cardAcceptorId
string
Example:
431416C4A029A8863A99CBE9A3B2E40E
terminalId
string
Example:
B1A31F25C5982EA3733CE0C0D938A159
origen
string
Example:
s920
iv
string
Example:
E51C9737903343947E02086541E4C48A
accountInfo
Object
coreAccountId
string
Example:
07E8C29D9A05F6528E583340FC8119E30EA15AD13A760CD7114AC4CA97C928BB62194E1969A8D2F17A951855DC0FD0BF
ownerId
string
Example:
58DCAC06108EABF182E23563543F6B1A0422820FBA83D9416C625E0AE4FDD7C3
currencyCode
string
Example:
0604
localTransactionDateTime
string
Example:
20221129114238
serviceInfo
Object
pCardFamily
integer
Example:
1
pCardId
string
Example:
2522063252
pData
Array
Example:
["94A15396F0080400A1B90C10457017200000000000043C0009154C494D4120200000000000000000009653A19403010000000000000070F87800000000000000005967C29967C0000000000000000000000000000000000000000000003E68980000000000000000009653A19403010000000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFB00000000C252628C8040400012C29D00000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFC0000000085A4665D6040400012C2B500000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F000000000000000000000000000000000000000000000000000000000000000000000000A3C45E000000000035A50E000000000000000000000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F00000000000000000000000000000000000000000000000000000000000000000000000032AF6600000000004C6BD4000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F000000000000004B0000B1006A2D795CA040400012C2B5A0080B94025800000000000000CD8CB44B0000B1006A2D7C5D6040400012C2B500000000000007887F00000000000000A0080BAC02580000000000000010C3F14B0000B1006A2D7A8C8040400012C29D8008119002580000000000000093175D00000000000007887F000000000000004B0000B1006A2D7A34A040400012C2B5A0080694025800000000000000B9D6DA0000000000000000000000000000000000000000000007887F000000000000003D8273361489D3E4758A52206780DEB02009215CC98A3AC0FF82CEDCBAD24296476E35D04B947A8753DE8BAEE69A576700000000000007887F00000000000000AF58D89703119627B548DF2311F9032359E62608C7E3F9085CDE9DEFC65D51258BCB56D4ED2ECD162FDCF4A0E1574B1600000000000007887F000000000000000000000000000000000000000000000002FFFF7FFD00008002FFFF7F0FF00FF003FFFF7FFC00008003FFFF7F0FF00FF000000000000066987900000000000000"]
string
Example:
94A15396F0080400A1B90C10457017200000000000043C0009154C494D4120200000000000000000009653A19403010000000000000070F87800000000000000005967C29967C0000000000000000000000000000000000000000000003E68980000000000000000009653A19403010000000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFB00000000C252628C8040400012C29D00000000000007887F00000000000000209601659F00000A659F8201000F012B6E4740000000000000000000009B4FECFC0000000085A4665D6040400012C2B500000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F000000000000000000000000000000000000000000000000000000000000000000000000A3C45E000000000035A50E000000000000000000000000000007887F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007887F00000000000000000000000000000000000000000000000000000000000000000000000032AF6600000000004C6BD4000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F00000000000000009600000000000000000000000000000000000000000000000000000050FFD30000000000000000000000000000000000000000000007887F000000000000004B0000B1006A2D795CA040400012C2B5A0080B94025800000000000000CD8CB44B0000B1006A2D7C5D6040400012C2B500000000000007887F00000000000000A0080BAC02580000000000000010C3F14B0000B1006A2D7A8C8040400012C29D8008119002580000000000000093175D00000000000007887F000000000000004B0000B1006A2D7A34A040400012C2B5A0080694025800000000000000B9D6DA0000000000000000000000000000000000000000000007887F000000000000003D8273361489D3E4758A52206780DEB02009215CC98A3AC0FF82CEDCBAD24296476E35D04B947A8753DE8BAEE69A576700000000000007887F00000000000000AF58D89703119627B548DF2311F9032359E62608C7E3F9085CDE9DEFC65D51258BCB56D4ED2ECD162FDCF4A0E1574B1600000000000007887F000000000000000000000000000000000000000000000002FFFF7FFD00008002FFFF7F0FF00FF003FFFF7FFC00008003FFFF7F0FF00FF000000000000066987900000000000000
pReloadAmount
integer
Example:
10
pSaleDate
string
Example:
20221129114238
pSalePointId
integer
pSellerId
integer
pServiceId
integer
pSaleId
string
Example:
2211291142382522063252
pCardReaderId
string
Example:
NB-6R212899

Responses

200 OK
Body
Object
retrievalReferenceNumber
string
Example:
512462585078
authorizationId
string
Example:
67857
responseCode
string
Example:
00
terminalId
string
Example:
NB-6N877458
cardAcceptorId
string
Example:
5h07iNDxxb36tAx
messageType
string
Example:
conduent
messageTypeIdentifier
string
Example:
request
productCode
string
Example:
reloadcard
systemTraceNumber
string
Example:
3
responseMessage
string
Example:
OK
selfLink
Object
href
string
Example:
/self/self/request/512462585078
method
string
Example:
get
coreAcctInitialBalance
number
Example:
303.03
coreAcctEarnedFee
string
Example:
0.071
coreAcctCurrentBalance
number
Example:
299.11
expires_in
integer
Example:
300
serviceData
Object
header
Object
errorCode
integer
errorMessage
string
Example:
OK
millis
integer
Example:
633
transactionUUID
string
Example:
ca825136-0d56-4c20-833e-75b89c7aa72b
executionDate
integer
Example:
1669741835016
data
Object
status
integer
cardFamily
integer
Example:
1
reloadId
integer
cardId
string
Example:
3485248685
balance
integer
Example:
620
actions
Object
Action
Array
Object
ActionType
string
Example:
4
RecordNo
integer
Example:
12
Data
string
Example:
209601000000000a299f7d0100170127
OrgRecordNo
integer
Value
integer
externalTransactionId
string
Example:
Lij0vgjPSRcAzr6meYfttEBGQmRKAuV2OZ37
responseData
Object
providerFee
number
Example:
0.046
merchantFee
string
Example:
0.071
originalAmount
number
Example:
3.9292
proccesorFee
number
Example:
0.0248
outgoingTransactionId
string
Example:
Lij0vgjPSRcAzr6meYfttEBGQmRKAuV2OZ37
merchantFeeType
integer
Example:
1
proccesorFeeType
integer
Example:
1
providerFeeType
integer
Example:
1
originalAuthIdResp
integer
messageResp
string
Example:
OK
Estructuras de Entrada y Salida
Rimac Estructuras
ObjRimacConsultaRequest

Estructura de petición para consultar los datos del vehículo

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
providerCode
integer required

Código del proveedor del servicio, para este caso usaremos el código de Rimac

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

Código del documento asociado al servicio para ser pagado, para el caso de Rimac es la placa

Example:
AMA611
localTransactionDateTime
string

Fecha y hora de la transaccion, se coloca ejemplo del formato YYYY-MM-DDTHHmmssZ

Example:
2018-06-26T205958Z
datamapping
Object required

Datos variables por petición, se detallan los usados para Rimac

params
Object required
traceId
string required

Lo mismo que el retrievalReferenceNumber

Example:
554897499035
timestamp
string required

Fecha y hora de la transaccion en formato MM/DD/YYYY hh:mm:ss

Example:
09/16/2020 12:42:43
placaVigente
string required

Placa del vehículo a consultar

Max length: 6
Pattern: ^[a-zA-Z0-9_.]+$
Example:
AMA611
codUsoVehiculo
string required

Código de uso del vehículo

Enumeration:
001

Vehículo Particular

004

Vehículo Ambulancia

020

Vehículo Carga

023

Vehículo Taxi Urbano

desusoVehiculo
string required

Descripción de uso del vehículo

Enumeration:
PARTICULAR

Vehículo Particular

AMBULANCIA

Vehículo Ambulancia

CARGA

Vehículo Carga

TAXI URBANO

Vehículo Taxi Urbano

codTipoPersona
string required

Código del tipo de persona, para el negocio actual considerar sólo persona natural

Enumeration:
001

Persona Natural

002

Persona Juridica

desTipoPersona
string required

Descripción del tipo de persona, para el negocio actual considerar sólo persona natural

Enumeration:
NATURAL

Persona Natural

JURIDICA

Persona Juridica

fechaInicio
string required

Fecha de Inicio del seguro en formato YYYY-MM-DD

Pattern: ^\\d{4}\\-(0[1-9]|1[012])\\-(0[1-9]|[12][0-9]|3[01])$
Example:
2020-09-16
ObjRimacConsultaResponse

Estructura de la respuesta de la consulta de placa

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Tipo de operación

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
response
Object
trace
Object
traceId
string

??

Example:
1fd222ae5ae1bebba0c8733d3ed76806c998c92b2857f98c9645516969ea725130bc20735b807bac4b21b3a2a097f9ed65b9a1c3762ef56526de03f6176c666bfac1351a0b2607d23dad737a0717b605b777df53cc48359dc6b700c9c7337fde
consumerId
string

??

Example:
ID_APP_BROKER
serviceId
string

??

Example:
API-CANAL
moduleId
string

??

Example:
ID_MODULE_APP_BROKER
channelCode
string

??

Example:
WEB
timestamp
string
Example:
1600278165983
copyright
string
Example:
RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados
payload
Object nullable
cotizacion
string

Código a usar para el pago

Example:
57ab6452-779f-41c4-a88c-39fb15c90134
primaNeta
number

???

Example:
69.93
primaBruta
number

???

Example:
85
indicadorInspeccion
integer

???

Example:
0
financiamiento
integer

???

Example:
821
fechaInicio
string

???

Example:
2020-09-16
fechaFinal
string

???

Example:
2021-09-16
numeroCuotas
integer

???

Example:
1
cuotasFinanciamiento
Array
Object
cuota
integer
Example:
1
monto
number
Example:
85
fechaVencimiento
string
Example:
2020-10-16
status
Object
success
boolean
Example:
true
error
Object nullable

Esta propiedad solo aparece si el valor “success” es false

httpCode
integer

Código http de respuesta

Enumeration:
400
messages
Array of string
Example:
[
    "data/datosParticulares/0 debe tener la propiedad requerida valor",
    "data/datosParticulares/1 debe tener la propiedad requerida valor"
]
expires_in
string
Example:
300
ObjRimacPagoRequest

Estructura de petición para pagar la póliza del vehículo

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso del pago, usaremos “authorization”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

Viene del webservice anterior de ConsultaRimac ObjRimacConsultaRequest.retrievalReferenceNumber

Example:
554897499035
providerCode
integer required

Viene del webservice anterior de ConsultaRimac ObjRimacConsultaRequest.providerCode

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

Viene del webservice anterior de ConsultaRimac ObjRimacConsultaRequest.companyCode

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

Viene del webservice anterior de ConsultaRimac, ObjRimacConsultaRequest.customerServiceId

Example:
AMA611
amount
number required

Viene de la respuesta del webservice anterior de ConsultaRimac, ObjRimacConsultaResponse.serviceData.response.payload.cuotasFinanciamiento[0].monto

Example:
85
currencyCode
integer required

Moneda del pago, para este caso todo será en Nuevos soles

Enumeration:
604

Nuevos Soles

804

Dolares

localTransactionDateTime
string

Fecha y hora de la transaccion, se coloca ejemplo del formato YYYY-MM-DDTHHmmssZ

Example:
2018-06-26T205958Z
datamapping
Object required

Datos variables por petición, se detallan los usados para Rimac

params
Object required
traceId
string required

Viene del webservice anterior de ConsultaRimac, ObjRimacConsultaRequest.retrievalReferenceNumber

Example:
554897499035
tipoDocumento
string required

–>FALTA COMPLETAR ESTA LISTA

Enumeration:
1
2
4
6
numeroDocumento
string required

Número de documento del propietario del vehículo, si tipoDocumento es “1”, la longitud debe ser 11 caracteres, si tipoDocumento es “2” la longitud debe ser 8 caracteres, si tipoDocumento es “4” la longitud debe ser 9 caracteres, si tipoDocumento es “6” la longitud minima debe ser 1 y máximo 12 caracteres

Pattern: ^$|^[0-9]+$
Example:
12345678
cotizacion
string required

Viene de la respuesta del webservice anterior de ConsultaRimac, ObjRimacConsultaRequest.serviceData.response.payload.cotizacion

Min length: 36
Max length: 36
Pattern: ^[a-z0-9-]+$
Example:
57ab6452-779f-41c4-a88c-39fb15c90134
desusoVehiculo
string required

Descripción de uso del vehículo

Enumeration:
PARTICULAR

Vehículo Particular

AMBULANCIA

Vehículo Ambulancia

CARGA

Vehículo Carga

TAXI URBANO

Vehículo Taxi Urbano

monto
string

Viene de la respuesta del webservice anterior de ConsultaRimac, ObjRimacConsultaResponse.serviceData.response.payload.cuotasFinanciamiento[0].monto

Example:
85
correo
string

Email a donde desean que el API envie el SOAT digital de la compra (pdf de la poliza)

Max length: 250
Example:
jcamacho@vendemas.niubiz.com.pe
telefono
string required

Nro de celular de la persona que adquiere el SOAT

Max length: 20
Pattern: ^[0-9]+$
Example:
987654321
ObjRimacPagoResponse

Estructura de la respuesta de la consulta de placa

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string

Codigo de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required
Example:
request
productCode
string
Enumeration:
services
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
response
Object
trace
Object
traceId
string
Example:
6b10480f-af20-4676-a8e0-1df84dd7cdb6
consumerId
string
Example:
ID_APP_BROKER
serviceId
string
Example:
API-CANAL
moduleId
string
Example:
ID_MODULE_APP_BROKER
channelCode
string
Enumeration:
WEB
copyright
string
Example:
RIMAC Seguros y Reaseguros - 2019. Todos los derechos reservados
payload
Object
cotizacion
string

Código de la cotización obtenido de la consulta de placa

Example:
bfa43d46-2322-4efb-b6a1-9085dc218bf9
poliza
string

Número de poliza

Example:
2101-16897
primaNeta
number

???

Example:
998.46
primaBruta
string

???

Example:
1213.52
indicadorInspeccion
string

???

Enumeration:
0
indicadorGps
string

???

Enumeration:
0
envioElectronico
string
Enumeration:
S

Si

financiamiento
number
Example:
1753
fechaInicio
string
Example:
2019-07-23
fechaFinal
string
Example:
2020-07-23
numeroCuotas
integer
Example:
12
cuotasFinanciamiento
Array
Object
cuota
integer
Example:
1
monto
number
Example:
101.13
fechaVencimiento
string
Example:
2019-07-30
contratante
Object

???

tercero
integer

???

Example:
25752127
tipoDocumento
integer
Enumeration:
1
2
numeroDocumento
string
Example:
43461755
apellidoMaterno
string
Example:
CUMPA
apellidoPaterno
string
Example:
PAEZ
nombres
string
Example:
JORGE ANTONIO
fechaNacimiento
string
Example:
1985-12-04
sexo
string

??

Enumeration:
M
F
tipoVia
string

¿¿

Enumeration:
CL
nombreVia
string

??

Example:
IMAGINARIA
numeroVia
string

??

Example:
29
distrito
string

??

Example:
150103
nombreDistrito
string
Example:
ATE
correo
string
Example:
correo@gmail.com
telefono
string
Example:
987654321
responsablePago
Object
tercero
string
Example:
25752127
tipoDocumento
string
Enumeration:
1
2
numeroDocumento
string
Example:
43461755
apellidoMaterno
string
Example:
CUMPA
apellidoPaterno
string
Example:
PAEZ
nombres
string
Example:
JORGE ANTONIO
fechaNacimiento
string
Example:
1985-12-04
sexo
string
Enumeration:
M
F
tipoVia
string
Enumeration:
CL
nombreVia
string
Example:
IMAGINARIA
numeroVia
string
Example:
29
distrito
string

Ubigeo del distrito

Example:
150103
nombreDistrito
string

Nombre del distrito

Example:
ATE
correo
string
Example:
correo@gmail.com
telefono
string
Example:
1234566789
asegurado
Object
tercero
integer
tipoDocumento
string
Enumeration:
1
2
numeroDocumento
string
apellidoMaterno
string
apellidoPaterno
string
nombres
string
fechaNacimiento
string
sexo
string
tipoVia
string
nombreVia
string
numeroVia
string
distrito
string
nombreDistrito
string
correo
string
telefono
string
endosatario
Object
porcentajeParticipacion
integer
Example:
100
monto
string
Example:
22953
status
Object
success
boolean
Example:
true
expires_in
string
Example:
300
Banbif Estructuras
ObjBanbifConsultaRequest
  • Task item

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Banbif, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
906805311445
providerCode
integer required

Código del proveedor del servicio, para este caso usaremos el código de Rimac

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

Código del documento asociado al servicio a consultar (placa, idrecibo, cip, numerosuministro)

Min length: 1
Max length: 14
Example:
543410
localTransactionDateTime
string

??? ESTA EN EL POSTMAN PERO NO EN EL WORD

Example:
2018-06-26T205958Z
datamapping
Object required

Datos variables por petición, se detallan los usados para Rimac

params
Object required
codigoConvenio
integer required

El listado es el siguiente

Enumeration:
30

Claro-Pago con código

31

Claro-3 play

32

Claro-Recargas

36

Claro-Televisión Digital (Cable)

37

Claro-Recibos de celular

1

Calidda ( en desarrollo usar 13)

29

Sedapal (en desarrollo usar 86)

46

Telefonica del Peru-Nro Fijo

47

Telefonica del Peru-Recibo de Celular

48

Telefonica del Peru-Cable Magico

49

Telefonica del Peru-Telefonia Publica

38

Luz del Sur-Recibos

43

Entel-Recibos

9

Enel-Recibos

42

Mapfre-Recibos

39

Seal-Recibos

16

Hidrandina-Recibos

18

ElectroNorte-Recibos

17

ElectroNoroeste-Recibos

19

ElectroCentro-Recibos

40

Compartamos Financiera-Cuota

41

Pago Directo-Pago Soles

13

Electro Ucayali-Pago Soles

idServicio
string required

Número de suministro y/o servicio, lo mismo que en customerServiceId

Example:
543410
idTransaccionOrigen
string required

Identificador de la transaccion, timestamp en formato de año-mes-dia-hora-minuto-segundo

Pattern: ([0-9]{4})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])(2[0-3]|[01][0-9])([0-5][0-9])([0-5][0-9])
Example:
20200916054741
fechaHora
string required

Fecha y hora de la transaccion, formato YYYYMMDDHHmmss

Pattern: ([0-9]{4})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])(2[0-3]|[01][0-9])([0-5][0-9])([0-5][0-9])
Example:
20200916054748
ObjBanbifConsultaResponse

Estructura de la respuesta de la búsqueda del servicio a pagar en BANBIF

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error interno

98

Error controlado

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicePayment”

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
meta
Object

??

mensajes
Array

??

Object
codigo
string

??

Example:
ESM00
mensaje
string

??

Example:
Proceso Exitoso
tipo
string

??

Enumeration:
info
totalRegistros
integer
idTransaccion
string
Example:
590626774843027
datos
Array
Object
fechaVencimiento
string

??

Example:
2020-02-21
cliente
Object

??

id
string

??

glosaCampana
string

??

Example:
PAGO DE RECIBOS SOLES CALIDDA
montoSaldoOrigen
number

0

montoDescuentoOrigen
number

0

montoMultaOrigen
number

0

montoVencidoOrigen
number

35.3

montoInteresOrigen
number

0

montoReajusteOrigen
number

0

montoTotalOrigen
number

35.3

montoSaldoDestino
number

0

montoDescuentoDestino
number

0

montoMultaDestino
number

0

montoVencidoDestino
number

35.3

montoInteresDestino
number

0

montoReajusteDestino
number

0

montoTotalDestino
number

35.3

montoRedondeo
number

35.3

comisionCliente
number

0

documento
Object
numero
string
Example:
S00100136783
idConsulta
string
Example:
7022724
convenio
Object
codigo
string
Example:
13
servicios
Array
Object
id
string
Example:
543408
moneda
string
Enumeration:
SOL

Nuevos Soles

fechaFactura
string
Example:
2020-02-06
datosAdicionales
Array
Object
nombre
string

Descripcion de la clave

Examples:
NombreFec Emision
valor
string

Valor de la clave

Examples:
AVILA MONTANO LUISA MARIELA20200206
expires_in
string
Example:
300
ObjBanbifPagoRequest

Estructura de petición para pago con BANBIF

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso del pago, usaremos “authorization”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

El mismo usado en consulta Banbif ObjBanbifConsultaRequest.retrievalReferenceNumber

Example:
554897499035
providerCode
integer required

El mismo usado en consulta Banbif ObjBanbifConsultaRequest.providerCode

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

El mismo usado en consulta Banbif ObjBanbifConsultaRequest.companyCode

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

El mismo usado en consulta Banbif ObjBanbifConsultaRequest.customerServiceId

Min length: 1
Max length: 14
Example:
543410
amount
number required

Del objeto ObjBanbifConsultaResponse del webservice de Consulta Banbif, serviceData.datos[i].montoTotalOrigen

Example:
85
currencyCode
integer required

Moneda del pago, para este caso todo será en Nuevos soles

Enumeration:
604

Nuevos Soles

804

Dolares

localTransactionDateTime
string

Fecha y hora de la transaccion, se coloca ejemplo del formato YYYY-MM-DDTHHmmssZ

Example:
2018-06-26T205958Z
datamapping
Object
params
Object
codigoConvenio
string

ObjBanbifConsultaRequest.datamapping.params.codigoConvenio

nombreConvenio
string

El listado es el siguiente

Enumeration:
Claro

Cuando el codigoConvenio sea 30,31,32,36 o 37

Calidda

Cuando el codigoConvernio sea 1 (o 13 en desarrollo)

Sedapal

Cuando el codigoConvenio sea 29 (o 86 en desarrollo)

Telefónica del Perú

Cuando el codigoConvenio sea 46,47,48 o 49

Luz del Sur

Cuando el codigoConvenio sea 38

Entel

Cuando el codigoConvenio sea 43

Enel

Cuando el codigoConvenio sea 9

Mapfre

Cuando el codigoConvenio sea 42

Seal

Cuando el codigoConvenio sea 39

Hidrandina

Cuando el codigoConvenio sea 16

Electro Norte

Cuando el codigoConvenio sea 18

Electro Noroeste

Cuando el codigoConvenio sea 17

Electro Centro

Cuando el codigoConvenio sea 19

Compartamos Financiera

Cuando el codigoConvenio sea 40

Pago Directo

Cuando el codigoConvenio sea 41

Electro Ucayali

Cuando el codigoConvenio sea 13

comisionUsuario
number

ObjBanbifConsultaResponse.serviceData.datos[i].comisionCliente

idTransaccionOrigen
string

ObjBanbifConsultaRequest.retrievalReferenceNumber

montoDescuentoDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoDescuentoDestino

montoSaldoDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoSaldoDestino

montoMultaDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoMultaDestino

montoVencidoDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoVencidoDestino

montoInteresDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoInteresDestino

montoReajusteDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoReajusteDestino

montoTotalDestino
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoTotalDestino

fechaVencimiento
string

ObjBanbifConsultaResponse.serviceData.datos[i].fechaVencimiento

fechaHora
string YYYYMMDDHHMMSS

Fecha y hora de la transaccion

Example:
20200916062634
monto
number

Del objeto ObjBanbifConsultaResponse del webservice de Consulta Banbif, SI serviceData.datos[i].montoRedondeo !== serviceData.datos[i].montoTotalDestino ENTONCES Monto = serviceData.datos[i].montoRedondeo SINO Monto = serviceData.datos[i].montoTotalDestino

documento
Object
numero
string

ObjBanbifConsultaResponse.serviceData.datos[i].documento.numero

servicios
Array
Object
id
string

Lo mismo que customerServiceId

idConsulta
string

ObjBanbifConsultaResponse.serviceData.datos[i].idConsulta

Min length: 1
Max length: 20
montoSaldoOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoSaldoOrigen

montoDescuentoOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoDescuentoOrigen

montoMultaOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoMultaOrigen

montoVencidoOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoVencidoOrigen

montoInteresOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoInteresOrigen

montoReajusteOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoReajusteOrigen

montoTotalOrigen
string

ObjBanbifConsultaResponse.serviceData.datos[i].montoTotalOrigen

idServicio
string

Lo mismo que customerServiceId

ObjBanbifPagoResponse

Estructura de la respuesta del pago en BANBIF

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error interno

98

Error controlado

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicePayment”

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
meta
Object

??

mensajes
Array

??

Object
codigo
string

??

Example:
ESM00
mensaje
string

??

Example:
Proceso Exitoso
tipo
string

??

Enumeration:
info
totalRegistros
integer
Example:
1
idTransaccion
string
Example:
590626774843027
datos
Array
Object
fechaVencimiento
string

??

Example:
2020-02-21
cliente
Object

??

id
string

??

glosaCampana
string

??

Example:
PAGO DE RECIBOS SOLES CALIDDA
montoSaldoOrigen
number

0

montoDescuentoOrigen
number

0

montoMultaOrigen
number

0

montoVencidoOrigen
number

11.4

montoInteresOrigen
number

0

montoReajusteOrigen
number

0

montoTotalOrigen
number

11.4

comisionCliente
number

0

documento
Object
numero
string
Example:
000000100199775
idConsulta
string
Example:
1178992
servicios
Array
Object
id
string
Example:
106920
moneda
string
Enumeration:
SOL

Nuevos Soles

datosAdicionales
Array
Object
nombre
string

Descripcion de la clave

Examples:
NombreNro CuentaNom Emp Serv
valor
string

Valor de la clave

Examples:
AVILA MONTANO LUISA MARIELA20200206
pagos
Array
Object
monto
number
Example:
11.4
cuentaCargo
Object
numero
string
tipoOperacion
string
Enumeration:
PAGO_TOTAL_CUOTA
datosAdicionales
Array

???

Object
comprobante
string

??

numeroPago
string
Example:
118651
expires_in
string
Example:
300
PagoEfectivo Estructuras
ObjPagoEfectivoConsultaRequest

Estructura de petición para consultar en PagoEfectivo

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
providerCode
integer required

Código del proveedor del servicio, para este caso usaremos el código de PagoEfectivo

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

Código de servicio a consultar (cip).

Min length: 1
Max length: 14
Example:
2555590
localTransactionDateTime
string

Fecha y hora de la transaccion, se coloca ejemplo del formato YYYY-MM-DDTHHmmssZ

Example:
2018-06-26T205958Z
datamapping
Object required

Datos variables por petición, se detallan los usados para Rimac

params
Object required
orderNumber
string required

Lo mismo que el customerServiceId

Min length: 1
Max length: 14
Example:
2555590
operationNumber
string required

Lo mismo que el retrievalReferenceNumber

Min length: 1
Max length: 14
Example:
554897499035
terminalNumber
string required
Min length: 1
Max length: 14
Example:
12345567
ObjPagoEfectivoConsultaResponse

Estructura de la respuesta de la consulta de PagoEfectivo

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string

–>FALTA ESPECIFICAR QUE ES ESTE CODIGO

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error interno

98

Error controlado

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicePayment”

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
code
string

Código interno de respuesta

Enumeration:
100

Correcto

151

Error

message
string
Example:
Solicitud exitosa
data
Object
responseDate
string
Example:
2020-08-06T15:17:11-05:00
user
string
Example:
Prueba
terminalNumber
string
Example:
12345567
operationNumber
string
Example:
875966491473
orderNumber
string
Example:
2555590
documentsQuantity
integer
Example:
1
portal
string
Example:
PagoEfectivo
variable1
string
variable2
string
documentsDetail
Array
Object
cip
string
Example:
2555590
total
integer
Example:
1
amount
number
latePaymentFee
number
currency
string
Example:
PEN
issueDate
string
Example:
2020-07-09T14:57:30-05:00
expirationDate
string
Example:
2020-08-14T12:19:00-05:00
description
string
Example:
Compra con PagoEfectivo
agreementCode
string
Example:
001200
expires_in
string
Example:
300
ObjPagoEfectivoPagoRequest

Estructura de petición para pago en PagoEfectivo

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicepayment”

Enumeration:
servicepayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso del pago, usaremos “authorization”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object required

Objeto con datos de la cuenta

coreAccountId
string required

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string required

Llave del comercio en backend OWNER ID

Example:
yJIof2T9bSTyxcJwN4pL
retrievalReferenceNumber
string required

ObjPagoEfectivoConsultaRequest.retrievalReferenceNumber

Example:
554897499035
providerCode
integer required

ObjPagoEfectivoConsultaRequest.providerCode

Enumeration:
900001

Rimac

900002

Banbif

900003

Pagoefectivo

companyCode
integer required

ObjPagoEfectivoConsultaRequest.companyCode

Enumeration:
700001

Niubiz

700002

Vendemas

customerServiceId
string required

ObjPagoEfectivoConsultaRequest.customerServiceId

Example:
2555590
amount
number required

serviceData.data.documentsDetail.amount

Example:
85
currencyCode
integer required

Moneda del pago, para este caso todo será en Nuevos soles

Enumeration:
604

Nuevos Soles

840

Dolares

localTransactionDateTime
string

Fecha y hora de la transaccion, se coloca ejemplo del formato YYYY-MM-DDTHHmmssZ

Example:
2018-06-26T205958Z
datamapping
Object
params
Object
orderNumber
string required

Lo mismo que el customerServiceId

Min length: 1
Max length: 14
Example:
2555590
operationNumber
string required

Lo mismo que el retrievalReferenceNumber

Min length: 1
Max length: 14
Example:
554897499035
terminalNumber
string required

ObjPagoEfectivoConsultaRequest.datamapping.params.terminalNumber

Example:
12345567
documentsDetail
Array

ObjPagoEfectivoConsultaResponse.serviceData.data.documentsDetail

Object
cip
string
Example:
2555590
total
integer
Example:
1
amount
integer
Example:
1
latePaymentFee
integer
currency
string
Example:
PEN
issueDate
string
Example:
2020-07-09T14:57:30-05:00
expirationDate
string
Example:
2020-08-14T12:19:00-05:00
description
string
Example:
Compra con PagoEfectivo
agreementCode
string
Example:
001200
responseDate
string required

ObjPagoEfectivoConsultaResponse.serviceData.data.responseDate

ObjPagoEfectivoPagoResponse

Estructura de la respuesta del pago en PagoEfectivo

Object
retrievalReferenceNumber
string required

Valor string (numérico de 15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago), generarlo con un aleatorio entre 100000000000 y 999999999999

Example:
554897499035
authorizationId
string
Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error interno

98

Error controlado

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “servicePayment”

Enumeration:
servicePayment

Pago de servicios

receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

messageTypeIdentifier
string required

Colocar el valor 200

Example:
200
productCode
string required

Para este caso con Rimac, en este request usaremos “services”

Enumeration:
services

Pago de servicios

authorization

Autorizacion del pago

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request (idTransaction), formato UUID

Example:
ab4b4ec1-fd1d-4334-b010-13ab18eb693e
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string
Example:
get
serviceData
Object
code
integer
Enumeration:
100

Correcto

111

Solicitud con datos inválidos

message
string
data
Object

Cuando es incorrecto, será un array indicando los tipos de errores

responseDate
string
movementNumber
string
salePointCode
string
terminalNumber
string
operationNumber
string
documentsQuantity
string
documentsDetail
Array
Object
movementNumber
string
Example:
692903
cip
string
Example:
2555590
variable1
string
variable2
string
expires_in
string
Example:
300
PagoServicios Estructuras
ObjPagoServiciosConsultaRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “receiptsInquiry”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Enumeration:
services

Pago de servicios

recharge

Autorizacion del pago

activate

Activación de la tarjeta

balance

Balance de la tarjeta

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
serviceCode
Object required

Objeto con datos de la entidad a consultar

serviceCode
string required

Entidad a consultar

Example:
RECTLF01, RECTLF02, RECLARO1, VIET0002, DISLUZ01, LUZSUR01
customerServiceId
string required

Código del documento asociado al servicio a consultar (placa, idrecibo, cip, numerosuministro)

Example:
yJIof2T9bSTyxcJwN4pL
ObjPagoServiciosConsultaResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

Valor string (numérico de 12-15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago)

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Enumeration:
services

Pago de servicios

recharge

Autorizacion del pago

activate

Activación de Tarjetas

balance

Balance de Tarjeta

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos de la transacción a pagar

customerServiceId
string

Código identificador del cliente

Example:
953616571
serviceName
string

Nombre del servicio a pagar

Example:
Cel. pospago/RPM
customerName
string

Nombre del cliente

Example:
BENITO ALLCA CHAHUARES
receipts
Array
Object
receiptId
string

ID del recibo a pagar

Example:
M000000915
receiptAmount
string

Monto real del recibo

Example:
50.00
receiptServiceFee
string

Comisión del recibio

Example:
1.00
receiptPayingAmount
string

Monto total a pagar

Example:
51.00
receiptIssueDate
string

Fecha de recibo

Example:
08-07-2017
referenceId
string

ID de referencia asociada al recibo a pagar

Example:
124519000970
expires_in
string
Example:
300
ObjPagoServiciosPagoRequest

Estructura de petición para el pago del servicio escogido en la consulta del recibo

Object
retrievalReferenceNumber
string

Valor string que identifica la operación asociada a la consulta de recibo a pagar

Example:
92817283937812
messageType
string required

Identificador de la operación

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
services
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

serviceCode
string required

Entidad a pagar

Example:
RECTLF01, RECTLF02, RECLARO1, VIET0002, DISLUZ01, LUZSUR01
referenceId
string required

ID de referencia asociada al recibo a pagar

Example:
124519000970
receiptId
string

ID del recibo a pagar

Example:
M000000915
ObjPagoServiciosDistriluzPagoRequest

Estructura de petición para el pago del servicio escogido en la consulta del recibo

Object
retrievalReferenceNumber
string

Valor string que identifica la operación asociada a la consulta de recibo a pagar

Example:
92817283937812
messageType
string required

Identificador de la operación

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
services
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

paymentType
string

Tipo de pago

Example:
1551
serviceCode
string required

Entidad a pagar

Example:
DISLUZ01
referenceId
string required

ID de referencia asociada al recibo a pagar

Example:
124519000970
receiptId
string

ID del recibo a pagar

Example:
M000000915
ObjPagoServiciosPagoResponse

Estructura de la respuesta para el pago de un servcio

Object
retrievalReferenceNumber
string required

Valor string (numérico de 12-15 longitud) que identifica la operación(conjunto de transacciones), de debe mandar un único valor por toda la operacion(consulta y pago)

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “services”

Enumeration:
services

Pago de servicios

recharge

Autorizacion del pago

activate

Activación de Tarjetas

balance

Balance de Tarjeta

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos de la transacción a pagar

customerServiceId
string

Código identificador del cliente

Example:
953616571
serviceName
string

Nombre del servicio a pagar

Example:
Cel. pospago/RPM
customerName
string

Nombre del cliente

Example:
BENITO ALLCA CHAHUARES
receipts
Array
Object
receiptId
string

ID del recibo a pagar

Example:
M000000915
receiptAmount
string

Monto real del recibo

Example:
50.00
receiptServiceFee
string

Comisión del recibio

Example:
1.00
receiptPayingAmount
string

Monto total a pagar

Example:
51.00
receiptIssueDate
string

Fecha de recibo

Example:
08-07-2017
referenceId
string

ID de referencia asociada al recibo a pagar

Example:
124519000970
receiptId
string

ID del recibo a pagar

Example:
M000000915
coreAcctInitialBalance
string

Saldo inicial del comercio

Example:
845550.675
coreAcctEarnedFee
string

Comisión ganada por el comercio

Example:
0.350
coreAcctCurrentBalance
string

Saldo final del comercio

Example:
845500.025
expires_in
string
Example:
300
ObjPagoServicioLuzSurPagoRequest

Estructura de petición para el pago del servicio escogido en la consulta del recibo

Object
retrievalReferenceNumber
string

Valor string que identifica la operación asociada a la consulta de recibo a pagar

Example:
92817283937812
messageType
string required

Identificador de la operación

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
services
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

serviceCode
string required

Entidad a pagar

Example:
LUZSUR01
referenceId
string required

ID de referencia asociada al recibo a pagar

Example:
124519000970
paymentType
string

Tipo de pago

Example:
1
Recargas Estructuras
ObjRecargasRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
recharge
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
amount
string

Monto a recargar

Example:
3
companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

currencyCode
string

Codigo de moneda

Enumeration:
604

soles

accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
rechargeInfo
Object required

Objeto con datos del telefono a recargar

telephoneNumber
string required

Número a recargar

Example:
989133123
telcoId
string required

Entidad a consultar

Example:
CLARO000,NEXTEL00,VIET0001
ObjRecargasResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “authorization”

Example:
recharge
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
Saldo: 51.349,63
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
coreAcctInitialBalance
string

Saldo inicial del comercio

Example:
845550.675
coreAcctEarnedFee
string

Comisión ganada por el comercio

Example:
0.350
coreAcctCurrentBalance
string

Saldo final del comercio

Example:
845500.025
expires_in
string
Example:
300
Tarjetas Estructuras
Activacion
ObjTarjetaActivacionRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “recharge”

Example:
recharge
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
activateInfo
Object required

Objeto con datos de la tarjeta a activar

customerId
string required
Example:
70814369
param1
string required

Tarjeta a activar

Example:
4894861000001582
param2
string

parametro 2

param3
string

parametro 3

ObjTarjetaActivacionResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
activate
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
productData
Object
productNumber
string

id de la tarjeta

Example:
4894865100022273
productId
string

id del producto

Example:
TRANSP01
currentBalance
string

Saldo actual de la tarjeta prepagada

Example:
6.00
promo
string

promo

Example:
1
idTxn
string

ID transaccion externa

Example:
5046039969
Balance
ObjTarjetaBalanceRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación

Example:
receiptsInquiry
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “balance”

Example:
balance
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
productInfo
Object required

Objeto con datos de la tarjeta a recargar

productNumber
string required

Número de la tarjeta

Example:
4894861100009188
productId
string required

Entidad a consultar

Example:
TRANSP01
ObjTarjetaBalanceResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
receiptsInquiry
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
balance
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object
href
string
Example:
/self/self/request/456540554752
method
string
Example:
get
productData
Object
productNumber
string

id de la tarjeta

Example:
4894865100022273
productId
string

id del producto

Example:
TRANSP01
currentBalance
string

Saldo actual de la tarjeta prepagada

Example:
6.00
Recarga
ObjTarjetaRecargasRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación

Enumeration:
authorization

Autorización de transacción

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “recharge”

Example:
recharge
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
amount
string

Monto a recargar

Example:
3
companyCode
integer required

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

currencyCode
string

Codigo de moneda

Enumeration:
604

soles

accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
rechargeInfo
Object required

Objeto con datos del telefono a recargar

rechargeNumber
string required

Número de la tarjeta a recargar

Example:
4894861100009188
telcoId
string required

Entidad a consultar

Example:
TRANSP01
ObjTarjetaRecargasResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
authorization
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “authorization”

Example:
recharge
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
Saldo: 51.349,63
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
coreAcctInitialBalance
string

Saldo inicial del comercio

Example:
845550.675
coreAcctEarnedFee
string

Comisión ganada por el comercio

Example:
0.350
coreAcctCurrentBalance
string

Saldo final del comercio

Example:
845500.025
expires_in
string
Example:
300
General Estructuras
Balance Estructura
ObjBalanceRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “recharge”

Enumeration:
services

Pago de servicios

recharge

Autorizacion del pago

activate

Activación de la tarjeta

balance

Balance de la tarjeta

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
amount
string

Monto a recargar

Example:
3
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
pointOfInteraction
Object
gpsLocation
Object
latitude
string

latitud

Example:
10.037990
longitude
string

longitud

Example:
-84.081742
email
string

email

Example:
test@test.test
telephone
string

telefono

Example:
981212912
userIdentification
string

Número de identificación

Example:
48121213
ObjBalanceResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “balanceInquiry”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

balanceInquiry

Balance de cuenta cupo

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
Saldo: 51.349,63
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
balances
Object
accountBalance1
Object
balanceName
string

Nombre del balance

Example:
Ledger balance
balanceCurrencyCode
string

Moneda del balance

Example:
604
balance
string

Balance actual de la cuenta cupo

Example:
315
expires_in
string
Example:
300
Usuario Estructura
ObjUsuarioRequest

Estructura de petición para consultar los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

createAccount

Creacion de cuenta cupo

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
newAccount
Object

Objeto con datos de la cuenta

accountCurrencyCode
string

Codigo de moneda de la cuenta cupo

Example:
604
commerce
Object

Objeto con datos del comercio

commerceName
string

Nombre del comercio

Example:
Comercio Ict250
merchantCategoryCode
string

Categoria del comercio

Example:
5661
commerceId
string

ID del comercio

Example:
341198217
companyCode
string

Código de la empresa, para este negocio usaremos el de Vendemás

Enumeration:
700001

Niubiz

700002

Vendemas

address
Object
commerceCountryAlphaCode
string

Código de país

Example:
PE
commerceStateAlphaCode
string

Código del estado

Example:
LIM
commerceCity
string

Nombre ciudad donde se encuentra el comercio

Example:
Lima
terminal
Object
terminalSeries
string

Serie terminal

Example:
24940273
model
string

Modelo terminal

Example:
ICT 220
commerceTelephone
string

Telefono del Comercio

Example:
2202409
legalRepresentative
Object

Objeto con datos del representante legal

representativeName
string

Nombre representante

Example:
Visanet Ict220
representativeIdType
string

Tipo ID representante

Example:
1
representativeId
string

ID representante

Example:
37204955
representativeTelephone
string

Telefono representante

Example:
990456222
representativeEmail
string

Email representante

Example:
jessica.mellina@gmail.com
ObjUsuarioResponse

Estructura de respuesta de la consulta de los datos del recibo, celular, etc, todo de acuerdo al servicio elegido

Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación. La respuesta devolverá ‘createAccount’

Enumeration:
receiptsInquiry

Consulta de recibos

authorization

Autorización de transacción

conduent

Operaciones tipo conduent

balanceInquiry

Balance de cuenta cupo

createAccount

Creación de cuenta

messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
Cuenta creada
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
accountCurrencyCode
string

Código de moneda

Example:
604
ownerId
string

Llave del comercio en backend Owner ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
newAccountId
string

Llave del comercio en backend Account ID

Example:
yJIof2T9bSTyxcJwN4pL
complementaryCode
string

Código cuenta cupo del comercio

Example:
ijfs9dbiro
newUserId
string

id usuario

Example:
47204972
newPassword
string

password usuario

Example:
918448
BBVA Estructura
Conduent Estructuras
GetVersion Estructura
ObjGetVersionRequest
Object
messageType
string

Identificador de la operación

Example:
conduent
productCode
string

Código del producto

Example:
getversion
ObjGetVersionResponse
Object
retrievalReferenceNumber
string

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58245
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

messageType
string

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string

Código del producto

Default:
getversion
responseMessage
string

Mensaje de retorno de la ejecución

Example:
WS : 1.0.10.1 - 32
expires_in
string
Example:
300
GetCardKeys Estructura
ObjGetCardKeysRequest
Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string required

Código del producto

Default:
getcardkeys
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pCardReaderId
string

ID del terminal

Example:
M000000915
ObjGetCardKeysResponse
Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
getcardkeys
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
keys
Array

Llaves de la tarjeta

string
Example:
63c03ae52657
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
GetCardInfo Estructura
ObjGetCardInfoRequest
Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string required

Código del producto

Default:
getcardinfo
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
currencyCode
string

Codigo de moneda

Example:
604
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pCardReaderId
string

ID del terminal

Example:
M000000915
pData
string

Información hexadecimal de la tarjeta

Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pSaleId
string

ID de la transaccion de la venta

Example:
200323102010965571997
ObjGetCardInfoResponse
Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “services”

Example:
getcardinfo
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
cardState
string

Estado de la tarjeta

Example:
1
cardId
string

ID de la tarjeta

Example:
3280519501
balance
string

Balance de la tarjeta

Example:
45
minReloadAmount
string

monto minimo de recarga

Example:
10
maxReloadAmount
string

monto máximo de recarga

Example:
48260
cardPrice
string

Precio de la tarjeta

Example:
0
tariff
string

Descripción de la tarjeta

Example:
Tarjeta CC con valor anonymo
userProfile
string

Perfil del usuario

Example:
Perfil anónimo
endValidityDate
string

Fecha de expiración

Example:
20390228
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
LoadCard Estructura
ObjGetLoadCardRequest
Object
messageType
string required

Identificador de la operación

Example:
conduent
productCode
string required

Código del producto

Default:
loadcard
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
currencyCode
string

Codigo de moneda

Example:
604
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pData
string required

Información hexadecimal de la tarjeta

Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pLoadAmount
string required
Example:
25
pSaleDate
string required
Example:
20200311193202
pSalePointId
string required
Example:
0
pSellerId
string required
Example:
0
pServiceId
string required
Example:
0
pSaleId
string required

ID de la transaccion de la venta

Example:
2003111932022530603506
pCardReaderId
string required

ID del terminal

Example:
M000000915
ObjGetLoadCardResponse
Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación, para este caso solo usaremos “authorization”

Example:
conduent
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “services”

Enumeration:
services

Pago de servicios

recharge

Autorizacion del pago

activate

Activación de Tarjetas

balance

Balance de Tarjeta

systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
cardFamily
string

Estado de la tarjeta

Example:
1
reloadId
string
cardId
string

ID de la tarjeta

Example:
3280519501
balance
string

Balance de la tarjeta

Example:
45
actions
Object
Action
Array
Object
ActionType
string

Tipo de acción a realizar en la tarjeta

Example:
4
RecordNo
string

Bloque de la tarjeta a modificar

Example:
8
Data
string

Data a escribir en la tarjeta

Example:
209601000000000a299f7f0115220228
OrgRecordNo
string
Example:
0
Value
string
Example:
0
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
ReloadCard Estructura
ObjGetReloadCardRequest
Object
messageType
string required

Identificador de la operación

Example:
conduent
productCode
string required

Código del producto

Default:
reloadcard
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
currencyCode
string

Codigo de moneda

Example:
604
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pData
string required

Información hexadecimal de la tarjeta

Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pReloadAmount
string required

monto a recargar

Example:
25
pSaleDate
string required
Example:
20200311193202
pSalePointId
string required
Example:
0
pSellerId
string required
Example:
0
pServiceId
string required
Example:
0
pSaleId
string required

ID de la transaccion de la venta

Example:
2003111932022530603506
pCardReaderId
string required

ID del terminal

Example:
M000000915
ObjGetReloadCardResponse
Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto

Example:
reloadcard
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
cardFamily
string

Estado de la tarjeta

Example:
1
reloadId
string
cardId
string

ID de la tarjeta

Example:
3280519501
balance
string

Balance de la tarjeta

Example:
45
actions
Object
Action
Array
Object
ActionType
string

Tipo de acción a realizar en la tarjeta

Example:
4
RecordNo
string

Bloque de la tarjeta a modificar

Example:
8
Data
string

Data a escribir en la tarjeta

Example:
209601000000000a299f7f0115220228
OrgRecordNo
string
Example:
0
Value
string
Example:
0
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
GetReloadTerminated Estructura
ObjGetReloadTerminatedRequest
Object
messageType
string required

Identificador de la operación

Example:
conduent
productCode
string required

Código del producto

Default:
getreloadterminated
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
currencyCode
string

Codigo de moneda

Example:
604
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pReloadAmount
string required

Monto de la recarga a confirmar

Example:
25
pData
string required

Información hexadecimal de la tarjeta

Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pSaleDate
string required

Fecha de la transaccion

Example:
20200311193202
pSalePointId
string required

ID punto de venta

Example:
0
pSellerId
string required

ID vendedor

Example:
0
pServiceId
string required

ID Servicio

Example:
0
pSaleId
string required

ID de la transaccion de la venta

Example:
2003111932022530603506
pCardReaderId
string required

ID del terminal

Example:
M000000915
ObjGetReloadTerminatedResponse
Object
retrievalReferenceNumber
string required

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

Example:
554897499035
authorizationId
string

Código de autorizacion

Example:
58524
responseCode
string

Código de respuesta del API

Enumeration:
00

Correcto

96

Error

terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
messageType
string required

Identificador de la operación

Example:
conduent
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
productCode
string required

Código del producto, para este caso solo usaremos “services”

Example:
getreloadterminated
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
abc123abc245
responseMessage
string

Mensaje de retorno de la ejecución

Example:
transacción completada satisfactoriamente
selfLink
Object

Datos adicionales para ubicar la transacción en el servidor

href
string

Url a buscar

Example:
/self/self/request/554897499035
method
string

Tipo de metodo

Example:
get
serviceData
Object

Objeto con datos devueltos de canales

header
Object
errorCode
string

Código de error

errorMessage
string

Mensaje de error

millis
string
Example:
1925
transactionUUID
string

UUID de la transacción

executionDate
string

Fecha de ejecucion en unixtime

data
Object
status
string

Estado

Example:
0
claimId
string

id de reclamo

Example:
0
cardFamily
string

Estado de la tarjeta

Example:
1
cardId
string

ID de la tarjeta

Example:
3280519501
balance
string

Balance de la tarjeta

Example:
45
externalTransactionId
string

ID Transaccion externo

Example:
5JtYAHlOwJnAfvgMNxJ827R6j7IQb0FqiCtF
expires_in
string
Example:
300
VerifyClaimId Estructura
ObjVerifyClaimIdRequest
Object
messageType
string required

Identificador de la operación, para este caso solo usaremos “conduent”

Example:
conduent
productCode
string required

Código del producto

Default:
verifyclaimid
messageTypeIdentifier
string required

Identificador de la petición

Example:
request
systemTraceNumber
string required

Valor String que identifica la transacción, se debe mandar un valor diferente en cada request

Example:
12342abcde123
localTransactionDateTime
string

Fecha de la transacción

Example:
2018-06-26T205958Z
currencyCode
string

Codigo de moneda

Example:
604
cardAcceptorId
string required

Llave del comercio en backend “Acceptor ID”

Example:
WxZSbtwIbMjY5dA
terminalId
string required

Llave del comercio en backend “Terminal ID”

Example:
5ZJIm9ni
accountInfo
Object

Objeto con datos de la cuenta

coreAccountId
string

Llave del comercio en backend Account ID

Example:
3DFXEg7wU2xNWzcDRnQ1Im96Pu7nJBaynG
ownerId
string

Llave del comercio en backend Owner ID

Example:
yJIof2T9bSTyxcJwN4pL
serviceInfo
Object required

Objeto con datos de la entidad a consultar

pCardFamily
string required

Tipo de tarjeta

Default:
1
pCardId
string required

ID de la tarjeta

Example:
2530561746
pData
string required

Información hexadecimal de la tarjeta

Example:
9D758D395C080400A1B90C1741900917000000000004180009114C494D412020000000000000000000398D759D03010000000000000070F878000000000000000052CF828A67C0000000000000000000000000000000000000000000001CB91F0000000000000000...
pClaimId
string required

ID reclamo

Example:
125502003112358460
pSalePointId
string required

ID punto de venta

Example:
0
pSaleId
string required

ID de la transaccion de la venta

Example:
2003111932022530603506
pCardReaderId
string required

ID del terminal

Example:
M000000915