ETPay

Introduction

This document provides the specifications for payment with ETpay.

The URL is specified in Environments.

Authentication is done via a token (JWT) returned by the login method using the credentials provided by Lukapay. See documentation.

Banks

Name	Code
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

Create session

Allows the creation of a session in ETpay and registers the transaction in the Luka system. The method will return the URL for the ETpay payment button.

Request

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

Headers

Content-Type: application/json
Authorization: Bearer {token}
userIp: {client's IP address}

Request body

Field Name	Description	Type	Required
Monto	Operation amount	Number	Yes
Moneda	Operation currency code	String	Yes
Email	Customer's email address for the payment	String	Yes
CodBancoPreseleccionado	Bank code	String	Yes
NombrePagador	Customer's name	String	Yes
UserRutPagador	Personal Identifier (RUT) of the payer	String	Yes
BloquearRut	Use true or false to lock the payer's RUT and prevent modification during payment	Boolean	Yes
Referencia	Final customer identification, if required	String	No
TrazaId	Unique traceability identifier in the merchant's database	String	Yes
CanalId	Channel through which the operation is performed. Possible values: - Pasarela - API (default) - Payment Link - Android - iOS	Number	No
CargosAdicionales	Object with information on additional charges	Object	No
MontoOriginal	Object with original amount information. Used when currency conversion is required	Object	No

Response

Field Name	Description	Type
token	Unique token to authenticate the payment session.	String
signature_token	Signature token to verify request integrity.	String
terms_url	URL for the terms and conditions of service.	String
urlSession	Payment session URL.	String
transaccionId	Transaction reference in Lukapay	String

Example usage

Request body

{
    "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"
}

Response body

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

Query

Allows you to query the transaction once the payment has been made through the Etpay button.

Request

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

Headers

Content-Type: application/json
Authorization: Bearer {token}
userIp: {client's IP address}

Request body

Field Name	Description	Type	Required
TransaccionId	Transaction reference in Lukapay	String	Yes
TokenSession	Response token from the etpay.crear.sesion method	String	Yes

Response

Field Name	Description	Type
Canal	Channel used to process the payment	Number
CargosAdicionales	Additional charges details	Object
Cuotas	Information about payment installments	Object
Descripción	Response providing the transaction status and any additional information	String
Exitoso	Indicates if the transaction was successful	Boolean
FechaOperacion	Date and time of the transaction	String
InfoProceso	Detailed information about the transaction status	Object
InfoTarjeta	Credit card details used for payment (if applicable)	Object
InfoUsuarioPagador	Information about the customer making the payment	Object
MedioDePago	Payment method used	String
MerchantId	Merchant's transaction identifier	String
Moneda	Currency used for the payment	String
Monto	Amount paid	Number
MontoOriginal	Information about the original amount (if currency conversion applies)	Object
MontoUsd	Value of the amount in U.S. dollars	Number
TarjetaHabiente	Payer's details if a card is used	Object
TransaccionId	Transaction identifier in Lukapay	Number
TransaccionMerchantId	Transaction identifier from the merchant	Number
TrazaId	Unique identifier for the transaction in the merchant's database	String

For more details on the response objects, see Transaction Response.

Example usage

Request body

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

Response body

{
    "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
}