Implementación de una integración de Direct Payment

  1. Acceder a Mastercard Payment Gateway
  2. Conocer sus campos de información
  3. Crear la solicitud de transacción
  4. Enviar la solicitud de transacción
  5. Procesar la respuesta de transacción
  6. Prueba e inicio de transacciones en producción


Mastercard Payment Gateway Características soportadas

Seguridad de pagos y prevención de fraudes

Operaciones de pago

Métodos de pago

Opciones de pago

Datos adicionales

Otras características

Implementación de una integración de Direct Payment

Requisitos previos

Pasos de integración

No invoque ninguna operación de API directamente desde el explorador.

Paso 1: Acceder al motor de pagos

En primer lugar, compruebe su conectividad con el Mastercard Payment Gateway.

Paso 2: Conocer sus campos de información

Antes de comenzar a crear la integración, debe prepararse con los valores para los campos que requieren su información.

Paso 3: Cree la Solicitud de transacción

Crear el cuerpo de la solicitud es un paso crítico en la integración.

Paso 4: Envíe la solicitud de transacción

Existen muchos componentes para confirmar que la solicitud de transacción se envía de manera segura al Mastercard Payment Gateway.

Paso 5: Procese la respuesta de transacción

Una vez que la solicitud de transacción se envía al motor de pagos, por lo general, recibirá una respuesta dentro de un período muy breve. Deberá procesar esta para poder completar la transacción.

Paso 6: Prueba e inicio de transacciones en producción

Las pruebas le permiten verificar si su integración funciona como lo desea.

Solución de problemas y preguntas frecuentes

¿Cómo sé cuál es la versión más reciente de la API?

Vaya al vínculo adecuado de (REST/NVP) [todas las versiones] en la sección Documentación de protocolo en la página de índice de Referencia API.

¿Los nombres de campo de la API distinguen entre mayúsculas y minúsculas?

Sí, los nombres de campo de la API de todas las operaciones distinguen entre mayúsculas y minúsculas.

¿Cómo transmito parámetros de solicitud utilizando el protocolo REST?

Si utiliza HTTP POST, incluya los parámetros de solicitud en el cuerpo HTTP utilizando codificación JSON. Con HTTP GET, asegúrese de que los parámetros de solicitud se incluyan en la URI como parámetros de consulta.

¿Qué sucede cuando transmito campos definidos por el negocio a la API?

Los campos definidos por el negocio no son compatibles con esta versión de Mastercard Payment GatewayAPI.

¿Qué pasa cuando vuelvo a enviar una transacción?

La transacción idéntica vuelta a enviar devolverá la misma respuesta que la primera de las operaciones. Todas las operaciones en esta versión de API de Mastercard Payment Gateway son idempotentes; es decir, los efectos de las solicitudes idénticas repetidas son los mismos que para una solicitud única. Por lo tanto, puede estar seguro de que la transacción no se repetirá con su banco o el banco del pagador.

¿Necesito crear un nuevo pedido si la transacción inicial para el pedido falla?

Desde API v15 en adelante, si la transacción inicial para un pedido falla, usted puede enviar una nueva transacción inicial (con un nuevo ID de transacción) para este pedido sin tener que crear un nuevo pedido.

¿Qué pasa si proporciono los detalles de tarjeta en una transacción Capture o Refund posterior?

Desde API v15 en adelante, si desea realizar una transacción Capture o Refund contra una transacción inicial exitosa, usted NO debe proporcionar los detalles de tarjeta en su solicitud. Si proporciona detalles de tarjeta cuando el pedido ya tiene una transacción inicial exitosa, entonces Mastercard Payment Gateway rechaza la solicitud.

¿Qué debo hacer si no recibo una respuesta?

Cuando no recibe una respuesta, se recomienda que espere 60 segundos e intente volver a enviar la solicitud idéntica. La transacción bancaria no se repetirá nuevamente y puede estar seguro de que no se transferirán fondos duplicados. Recibirá la misma respuesta que habría recibido para la primera solicitud.

¿Cómo sé que una transacción se aprobó?

Todas las transacciones se representan con un Código de respuesta de transacción de APPROVED desde Mastercard Payment Gateway. Cualquier otro código representa una transacción rechazada o fallida.

¿Qué sucede si el pagador envía dos veces (hace doble clic) el Formulario de detalles de pago?

La transacción idéntica vuelta a enviar devolverá la misma respuesta que la primera de todas las operaciones en Mastercard Payment Gateway (los efectos secundarios de las solicitudes idénticas N > 0 son los mismos que para una solicitud única). De manera que puede estar seguro de que la transacción no se repetirá con su banco o el banco del pagador.

Consejos y mejores prácticas

Valide el certificado SSL de Mastercard Payment Gateway

Se recomienda encarecidamente que valide el certificado SSL del Mastercard Payment Gateway siempre que se conecte al Mastercard Payment Gateway. El certificado SSL del Mastercard Payment Gateway es emitido por una Entidad de certificación estándar del sector como Verisign o Thawte, cuyo certificado raíz ya debería estar disponible en su entorno web.

Si no está familiarizado con la validación de certificados SSL o su exportación desde sitios web, consulte con un desarrollador web. Siempre asegúrese de que el servidor sea una fuente confiable.