Link de Pago

Introducción

Este contiene las especificaciones para implementar el Link de Pago de Luka. Para poder utilizar el API, el comercio debe contar con las credenciales asociadas a la configuración del comercio, tanto para calidad como para producción, en relación a: monedas que acepta, medios de pago e interfaz gráfica. Estas credenciales se entregarán una vez iniciado el proceso de delivery.

La URL está especificada en Ambientes.

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. Ver documentación.

Creación de Link de pago

La creación del Link de Pago se realiza desde la API con las siguientes especificaciones:

Request

POST {URL}/api/v1/link/token

Headers

Content-Type: application/json
Authorization: Bearer {token}

Body

Campo	Descripción	Tipo	Obligatorio
Nombre	Identificación del cliente final en caso de que se requiera, por ejemplo: tarjeta de acceso, número de asegurado, etc. Campo opcional.	String	No
Monto	Monto del pago. Debe estar en formato decimal.	Number	Sí
MonedaCodigo	Código de la moneda en la que se realizará el pago. Ver tabla de monedas.	String	No
MetodosPago	Arreglo con las claves que identifican el método de pago que se utilizará en la transacción. Ver tabla métodos de pagos en la sección 1.	Array	No
IdTraza	ID de la transacción en el sistema interno del comercio. Se utiliza para tener una trazabilidad completa de la operación. Campo opcional.	String	Sí
Email	Dirección de correo electrónico asociada con el pago. Ej. ejemplo@mail.com	String	No

Response

Header

Se recibirá un código 201 y encontrará la URL del link de pago en el header Location de la respuesta.

Ejemplos de uso

Request body

{ 
    "MonedaCodigo": "USD", 
    "Monto": 12.20, 
    "MetodosPago": ["zelle"], 
    "Referencia": "", 
    "IdTraza": "", 
    "Email": "ejemplo@mail.com" 
}

Response header

HTTP/1.1 201 Created
Server: nginx/1.16.1 
Date: Tue, 09 Aug 2022 20:09:13 GMT 
Content-Type: text/plain; charset=utf-8 
Content-Length: 0 
Connection: keep-alive 
Location: https://qa.lukapay.me/payco/b262a06e-f073-465c-89e5-5a54934bb4af
id-link: b262a06e-f073-465c-89e5-5a54934bb4af 
nro-orden: 3372 
api-supported-versions: 1.0

URL de Retorno

El sistema está en la capacidad de redirigir la página una vez finalizado el proceso de pago en el Link de Luka. En este caso, el comercio debe indicar una URL que será configurada en la aplicación para tal fin.

En caso de que se tenga configurada una URL de retorno, se enviará a través de la URL un objeto codificado en base64 con la respuesta exitosa o fallida.

Estructura de la respuesta exitosa

Nombre	Descripción	Tipo
Canal	Indica el canal que se está utilizando para aplicar el pago en Lukapay	Number
CargosAdicionales	Objeto que contiene cargos adicionales.	Object
Cuotas	Objeto que contiene información sobre cuotas.	Object
Descripción	Contiene la respuesta de la aplicación del pago, como estatus de la transacción y cualquier información adicional	String
Exitoso	Indica si la transacción fue exitosa o no. Se utiliza para validar la respuesta	Boolean
FechaOperacion	Fecha que ocurrió la transacción	String
InfoProceso	Objeto que contiene información más detallada del estatus de la transacción	Object
InfoTarjeta	Objeto que contiene información de la tarjeta de crédito utilizada para realizar el pago. Solo aplica para pagos con tarjeta	Object
InfoUsuarioPagador	Objeto que devuelve información básica del usuario que realiza el pago	Object
MedioDePago	Indica el método de pago que se utilizó	String
MerchantId	Referencia de la transacción del merchant utilizado para aplicar el pago	String
Moneda	Código de la moneda utilizada para realizar el pago	String
Monto	Indica el monto del pago realizado	Number
MontoOriginal	Objeto con información del monto original. Se utiliza cuando se debe aplicar una conversión de moneda	Object
MontoUsd	Valor del monto en dólar estadounidense. Se utiliza cuando se especifica el MontoOriginal	Number
TarjetaHabiente	Objeto que contiene información del pagador (en caso de haber sido especificado)	Object
TransaccionId	Referencia de la transacción en Lukapay	Number
TransaccionMerchantId	Referencia de la transacción del merchant utilizado para aplicar el pago	Number
TrazaId	Identificador interno del comercio. En caso de que el comercio no lo proporcione se genera un código aleatorio.	String

Los atributos de los objetos están especificados en Respuesta de transacción.

Estructura de la respuesta de error

Nombre	Descripción
Código	Contiene el código numérico del estado HTTP de la respuesta
Mensaje	Contiene el texto con el mensaje de error de la respuesta

Webhook Transacción exitosa

En caso que sea necesario recibir una respuesta de la transacción exitosa vía webservice, el comercio debe proporcionar el URL del endpoint que se utilizará como webhook donde se enviará el resultado del pago.

Estructura de la Webhook Transacción

Nombre	Descripción
NumeroConfirmacion	ID de la transacción en la plataforma de Luka
FechaUtc	Fecha de la transacción en formato UTC
CanalPago	Canal por donde se realizó el pago
IdProducto	Identificador de la ventana de pago
InfoPago	Objeto que contiene el detalle del medio de pago utilizado. Ver Tabla Métodos de Pagos en la sección 1
InfoPagador	Objeto que contiene la información de la persona que realiza el pago. Ver 4.2.2
Monto	Monto de la transacción
Moneda	Código ISO de la moneda con la que se realizó el pago
ReferenciaServicio	Es la identificación del cliente final que se envió al iniciar el pago
IdTraza	Es el ID de la transacción en el sistema interno del comercio que se envió al iniciar el pago. En caso de que el comercio no lo proporcione se genera un código aleatorio

Estructura del objeto InfoPago

Nombre	Descripción
MedioPago	Indica el tipo de pago utilizado por el pagador. Ejm: Tarjeta de crédito, Paypal, Zelle, etc.
ReferenciaDePago	Código de autorización devuelto por el merchant
NumeroTarjeta	Número de tarjeta de crédito/débito enmascarado
TipoTarjeta	Tipo de tarjeta de crédito/débito

Estructura del objeto InfoPagador

Nombre	Descripción
Nombre	Nombre del usuario que realiza el pago
Email	Correo electrónico del usuario que realiza el pago