ETPay

Introducción

Este documento proporciona las especificaciones para el pago con ETpay.

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.

Bancos

Nombre	Código
Banco Estado	cl_estado
Banco Santander	cl_santander
Banco de Chile/Edwards	cl_bch
BCI	cl_bci
Banco Itaú	cl_itau
Banco Scotiabank	cl_scotiabank
Banco Falabella	cl_falabella

Crear sesión

Permite crear una sesión en ETpay, y registrar la transacción en el sistema de Luka. El método devolverá la url del botón de pago de ETpay.

Solicitud

GET {URL}/api/v1/transaccion/etpay.crear.sesion

Cabeceras

Content-Type: application/json
Authorization: Bearer {token}
userIp: {dirección IP del cliente}

Cuerpo de la solicitud

Nombre del campo	Descripción	Tipo	Obligatorio
Monto	Monto de la operación	Number	Sí
Moneda	Código de la moneda de la operación	String	Sí
Email	Dirección de correo electrónico del cliente que realiza el pago	String	Sí
CodBancoPreseleccionado	Código del banco	String	Sí
NombrePagador	Nombre del cliente	String	Sí
UserRutPagador	Identificador Personal RUT del usuario	String	Sí
BloquearRut	Utilizar true o false para bloquear el RUT del pagador y no permitir modificarlo durante el pago	Boolean	Sí
Referencia	Identificación del cliente final en caso de que se requiera	String	No
TrazaId	Identificador único de trazabilidad en la base de datos del comercio	String	Sí
CanalId	Canal por donde realiza la operación. Posibles valores: - Pasarela - API (default) - Link de Pago - Android - iOS	Number	No
CargosAdicionales	Objeto con la información de cargos adicionales	Object	No
MontoOriginal	Objeto con información del monto original. Se utiliza cuando se debe aplicar una conversión de moneda	Object	No

Respuesta

Nombre	Descripción	Tipo
token	Token único para autenticar la sesión de pago.	String
signature_token	Token de firma para verificar la integridad de la solicitud.	String
terms_url	URL de los términos y condiciones del servicio.	String
urlSession	URL de la sesión de pago.	String
transaccionId	Referencia de la transacción en Lukapay	String

Ejemplo de uso

Cuerpo de la solicitud

{
    "TrazaId": "6830bc36-ca0a-4c85-ad25-27dfab727d4b",
    "Monto": 200,
    "Moneda": "CLP",
    "CanalId": 2,
    "Email": "demo@lukapay.io",
    "NombrePagador": "Pedro Perez",
    "Link": null,
    "MontoOriginal": null,
    "CargosAdicionales": null,
    "Referencia": null,
    "CodigoBancoPreSeleccionado": "cl_test"
}

Cuerpo de la respuesta

{
    "token": "PdcLTfQqNDat8NqvdFj9i4bcMbxAawDRsBHIDVGZ2ZZjhmEhinitl8Gtpxz14Hwv",
    "signature_token": "pnt2u09ju8tIFzkk93C3tlzVp6Lfw3eN0kxzcsEkjSjQWm3hhI6cRHJCLaw3GPJ7",
    "terms_url": "https://www.etpay.com/terminos-condiciones",
    "urlSession": "https://pmt-sandbox.etpay.com/session/PdcLTfQqNDat8NqvdFj9i4bcMbxAawDRsBHIDVGZ2ZZjhmEhinitl8Gtpxz14Hwv",
    "transaccionId": "104094"
}

Consultar

Permite consultar la transacción una vez realizada el pago a través del botón de Etpay.

Solicitud

POST {URL}/api/v1/transaccion/etpay.consultar

Cabeceras

Content-Type: application/json
Authorization: Bearer {token}
userIp: {dirección IP del cliente}

Cuerpo de la solicitud

Nombre del campo	Descripción	Tipo	Obligatorio
TransaccionId	Referencia de la transacción en Lukapay	String	Sí
TokenSession	Token de respuesta del método de etpay.crear.sesion	String	Sí

Respuesta

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

Ejemplo de uso

Cuerpo de la solicitud

{
  "TransaccionId": "104094",
  "TokenSession": "PdcLTfQqNDat8NqvdFj9i4bcMbxAawDRsBHIDVGZ2ZZjhmEhinitl8Gtpxz14Hwv"
}

Cuerpo de la respuesta

{
    "Monto": 200,
    "MontoUsd": 0.21,
    "InfoProceso": {
        "EstatusProcesamiento": "success",
        "CodigoRespuestaCvv": null
    },
    "TarjetaHabiente": null,
    "InfoUsuarioPagador": {
        "Nombre": "Pedro",
        "Apellido": "Pérez",
        "NumeroIdentidad": "111111111",
        "NumeroTelefono": null,
        "Email": "demo@lukapay.io"
    },
    "Moneda": "CLP",
    "InfoTarjeta": null,
    "TransaccionId": 104094,
    "TransaccionMerchantId": 104094,
    "Descripcion": "success",
    "TrazaId": "6830bc36-ca0a-4c85-ad25-27dfab727d4b",
    "Exitoso": true,
    "Canal": "Api",
    "MedioDePago": "Transferencia",
    "MontoOriginal": null,
    "MerchantId": "GaUigw1MqmJqtpiwXsUBEDmyc8BcxE7RGytuMGUbWqVGSXjKMAtAwEnP9uZ53ux9",
    "FechaOperacion": "2024-09-20 10:48:08.000000+00:00",
    "CargosAdicionales": null,
    "Cuotas": null
}