Pago Móvil (P2C)

Revisiones

Fecha	Autor	Descripción
27-03-2023	Dennis Castillo	Documentación Inicial

Introducción

Este documento proporciona las especificaciones para implementar la validación de pago móvil (P2C) a través del API de Luka.

La URL de cada ambiente se especifica a continuación:

• Calidad: https://bspaycoapi-qa.payco.net.ve
• Producción: https://lukaapi.payco.net.ve

Autenticación

La autenticación se realiza a través de un token (JWT) que retorna el método de login con las credenciales proporcionadas por Lukapay.

Request

POST {URL}/api/v1/servicio/login

Headers

Content-Type: application/json

Request Body

{
  "Username": "usuario_comercio",
  "Password": "password-comercio"
}

El token se encuentra en el header de la respuesta de la consulta como se muestra a continuación:

HTTP/1.1 200 OK
Date: Mon, 27 Mar 2023 21:53:05 GMT
Content-Type: text/plain; charset=utf-8
Server: Kestrel
Content-Length: 0
token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE5IiwiYXBpIjoiaHR0cHM6Ly9sb2NhbGhvc3Q6NTA1NiIsImJzYXBpIjoiaHR0cHM6Ly9zYW5kYm94LmJsdWVzbmFwLmNvbSIsImJzZnJhdWQxIjoiaHR0cHM6Ly9zYW5kYm94LmJsdWVzbmFwLmNvbS9zZXJ2bGV0L2xvZ28uaHRtIiwiYnNmcmF1ZDIiOiJodHRwczovL3d3dy5ibHVlc25hcC5jb20vc2VydmxldC9sb2dvLmdpZiIsIm5iZiI6MTY3OTk1Mzk4NiwiZXhwIjoxNjc5OTY4Mzg2LCJpYXQiOjE2Nzk5NTM5ODYsImlzcyI6IkFtZXJpY2FuIFBheWNvIExMQyIsImF1ZCI6IjcyQkZFNjhGMUU1RjVCQTY5MzYxMTMzQjU0NzlEOEY5NERFQ0JBMjUyRUVCMjIwNDIzRENBNkIzMjJFODY1NjFBNzg1RDhENjE1N0M2QjNGOUZFNDI2RkMyOTdDQjdCOTRFMDYzN0QyMDcwNUNEQzNGMzQ0OThBRDIzOTJBNEZEIn0.TKupqXQIxycu71MiUWxRO8FOG8J8BgroVvF9o1CgCY0
id: 0dd5b4f6-31e7-4251-aa39-d4a6f8bf0509
api-supported-versions: 1.0

Validación de pago móvil (P2C)

Permite consultar si un pago realizado a través de pago móvil existe.

Request

POST {URL}/api/v1/Transaccion/bancamiga.movpay

Headers

Authorization: Bearer {token}
userIp: {dirección IP del cliente}

Request Body (Schema)

Nombre del campo	Descripción	Tipo	Obligatorio
nombrePagador	Nombre del cliente	string	No
codigoBancoPagador	Código de 4 dígitos del banco	string	Sí
telefonoPagador	Número de teléfono desde donde se realizó el pago móvil	string	Sí
cedula	Cédula de identidad del cliente	string	No
numeroRerefencia	Código de autorización del pago móvil	string	Sí
monto	Monto de la operación	double	Sí
email	Correo electrónico del cliente	string	Sí
referencia	Valor opcional que permite identificar algo relacionado con el pago	string	No
trazaId	Identificador único de trazabilidad en la base de datos del comercio	string	No
Tipo	Constante que indica si el pago móvil es enviado o recibido. Posibles valores: R=RECIBIDO, P=ENVIADOS. Valor por defecto: R	string	Sí

Example Value

{
  "nombrePagador": "Pedro Perez",
  "codigoBancoPagador": "0105",
  "telefonoPagador": "584125555555",
  "cedula": "V 12345678",
  "numeroRerefencia": "30867220134",
  "monto": 1.0,
  "email": "email@example.com",
  "referencia": "",
  "trazaId": "",
  "tipo": "R"
}

Responses

Example Value

{
  "monto": 0,
  "montoUsd": 0,
  "infoProceso": {
    "estatusProcesamiento": "string",
    "codigoRespuestaCvv": "string"
  },
  "tarjetaHabiente": null,
  "infoUsuarioPagador": {
    "nombre": "string",
    "apellido": "string",
    "numeroIdentidad": "string",
    "numeroTelefono": "string",
    "email": "string"
  },
  "moneda": "string",
  "infoTarjeta": null,
  "transaccionId": 0,
  "transaccionMerchantId": 0,
  "descripcion": "string",
  "trazaId": "string",
  "exitoso": true,
  "canal": "string",
  "medioDePago": "string",
  "montoOriginal": null,
  "merchantId": "string",
  "fechaOperacion": "string",
  "cargosAdicionales": null
}

Códigos de error

Código	Mensaje
401	acceso no autorizado
400	el pago ya fue registrado
400	el número de teléfono no tiene el formato correcto
400	el código del banco es incorrecto
400	la moneda no está soportada
500	ocurrió un error inesperado

Example Value

{
  "mensaje": "string",
  "codigo": 0,
  "continua": true,
  "mensajeId": "string"
}