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 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 el 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 satisfactoria 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 vencida EXPIRED_CARD Transacción rechazada debido a una tarjeta vencida
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 incorrectos, 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 el 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 3-D 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 3-D Secure
C Transacción cancelada CANCELLED Transacción cancelada por el titular de la tarjeta
D Transacción diferida DEFERRED_TRANSACTION_RECEIVED Se recibió una transacción diferida y está en espera de su procesamiento
E Transacción rechazada: consultar al emisor de la tarjeta REFERRED Transacción rechazada: consultar al emisor de la tarjeta
F Error en la autenticación 3-D Secure AUTHENTICATION_FAILED Error en la autenticación 3-D Secure
I Error en el código de seguridad de tarjeta INVALID_CSC Código de seguridad de tarjeta no válido
U 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 3-D 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 vencido
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: plan de pago no soportado. 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 (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 soportado. 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 disponible, no hay datos por parte del emisor. NOT_AVAILABLE No hay datos disponibles por parte del emisor o los datos del AVS para la transacción no son soportados
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 el CSC no aparece en la tarjeta NOT_PRESENT El negocio indicó que el CSC no aparece en la tarjeta
P CSC P no procesado 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 al 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. No obstante, si la aplicación no admite un modelo de integración síncrono o el origen y el destino para una solicitud difieren, se puede utilizar el campo correlationId para identificar la solicitud y su respuesta coincidente. correlationId es un identificador temporal, 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 Merchant Administration?

Merchant Administration 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. Consulte la Guía de usuario de Merchant Administration para obtener más detalles.

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

¿Qué pasa si mi transacción es rechazada?

El emisor o la red de tarjetas pueden proporcionar información adicional en forma de un Código de consejo de negocio, que lo ayudará a comprender el motivo por el cual se rechazó la transacción. Cuando se rechaza una transacción por fondos insuficientes, el código de consejo puede recomendar a los negocios un plazo de reintento en el que es probable que se apruebe una autorización.

En la tabla siguiente se describen los distintos códigos de consejo de negocio devueltos por los esquemas.

Código de consejo de negocio Recomendación del esquema
01 Información de cuenta nueva disponible
02 No se puede aprobar en este momento, vuelva a intentarlo más tarde
03 No vuelva a intentarlo
04 No se cumplen los requisitos para este tipo de token
05 Valor negociado no aprobado
21 Cancelación de pago
22 El negocio no es apto para el código de producto
24 Reintentar después de 1 hora
25 Reintentar después de 24 horas
26 Reintentar después de 2 días
27 Reintentar después de 4 días
28 Reintentar después de 6 días
29 Reintentar después de 8 días
30 Reintentar después de 10 días
R0 Detener pedido de pago
R1 Revocación de pedido de autorización
R3 Revocación de todos los pedidos de autorización

Derechos de autor © 2023 Mastercard