Webhook

ePagos cuenta con la posibilidad de configurar la URL que el Organismo defina, para poder enviarle los avisos de acreditaciones de pago y devoluciones. Optimizando de esta forma la operatoria y eliminando la necesidad de consultar vía API por el estado de cada pago para obtener su información de acreditación o devolución

Puede configurar la misma URL para recibir los dos tipos de webhook o si no puede configurar una URL para los pagos y una para las devoluciones.

Esta URL debe configurarse y puede probarse desde la sección Desarrolladores del panel de control.

La URL que se configure recibirá vía POST de HTTP la siguiente información:

Campo Tipo Descripción
id_resp Numérico entero El código de respuesta de E-Checkout (02001 si es un pago, sino no se envía)
id_transaccion Numérico entero El número de operación en ePagos
id_fp Numérico entero Identificador de la forma de pago que el usuario eligió
fp JSON Contiene los datos adicionales del pago, es un texto con un JSON:
  • nombre_fp El nombre de la forma de pago
  • id_fp Identificador de la forma de pago que el usuario eligió
  • tarjeta_fp El número de tarjeta Hasheado en los casos de pago con tarjeta
  • importe_fp El importe abonado por el usuario
  • tipo_doc_fp (**) El tipo de documento del pagador (CUIT o DNI)
  • numero_doc_fp (**) El número de documento del pagador

(**) No disponible en todos los medios de pago

Algunos de estos datos se encuentran también fuera de la estructura, pero se agregan aquí para unificar la respuesta de los medios de pago.

id_organismo Numérico entero Identificador del organismo al que pertenece
convenio Numérico entero El número de convenio de la transacción
numero_operacion Texto El número o código de transacción que el cliente informó al momento de iniciar la solicitud del pago
identificador_2 Texto (100) Identificador adicional 2
identificador_3 Texto (512) Identificador adicional 3
codigo_barras Texto El código de barras asociado a la operación
fecha_pago / fecha_devolucion Fecha (AAAA-MM-DD) La fecha en que se realizó el pago (acreditación en el medio de pago) / La fecha en que se realizó la devolución (reintegro) del pago al usuario
monto_pagado Númerico decimal El importe abonado por el usuario
tipo Texto (1) Una letra que indica el tipo de envio: P = Pago, D = Devolución

Debido a la naturaleza de este tipo de notificaciones, puede darse que algún envío no lo reciba o que el mismo sea enviado y no pueda procesarse de su lado. Por lo que recomendamos de que además de implementar el Webhook, exista un proceso que regularmente (una vez por día es ideal), obtenga los pagos acreditados en el periodo.