Notificación de la Operación: Webhook

  1. Notificación de la Operación: Webhook
    1. Correo electrónico
    2. Llamada a URL
  2. Anexo I – Tipos de operaciones

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

Para una correcta notificación del proceso de pago es posible configurar el sistema de notificaciones para que le 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
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
Idioma: es
ID de producto: 25
Firma:
Firma Extendida: 94f487ad8b57141d91fbc8fcda9e346cf17254bc
Pago Seguro: 0
Scoring: 0
Marca Tarjeta: VISA
Código BIC: BSABESBBXXX

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
TransactionType Numérico
TransactionName Alfanumérico Tipo 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
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
Language Alfanumérico Idioma en que se presentó la plataforma
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

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

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

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 Preautorización diferida
14 Cancelación de preautorización diferida
16 Confirmación de preautorización diferida
106 Retroceso
107 Alta de usuario Bankstore
108 Caducidad de Tarjeta