Notificación de la Operación: Webhook
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);
Importante
Para el tipo de operacion "ID 107 - Alta de usuario Bankstore" la firma extendida para comprobación de notificaciones (NotificationHash) se calculará de la siguiente manera:
NotificationHash = SHA512( MERCHANT_MERCHANTCODE + MERCHANT_TERMINAL + OPERATION + MERCHANT_ORDER + DateTime + md5(PASSWORD)) ;
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
Importante
La notificación puede ser enviada desde países distintos a España. Es necesario revisar las restricciones de IPs.
En algunos entornos como Magento, Prestashop, etc... pueden hacerse redirecciones en función a la IP de origen y deben ser desactivadas para las URL de notificaciones de cara a recibir la notificación correctamente.