Solución de problemas y preguntas frecuentes

En esta sección, encontrará sugerencias y soluciones a problemas que pueden ocurrir con su integración.

¿Por cuánto tiempo será válida una autorización en la cuenta de un pagador?

Esto depende de la institución financiera que emitió la tarjeta al pagador. Cada emisor de tarjeta define el período de vencimiento de la autorización en el cual retienen los fondos en la cuenta del pagador, mientras esperan la llegada de la transacción de captura. Por lo general, son 5 a 8 días de procesamiento, antes de que la autorización se purgue desde la cuenta del pagador y se libere el acceso a los fondos de vuelta al pagador.

¿Cómo se combinan los detalles de tarjeta de varias fuentes (tokens, sesiones de pago) en solicitudes?
¿Cómo analizo errores de validación si deseo mostrar mensajes agradables a mis pagadores?

Puede usar los siguientes campos para detectar errores de validación:


El campo error.explanation [REST][NVP] contendrá algo de texto de error legible por humanos que dará más información sobre el error, como longitud mínima o esperada, etc. No analice esta información, ya que el formato para este texto no se puede garantizar.

¿Cómo se asignan los códigos de respuesta del Cliente de pago y el Cliente de pago virtual a la API?

Las integraciones con los códigos de respuesta del Cliente de pago y el Cliente virtual de pago devuelven códigos de respuesta diferentes de las enumeraciones devueltas para API. En las siguientes tablas se muestra la asignación entre los dos tipos de respuestas devueltos por Mastercard Payment Gateway.

Códigos de respuesta de transacción
Cliente de pago/Cliente de pago virtual API
Código de respuesta Descripción response.gatewayCode Descripción
0 Transacción correcta APPROVED Transacción aprobada
1 La transacción no se pudo procesar UNSPECIFIED_FAILURE La transacción no se pudo procesar
2 Transacción rechazada: contactar banco emisor DECLINED La operación solicitada no se realizó correctamente. Por ejemplo, el emisor rechazó un pago o la autenticación del pagador no se pudo llevar a cabo con éxito.
3 Transacción rechazada: sin respuesta del banco TIMED_OUT Se agotó el tiempo de respuesta
4 Transacción rechazada: tarjeta caducada EXPIRED_CARD Transacción rechazada debido a una tarjeta caducada
5 Transacción rechazada: crédito insuficiente INSUFFICIENT_FUNDS Transacción rechazada debido a fondos insuficientes
6 Transacción rechazada: error en sistema bancario ACQUIRER_SYSTEM_ERROR Se produjo un error en el sistema del adquirente al procesar la transacción
7 Error de procesamiento en el servidor de pago. Causado generalmente por datos de entrada no válidos, como por ejemplo el número de la tarjeta de crédito. También se pueden producir errores de procesamiento. SYSTEM_ERROR Un error interno en el sistema que se produjo al procesar la transacción
8 Transacción rechazada: no se reconoce tipo de transacción NOT_SUPPORTED No se reconoce el tipo de transacción
9 Transacción rechazada por el banco (No contactar banco) DECLINED_DO_NOT_CONTACT Transacción rechazada: no se ponga en contacto con el emisor
A Transacción abortada ABORTED Transacción abortada por el titular de la tarjeta
B Transacción bloqueada - se devuelve cuando:
-el Nivel de seguridad de verificación tiene un valor de '07',
-el negocio tiene habilitado el bloqueo 3D-Secure,
-el resultado de la evaluación global del riesgo devuelve 'Rechazo' o 'Rechazo sistema'
BLOCKED Transacción bloqueada debido a reglas de bloqueo de Riesgo o 3D Secure
C Transacción cancelada CANCELLED Transacción cancelada por el titular de la tarjeta
D Transacción diferida DEFERRED_TRANSACTION_RECEIVED Se recibió transacción diferida y en espera de su procesamiento
E Transacción rechazada: consultar emisor de tarjeta REFERRED Transacción rechazada: consultar al emisor de la tarjeta
F Error en la autenticación 3D Secure AUTHENTICATION_FAILED Error en la autenticación 3D Secure
I Error en el código de seguridad de tarjeta INVALID_CSC Código de seguridad de tarjeta no válido
L Transacción de compra bloqueada. Esto indica que se está generando otra transacción con el mismo número de transacción de compra. LOCK_FAILURE Pedido bloqueado: se está procesando otra transacción para este pedido
M Transacción enviada (la transacción se ha dirigido al adquirente, pero el Servidor de pago no la ha recibido aún para finalizar la transacción) SUBMITTED Transacción enviada: aún no se ha recibido la respuesta
N Titular de tarjeta no inscrito en 3DSecure (solo autenticación) NOT_ENROLLED_3D_SECURE El titular de la tarjeta no está inscrito en 3D Secure
P Transacción pendiente PENDING Transacción pendiente
R Límites de reintentos sobrepasados, transacción no se procesó EXCEEDED_RETRY_LIMIT Se sobrepasaron los límites de reintentos para la transacción
S Transacción rechazada: lote duplicado DUPLICATE_BATCH Transacción rechazada debido a un lote duplicado
T Error en la verificación de dirección DECLINED_AVS La transacción se rechazó debido a la verificación de la dirección
U Error en el código de seguridad de tarjeta DECLINED_CSC Transacción rechazada debido a un código de seguridad de tarjeta caducado
V Error en la verificación de dirección y el código de seguridad de tarjeta DECLINED_AVS_CSC Transacción rechazada debido a la verificación de dirección y el código de seguridad de tarjeta
W Transacción rechazada: no se reconoce plan de pago. DECLINED_PAYMENT_PLAN Transacción rechazada debido al plan de pago
X Aprobada con liquidación pendiente: Aprobado por un sistema de liquidación por lotes, pero a la espera de más detalles del adquirente. APPROVED_PENDING_SETTLEMENT Transacción aprobada: liquidación por lotes pendiente
? Respuesta desconocida UNKNOWN Respuesta desconocida
Códigos de respuesta del Servicio de verificación de dirección (Address Verification Service, AVS)
Cliente de pago/Cliente de pago virtual API
Código de respuesta Descripción response.cardholderVerification.avs.gatewayCode Descripción
X Concordancia exacta: dirección y código postal de nueve dígitos ADDRESS_ZIP_MATCH La dirección postal y el código postal coincidieron
Y Concordancia exacta: dirección y código postal de cinco dígitos
D La dirección postal y el código postal coinciden para la transacción internacional.
M La dirección postal y el código postal coinciden para la transacción internacional.
F La dirección postal y el código postal coinciden. Válido solo para el Reino Unido.
W Código postal de nueve dígitos coincidió, dirección no coincidió ZIP_MATCH Código postal coincidió. Dirección postal no coincidió
P Los códigos postales coinciden para las transacciones internacionales, pero la dirección postal no se verificó debido a formatos incompatibles.
Z Código postal de cinco dígitos coincidió, dirección no coincidió
A Solo coincide la dirección ADDRESS_MATCH Coincidieron las direcciones postales
B La dirección postal coincide para la transacción internacional. El código postal no se verificó debido a formatos incompatibles.
S Servicio actualmente no admitido. SERVICE_NOT_SUPPORTED El servicio actualmente no está disponible para el adquirente o el negocio
G Transacción internacional, información sobre la dirección no disponible. NOT_VERIFIED No se pudo verificar el AVS para una transacción internacional
C La dirección postal y el código postal no se verificaron para una transacción internacional, debido a formatos incompatibles.
I Solo Visa. La información sobre la dirección no se verificó para la transacción internacional.
R El sistema del emisor no está disponible. Volver a intentar. SERVICE_NOT_AVAILABLE_RETRY El sistema del emisor no está disponible. Se puede volver a intentar
U Dirección no está disponible, no hay datos por parte del emisor. NOT_AVAILABLE No hay datos disponibles por parte del emisor, o no se reconocen los datos del AVS para la transacción
E No es un pedido telefónico.
N La dirección y el código postal no coinciden NO_MATCH No coinciden
0 (Cero) No se solicitó AVS. (Usado por VisaII). NOT_REQUESTED No se solicitó AVS
K Solo coincide el nombre del titular de la tarjeta. NAME_MATCH Coincidió el nombre del titular de la tarjeta.
O Coincide el nombre del titular de la tarjeta y la dirección. NAME_ADDRESS_MATCH Coincidió el nombre del titular de la tarjeta y la dirección.
L Coincide el nombre del titular de la tarjeta y el código postal. NAME_ZIP_MATCH Coincidió el nombre del titular de la tarjeta y el código postal.
Códigos de respuesta para el Código de seguridad de tarjeta (CSC)
Cliente de pago/Cliente de pago virtual API
Código de respuesta Descripción response.cardSecurityCode.gatewayCode Descripción
M CSC válido o concordante MATCHED Válido o concordante
S El negocio indica que la tarjeta no cuenta con CSC NOT_PRESENT El negocio indicó que la tarjeta no cuenta con un CSC
P CSC sin procesar NOT_PROCESSED No se procesó
U El emisor de la tarjeta no está registrado y/o certificado NOT_SUPPPORTED El emisor de la tarjeta no está registrado y/o certificado
N Código no válido o no concuerda NO_MATCH No es válido o no concuerda.
¿Se puede volver a enviar una solicitud a Mastercard Payment Gateway si no se recibe una respuesta?

