Solución de Problemas

Caribe
Colombia
México
Panamá

¿Tienes problemas con tu solución Connect?

No te preocupes aquí unas recomendaciones para tu desarrollo.

Primero que nada ¿en qué parte del desarrollo nos encontramos?

  • Me encuentro en desarrollo: etapa de pruebas o piloto productivo (aún no tengo mi carta de aceptación del equipo Fiserv: LoA)
  • Ya soy un comercio operando en producción

Me encuentro en desarrollo

¿Qué situación describe tu problema?

  • Nunca llegó a conectar con el formulario de Connect donde se introducen los datos de la tarjeta.
  • Conecto con el formulario,pero mi transacción es declinada.
  • Ya he realizado las validaciones de solución de Problemas, pero aún no resuelvo mi problema.

Nunca llegó a conectar con el formulario de Connect donde se introducen los datos de la tarjeta

Esto puede llegar a suceder gracias a diversos factores a continuación una lista de las causas más comunes:

  1. Ambiente y credenciales: en ocasiones puede suceder que estemos apuntando a la URL incorrecta para esto debemos de cerciorarnos de que atributo action apunte al ambiente correcto.
    • CI: https://test.ipg-online.com/connect/gateway/processing (Test)
    • LAN: https://www2.ipg-online.com/connect/gateway/processing (Producción México)
    • LAC: https://www5.ipg-online.com/connect/gateway/processing (Producción Centro América)

Y de igual forma de cerciorarnos de que cuando estemos en ambiente test usemos storeID y shared secret de test y viceversa en productivo, las credenciales de test y producción son distintas. Para obtener credenciales productivas revise el proceso de integración aquí (Guía de Integración Connect>Proceso de Integración).

  1. Formato de txndatetime: hay que verificar que el parámetro txndatetime esté en el formato correcto YYYY:MM:DD-hh:mm:ss se genere de forma dinámica y coincida con el parámetro timezone como lo específica la documentación (Guía de Integración Connect> Generación de Hash).
  2. Generación de hash incorrecto: por lo general siempre el hash en base 64 siempre termina en "=", no en "==", en este caso hay que validar que incluimos todos los parámetros en el orden correcto como se explica en la documentación(Guía de Integración Connect> Generación de Hash), para validar lo siguiente puedes verificar que dado el siguiente input se genere el mismo hash.
    String:
    666.00|combinedpage|484|HMACSHA256|https://myurl.com/fail|https://myurl.com/success|62666666|America/Mexico_City|2022:08:1617:27:59|sale
    CalculatedHash : 5ceabd1338e0eaf8a39bdcaf31e23ef1843f6832859bf34e0e00da4b488df7e1
    Base64Hash : XOq9Ezjg6vijm9yvMeI+8YQ/aDKFm/NODgDaS0iN9+E=
    También, te compartimos la siguiente opción para generar hash online ( https://www.devglan.com/online-tools/hmac-sha256-online ):
  3. El formulario enviado no coincide con el hash: para revisar esto podemos verificar como estamos enviando nuestros parámetros usando las herramientas para desarrolladores en nuestro navegador:
    • Dentro del navegador oprimimos Ctrl+ Shift + I previo a enviar nuestro formulario html para abrir las herramientas y nos posicionamos en la pestaña de Network, filtramos por Doc.
    • Enviamos nuestro formulario html y dentro de processing en el payload verificamos que los nombres de los parámetros y valores coincidan con los utilizados en la creación de nuestro hash, NO debemos enviar parámetros extra o menos de los que se hayan utilizado para realizar el cálculo del hash.

Conecto con el formulario, pero mi transacción es declinada.

Si nos enfrentamos a esta situación, revisemos que estamos obteniendo a la respuesta, podemos consultar la siguiente documentación (Manejo de Respuestas).

Adicional a ello aquí las explicaciones a los tipos de rechazos más comunes:

En ambiente de pruebas

En ambiente de pruebas los rechazos más comunes se deben a que usemos números de tarjeta inválidos Recordemos que solo podremos procesar transacciones con tarjetas de prueba. En ocasiones estas pueden presentar intermitencias debido a que son utilizadas por múltiples comercios y es necesario darles mantenimiento. Si alguna no funciona recomendamos probar con otra diferente.

Tarjetas de pruebaComercioTipo de Venta
5426064000424979Germany/MCVenta directa
4035874000424977Germany/VisaVenta directa
4931580001642617MEX/VISALocal venta directa y MSI
5579220000000012MEX/MCLocal venta directa y MSI

En piloto productivo

Cuando nos encontramos en esta etapa, es importante recordar que no podremos utilizar tarjetas de prueba.

Casos con el código N:51:05-DECLINED son rechazos del emisor (banco), pueden deberse a que nuestra tarjeta no esté habilitada para transacciones por e-commerce. Últimamente hemos visto la siguiente tendencia, los bancos tienden únicamente a aceptar transacciones de ecommerce a través de sus tarjetas digitales reservando las físicas únicamente para transacciones en puntos de venta físicos. En todo caso debe consultarse con el banco.

Casos con el código N:91:91-PLEASE RETRY hacen referencia a que el sistema del banco no está disponible por el momento.

Casos con el código N:5101 hacen referencia a que el tarjetahabiente no realizó de manera correcta el proceso de autenticación. Este varía según el emisor puede ser haber introducido de manera errónea el código sms, haber fallado en hacer la autenticación en la app bancaria, etc.

Casos con el código N:5003 hacen referencia a que ya se había mandado un formulario con ese "oid" al gateway, pude suceder debido a un error en la integración o a que el tarjetahabiente interactúe con el comercio de manera errónea (abriendo múltiples pestañas, navegando hacia atrás) generando dos veces el mismo "oid", en ambos casos recomendamos revisar la integración.

Ya he realizado las validaciones de Troubleshooting, pero aún no resuelvo mi problema.

En este caso, si aún no eres un comercio operando libremente en producción, te pedimos de favor enviar un correo a [email protected] explicando tu situación, te recomendamos incluir la siguiente información para que puedan identificar a tu comercio de manera más eficiente:

  • MID: es tu número de comercio Fiserv
  • StoreID/storename: es tu número de tienda típicamente inicia con 62
    En caso de tratarse de revisión de una transacción en específico, te recomendamos primero revisar la transacción en tu VT si es que ya te encuentras en un piloto productivo ( https://www2.ipg-online.com/vt/login ) y, si aún buscas asesoramiento, no olvides incluir en tu correo los siguientes datos:
  • oid: es uno de los parámetros que obtienes de respuesta como parámetro POST en tu responseFailURL o responseSuccessURL fecha de transacción.

Ya soy un comercio operando en producción

En este caso te pedimos de favor enviar un correo a [email protected] explicando tu situación. Te recomendamos incluir la siguiente información para que puedan identificar a tu comercio de manera más eficiente:

  • MID: es tu número de comercio Fiserv
  • StoreID/storename: es tu número de tienda típicamente inicia con 62
    En caso de tratarse de revisión de una transacción en específico, te recomendamos primero revisar la transacción en tu VT ( https://www2.ipgonline.com/vt/login ) y, si aún buscas asesoramiento, no olvides incluir en tu correo los siguientes datos:
  • oid: es uno de los parámetros que obtienes de respuesta como parámetro POST en tu responseFailURL ó responseSuccessURL fecha de transacción.