Solución de problemas y preguntas frecuentes
En esta sección, encontrará sugerencias y soluciones a problemas que pueden ocurrir con su integración.
La funcionalidad de recargo en Mastercard Gateway permite a un negocio aplicar un recargo en una transacción según los siguientes parámetros:
- Punto de entrada de motor de pagos, como Hosted Checkout o API.
- Método de pago como Mastercard, Visa o American Express.
- Método de financiamiento como Crédito o Débito.
- Moneda
Sí, puede configurar las reglas de filtrado de países de IP en Merchant Administration. Su proveedor de servicios de pago puede configurar reglas para usted en Merchant Manager, además de las reglas que se aplican a todos los negocios. Esto le permitirá rechazar o revisar transacciones que se originen en direcciones IP asociadas con países de alto riesgo.
Los reembolsos se pueden realizar solo cuando se completa una transferencia de fondos, ya sea mediante una operación Pay o Capture.
La anulación (cancelación) solo se puede realizar en transacciones que el adquirente no haya enviado al banco para su procesamiento al final del día.
Sí, puedes configurar un pago recurrente con un monto variable, por ejemplo, pago de facturas pospago. Debe actualizar el valor del parámetro amountVariability de acuerdo con los requisitos. Para obtener más información, consulte Transacciones con credencial en archivo.
La principal diferencia entre las dos versiones del SDK es la siguiente:
| SDK versión 1 | SDK versión 2 |
|---|---|
| Sin experiencia nativa en la aplicación | Experiencia nativa en la aplicación, sin redirecciones |
| Flujo de desafío con redirecciones | Se admiten múltiples flujos de desafío, como OTP, selección única y múltiple, basados en respuestas. |
| Flujo de desafío del emisor a través del explorador web en un dispositivo móvil | Flujo más inteligente y sin fricciones que genera menos desafíos para el 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.
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.
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 DirectAPI. En las siguientes tablas se muestra la asignación entre los dos tipos de respuestas devueltos por el Mastercard Gateway.
| Cliente de pago/Cliente de pago virtual | DirectAPI | ||
|---|---|---|---|
| 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 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 |
| Cliente de pago/Cliente de pago virtual | DirectAPI | ||
|---|---|---|---|
| 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. |
| Cliente de pago/Cliente de pago virtual | DirectAPI | ||
|---|---|---|---|
| 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. |
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.
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 DirectAPI.
No merchant acquirer link para un adquirente para el cual estoy configurado?Comuníquese con your payment service provider 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.
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.
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 |