El cliente puede implementar Debito Directo mediante la integración de un snippet a su pagina web, el cual puede implementar donde estime conveniente.
El primer paso del proceso de pago consiste en obtener un session token, mediante una llamada desde su servidor (no desde el browser del cliente). Esto con el fin de obtener los datos necesarios para realizar las invocaciones a servicios posteriores
API_URL: [Entregada por ETpay]
ENDPOINT: /dd/start-session
Método: POST
Parámetros: se entregan como un JSON en el body del request, según lo descrito en la siguiente tabla:
Nombre parámetro | Tipo | Descripción | Ejemplo de valor enviado |
---|---|---|---|
merchant_code | Obligatorio | String con el código de merchant, entregado por ETpay | cl_demo_cl |
merchant_api_token | Obligatorio | String con la clave, entregada por ETpay | 4a005f0eca91cd9474cadce4e5fc6f91c64a608b48f7b4b31344f8b20e270072 |
validation_type | Obligatorio | String estatico, valida las credenciales mencionadas. | merchant_credentials |
Ejemplo de llamada:
{
"validation_type": "merchant_credentials",
"merchant_code": "cl_demo_cl",
"merchant_api_token": "4a005f0eca91cd9474cadce4e5fc6f91c64a608b48f7b4b31344f8b20e270079"
}
La API devolverá una respuesta como la siguiente, en formato JSON. El parámetro token es un token de sesión, a usarse en la siguiente llamada. El parámetro signature_token es un string que será usado para validar la llamada de confirmación del pago. Este token es único por cada sesión y se recomienda que sea almacenado junto a ella para su validación posterior.
{
"token": "nzOg6F[...]E0aARi",
"signature_token": "pPpd7[...]6sQhll",
"terms_url": "<https://www.etpay.com/terms-conditions>"
}
Los campos son los siguientes:
Nombre campo | Descripción | Ejemplo de valor recibido |
---|---|---|
token | String con el código de pago. Este campo se usa en todas las llamadas siguientes. | |
nzOg6F[...]E0aARi | ||
signature_token | String con un token de firma, que permitirá validar la autenticidad de la respuesta entregada por el browser del pagador como token JWT. |
Se recomienda que este campo sea almacenado hasta el final del proceso. | ab76d624[…]cfde7b3a | | terms_url | URL con el documento de términos y condiciones para el usuario. No es necesario procesar este parámetro. | https://s.etp.com/t_y_c.pdf |
Ya con el token se debe redireccionar al sitio entregado por etpay para seguir con el flujo y reemplazar la url por la entregada y el token por lo entregado por la api
https://[FRONT_URL]/session/<token>
Luego para poder agregar el snippet a tu web se deberá ingresar el siguiente código y reemplazar las variables