Existen muchos componentes para asegurarse de que el cuerpo de la solicitud de transacción se envíe de manera segura al motor de pagos. En esta sección, se abarcan los conceptos y las funciones esenciales que necesita usar en su integración.
API de Mastercard Payment Gateway requiere que cada solicitud de transacción se autentique de manera satisfactoria. El fragmento siguiente sirve para proporcionar datos de autenticación (ID de negocio y/o Contraseña de API) con cada transacción.
Este fragmento de código muestra cómo configurar credenciales en el programa.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
Los encabezados HTTP proporcionan información de metadatos acerca del envío de la solicitud de transacción al Mastercard Payment Gateway. Este fragmento demuestra los encabezados HTTP obligatorios que deben configurarse para cada solicitud de transacción (los encabezados enumerados aquí se deben configurar además de cualquier encabezado de autenticación mencionado en Datos de autenticación, donde corresponda).
Los encabezados de Longitud de contenido y Tipo de contenido son críticos porque indican al servidor web cuántos bytes de datos debe esperar y de qué tipo, identificados por un tipo MIME. La codificación de caracteres de su solicitud debe incluir solo formatos ISO-8859-1 o UTF-8. Consulte Asegurar codificación de caracteres.
Este fragmento de código muestra cómo configurar encabezados HTTP en el programa.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
Dependiendo de las opciones de protocolo e integración elegidas, quizás deba usar un método HTTP específico para cada transacción. Todas las operaciones básicas realizadas a través de API de Mastercard Payment Gateway usan el método HTTP PUT con el protocolo REST (salvo las operaciones Retrieve y CheckGateway); y el método HTTP POST con el protocolo NVP.
Con REST, el método HTTP PUT actualiza el miembro abordado de la colección o, si no existe, crea un miembro nuevo. Por ejemplo, si el URI de la solicitud es http://example.com/version/v1/merchant/m1/order/o1/transaction/t1, donde t1 es un miembro del recurso de colección o1, entonces si t1 existe, la solicitud modifica el recurso t1, o bien crea un nuevo miembro t1. El método HTTP GET recupera una representación del miembro abordado de la colección. Por ejemplo, si el URI de la solicitud es http://example.com/version/v1/merchant/m1/order/o1/transaction/t1, entonces GET recupera t1.
Con NVP, el método HTTP POST se utiliza para todas las operaciones de transacción.
Este fragmento de código muestra cómo usar el método HTTP POST.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
Este fragmento de código muestra cómo usar el método HTTP PUT.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
La dirección URL usada para enviar su solicitud de transacción puede cambiar para cada solicitud de transacción:
Este fragmento de código muestra cómo configurar la dirección URL para la solicitud de transacción.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
El fragmento de código muestra cómo configurar la dirección URL para enviar una transacción.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
A fin de evitar ataques malintencionados así como otros posibles problemas de seguridad, es fundamental que valide el certificado SSL de Mastercard Payment Gateway cuando envíe la solicitud de transacción. Los fragmentos siguientes son esenciales para garantizar la transmisión segura de su solicitud de transacción.
Este fragmento de código muestra cómo verificar el certificado SSL.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
En algunos entornos de red, puede ser necesario enviar la solicitud de transacción a través de un servidor proxy. Esto es opcional y debe consultar su administrador de red o proveedor de hospedaje web para obtener información sobre si esto es pertinente para su integración.
Este fragmento de código muestra cómo configurar el proxy y su autenticación.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra
Como último paso, debe enviar su solicitud de transacción con formato correcto a Mastercard Payment Gateway y esperar una respuesta.
Este fragmento de código muestra cómo enviar la transacción a Mastercard Payment Gateway.
Seleccione protocolo e idioma para ver el fragmento de código.
De: Descarga de código de muestra