Sí, es seguro volver a enviar una solicitud con los mismos detalles porque el motor de pagos admite operaciones idempotentes. Las operaciones idempotentes producen el mismo resultado cuando se invocan repetidamente. Si el motor de pagos ya recibió su solicitud, devolverá la respuesta original; de lo contrario, procesará la solicitud y devolverá la respuesta.

¿Cómo puedo hacer coincidir solicitudes a Mastercard Payment Gateway con las respuestas?

Normalmente, puede hacer coincidir las solicitudes con las respuestas utilizando los campos order.id y transaction.id, ya que estos se proporcionan en las solicitudes y se devuelven en las respuestas. Sin embargo, si su aplicación no admite un modelo de integración síncrono o si su origen y destino para una solicitud difieren, puede utilizar el campo correlationId para identificar la solicitud y su respuesta coincidente. correlationId es un identificador transitorio, cuyo valor no persiste en el motor de pagos y se devuelve tal como se proporciona en la respuesta a la solicitud. Puede usar el correlationId con todas las solicitudes de API.

¿Por qué recibo un error de No merchant acquirer link para un adquirente para el cual estoy configurado?

Comuníquese con su proveedor de servicios de pago para asegurarse de que su vínculo de adquirente del negocio en el motor de pagos esté configurado para el tipo de tarjeta y las combinaciones de divisas requeridas.

¿Qué es Administración de negocios?

Administración de negocios es una interfaz basada en web que permite a los negocios ver y administrar fácilmente sus pedidos. Los negocios pueden buscar y ver los detalles de su pedido o transacción, descargar reportes CSV, comprobar los resultados de 3-D Secure, configurar controles de riesgo, crear pedidos manualmente, administrar reembolsos y mucho más. Para obtener más detalles, consulte la Guía de usuario de Administración de negocios.

Los negocios deben estar incorporados en el motor de pagos y tener su perfil de negocio configurado correctamente para acceder a Administración de negocios.

Derechos de autor © 2020 Mastercard