Notificación de la Operación: Webhook

  1. Notificación de la Operación: Webhook
    1. Correo electrónico
    2. Llamada a URL
    3. Consulta de la operación
  2. Anexo I – Tipos de operaciones
  3. Anexo II – IPs de notificación

Notificación de la Operación: Webhook

El proceso de compra es llevado a cabo por la pasarela de pagos y la resolución de la operación es devuelta directamente en el mensaje de respuesta. No obstante es posible configurar a través del panel de cliente de PAYCOMET métodos de notificación adicionales para mantener el conocimiento de la operación a usuarios o lanzar mecanismos adicionales.

Estas notificaciones son idénticas a las enviadas por otro tipo de productos de pasarela de pagos, tales como pasarela WEB o Venta Telefónica. De esta manera es posible para el cliente mantener un control unificado de las ventas realizadas por el comercio

Puedes modificar el modo en que quieres que te llegen las notificaciones en el panel de clientes, desde: Terminales->"Nombre de terminal"->Notificaciones. Si utilizas un módulo de pago, por favor, sigue las intrucciones al respecto que aparecen en el tutorial del mismo).

Para una correcta notificación del proceso de pago es posible configurar el sistema de notificaciones para que te informe del estado de la operación llevada a cabo por la pasarela, bien por correo electrónico, llamada a una URL en segundo plano (independiente del proceso de respuesta al servicio) o ambas y de forma global mediante SMS.

Correo electrónico

La información contenida en un correo de notificación tipo es la siguiente:


Se ha producido una venta según los siguientes parámetros:
Identificador de cuenta: 0gs265nc
Tipo de transacción: Autorización (1)
País de expedición de la tarjeta: ES
Fecha y hora de la transacción (yyyymmddhhmmss): 20101027110536
En la sección (Terminales->"Nombre de terminal"->IVR ) se encuentra las opciones de configuración:
Orden: 2010102711053676
Respuesta: OK
ID de error: 0
Descripción del error:
Código de autenticación: 802335/120098123810102711053606007000
Moneda: EUR
Cantidad (euros): 10.00
Cantidad (origen): 1000
ID de producto: 25
Firma:
Firma Extendida: 94f487ad8b57141d91fbc8fcda9e346cf17254bc
Pago Seguro: 0
Scoring: 0
Marca Tarjeta: VISA
Código BIC: BSABESBBXXX
Número de serie: 00000200275
PAYCOMET ID: 122548685
XPAY ORIGIN: Apple Pay
DccCurrency: USD
DccCurrencyName: United States dollar
DccAmount: 7010
DccMarkup: 0.03
DccExchangeRate: 0.855931
Dcc Porcentaje sobre cambio BCE: -0.36

Llamada a URL

A la URL de destino se le pasan los parámetros de la notificación con el método POST según la siguiente tabla:

Variable Tipo Descripción
MethodId Numérico Identificador de método en PAYCOMET. Ver listado.
MethodName Alfanumérico Nombre de método en PAYCOMET
TransactionType Numérico Tipo de operación
TransactionName Alfanumérico Nombre de operación
CardCountry Alfanumérico País de emisión de la tarjeta. Puede ser un valor vacío
BankDateTime Alfanumérico Fecha de la operación
ClearanceDateTime Alfanumérico Fecha de confirmación de la operación
Order Alfanumérico Referencia pasada por el comercio
Response Alfanumérico Estado final de la operación
ErrorID Numérico Código de error. Ver apéndice
ErrorDescription Alfanumérico Descripción textual del error (opcional)
AuthCode Alfanumérico Código de autorización devuelto por el banco (opcional)
Currency Alfanumérico Moneda en la que realizó la operación
Amount Numérico Importe pasado por el comercio
AmountEur Numérico Importe en euros
AccountCode Alfanumérico Código de cliente
TpvID Numérico Número de terminal
Concept Alfanumérico Concepto de la operación
IdUser Numérico No aparece en todas las notificaciones. Valor necesario para tokenizaciones
TokenUser Alfanumérico No aparece en todas las notificaciones. Valor necesario para tokenizaciones
SecurePayment Numérico Tomará valor 1 si la operación se procesó en modo seguro. Valor 0 cuando la operación se procesó en modo no seguro.
CardBrand Alfanumérico Marca de la tarjeta, si se pudo determinar.
BicCode Alfanumérico Código de la entidad bancaria por la que se realizó la operación, si se pudo determinar.
Scoring Numérico Scoring calculado en la operación.
NotificationHash Alfanumérico Firma extendida de la notificación.
CardType Alfanumérico Tipo de tarjeta (Crédito, débito, cargo)
cardCategory Alfanumérico Categoría de tarjeta. Si se puede identificar, se enviará información sobre la categoría de la tarjeta. De lo contrario, el campo se devolverá en blanco.
sepaCard Numérico Tarjeta perteneciente a país SEPA.
serialNumber Alfanumérico Número de serie del TPV físico.
paycometId Numérico Identificador único de la transacción.
xpayOrigin Alfanumérico Tipo de XPAY (Apple Pay, Google Pay, Click to Pay).
DCC_Currency Alfanumérico Código ISO de moneda de conversión.
DCC_CurrencyName Alfanumérico Nombre del tipo de moneda de conversión.
DCC_Amount Numérico Cantidad a convertir.
DCC_Markup Numérico Margen de beneficio/perdida al realizar conversión.
DCC_ExchangeRate Numérico Tasa de cambio a aplicar.
DCC_EcbPercentage Numérico Porcentaje sobre cambio BCE.

La firma extendida para comprobación de notificaciones (NotificationHash) se calculará de la siguiente manera:

NotificationHash = SHA512(AccountCode+TpvID+TransactionType+Order+Amount+Currency+md5(password)+BankDateTime+Response);

Consulta de la operación

La notificación tambien puede ser consultada a través de la llámada al servicio search_operations, puede encontrar más información en la sección de consulta de operaciones.

Anexo I – Tipos de operaciones

Los tipos de operaciones que se notificarán, se detallan en la siguiente tabla:

ID Operación
1 Autorización
2 Devolución
3 Preautorización
4 Cancelación de preautorización
6 Confirmación de preautorización
9 Suscripción
13 validación de tarjeta
14 Cancelación de validación de tarjeta
16 Confirmación de validación de tarjeta
30 Denegación de Transferencia SEPA
106 Retroceso
107 Alta de usuario Bankstore
114 Cobro a un usuario por referencia
116 Denegación de retirada

Anexo II – IPs de notificación

La notificación de la operación se envía a través de las siguientes direcciones IPs

  • 99.81.26.182
  • 99.80.172.90
  • 99.81.94.3