E-Checkout

La solicitud se realizará a través del envío de una redirección web a la URL correspondiente como action de un formulario en el sitio web del Organismo. Previo a esa redirección, se requiere la generación de un Token que autoriza el inicio del pago.

El inicio de la solicitud a través de E-Checkout requiere que posea credenciales de firma para su Organismo.

En nuestro repositorio podrá encontrar un ejemplo de cómo obtener su token y hacer la petición para enviar al usuario a realizar el pago.

https://github.com/epagos/api_php/tree/master/post

El primer paso es obtener la autorización para iniciar el pago, para ello se deberá realizar un POST HTTP a la URL de obtención de token especificada con los datos que se muestran a continuación:

Respuesta de obtención de Token

Como respuesta, se valida la información y se devuelve en formato JSON:

Respuestas posibles de la obtención de token

En el SDK de ePagos encontrará un ejemplo de cómo obtener un token y su posterior uso en este enlace:

https://github.com/epagos/api_php/blob/master/post/redireccion/inicio.php

para el caso en que esté implementado mediante redirección a nuestra plataforma y en

https://github.com/epagos/api_php/blob/master/post/iframe/inicio.php

para el caso de que esté implementando dentro de un <iframe> el llamado a nuestra plataforma.

Una vez obtenido el token se hará el POST, mencionado al comienzo, con los siguientes datos, los campos marcados con un asterisco (*) son obligatorios:

Estructura detalle operación

El parámetro detalle_operacion, se debe enviar codificando el JSON de la estructura de detalles con urlencode() de PHP o una función similar. Otra posibilidad es codificar en Base64 el texto resultante del JSON.
Por favor, en el caso de usar esa última opción, notar de que el JSON debe ser un array de objetos con la estructura indicada.

En PHP, por ejemplo:

      
        $detalle_op = urlencode(json_encode([
          [
            'id_item'=>'0',
            'desc_item'=>'Cuota pura del impuesto provincial',
            'monto_item'=> 200,
            'cantidad_item'=>1
          ],
          [
            'id_item'=>'1',
            'desc_item'=>'Recargo pago fuera de término',
            'monto_item'=> 10,
            'cantidad_item'=>1
          ]
        ]));
      
    

o sino:

      
        $detalle_op = base64_encode(json_encode([
          […],
          …,
          […]
        ]));
      
    

Ejemplo de inicio de solicitud

      
        <form name='pago' method='post' action='<url_post>'>
          <input type='hidden' name='version' value='2.0' />
          <input type='hidden' name='operacion' value='op_pago' />
          <input type='hidden' name='id_organismo' value='<id_organismo>' />
          <input type='hidden' name='convenio' value='<nro_convenio>' />
          <input type='hidden' name='token' value='<token_generado' />
          <input type='hidden' name='numero_operacion' value='<nro_operacion>' />
          <input type='hidden' name='id_moneda_operacion' value='1' />
          <input type='hidden' name='monto_operacion' value='<monto>' />
          <input type='hidden' name='detalle_operacion' value='<detalle_encodeado>' />
          <input type='hidden' name='detalle_operacion_visible' value='1' />
          <input type='hidden' name='ok_url' value='<su_url_ok>' />
          <input type='hidden' name='error_url' value='<su_url_error>' />
          <br/><input type='submit' value='Enviar pago' />
        </form>
      
    

Se realizará el envío por POST, redirigiendo al usuario para que complete la información del pago.

A la vuelta recibirá la respuesta en su URL de OK o de Error de acuerdo con el resultado de la operación.

Una vez dentro del sitio de ePagos, se mostrará al usuario final los medios de pago habilitados (de no recibirse opciones de método de pago), de lo contrario se deberán mostrar todos los soportados y disponibles en ese momento teniendo en cuenta los medios de pago excluidos si se enviaron.

La pantalla será similar a lo que se muestra a continuación, con fondo predominantemente blanco y pudiéndose personalizar con el logo del Organismo.

En el caso de que se envíe un detalle de lo que se deberá abonar, se mostrará el listado de los elementos que lo componen sino se mostrará un totalizador con el importe a cobrar al usuario.

De acuerdo con el medio de pago seleccionado, se mostrarán diferentes opciones a visualizar debajo:

Tarjetas de crédito / débito

Una vez seleccionada la tarjeta de crédito / débito, el usuario seleccionará la cantidad de cuotas entre otros datos, con esa información se mostrará el monto total a pagar, el CFT y la TNA.

Para continuar el contribuyente deberá además ingresar:

• Cantidad de cuotas (solo tarjetas de crédito)
• Número de tarjeta
• Código de seguridad
• Fecha de vencimiento (año y mes)
• Nombre del titular (como aparece en la tarjeta)
• Tipo de documento
• Número de documento
• E-mail
• Fecha de nacimiento
• Número de puerta
• Datos del domicilio (solo si la operación es de alto riesgo)

La información devuelta en el caso del medio de pago de este tipo es:

Medios de pago en efectivo

El sistema genera el código de barras, un código de pago sin factura dependiendo el medio de pago seleccionado, y se realizará la publicación la deuda en la forma de pago elegida. El usuario tendrá la posibilidad de descargar una boleta con la información para realizar el pago.

Al hacer clic en Iniciar solicitud el usuario será redireccionado para ingresar el:

• E-mail

La información devuelta en el caso de un medio de pago de este tipo es:

Homebanking / Transferencias / DEBIN

Se publica la deuda correspondiente en la entidad seleccionada (solo Homebanking), y se redirige a la página de respuesta normalmente, indicando de que el pago quedó a la espera de su confirmación de acreditación. El usuario podrá descargar una boleta con las instrucciones para el pago.

Al hacer clic en Iniciar solicitud el usuario será redireccionado para ingresar el:

• CUIT / CUIL (de la cuenta bancaria del usuario que pagará)
• CBU/CVU o alias (solo si eligió como forma de pago DEBIN)
• E-mail

La información devuelta en el caso de un medio de pago de este tipo es:

Las respuestas siempre se realizarán mediante un POST HTTP a las URL indicadas como de OK o Error.

Respuesta satisfactoria

Se redirigirá a la URL que el Organismo defina y se incluirán la serie de datos de respuesta antes mencionados, que varían de acuerdo al tipo de forma de pago que el usuario seleccionó.

Respuesta Error

Se redirigirá a la URL que el Organismo defina y se incluirá una serie de datos de respuesta, a mencionar:

Respuestas Posibles