Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
En primer lugar, compruebe su conectividad con el Mastercard Gateway.
Antes de comenzar a crear la integración, debe prepararse con los valores para los campos que requieren su información.
Crear el cuerpo de la solicitud es un paso crítico en la integración.
Existen muchos componentes para confirmar que el cuerpo de la solicitud de transacción se envía de manera segura al Mastercard Gateway.
Una vez que se envía un lote, puede solicitar periódicamente un estado del lote para determinar el estado actual del procesamiento de lotes.
Después de que un lote ha finalizado el procesamiento, puede solicitar un archivo de respuesta que contiene el resultado de cada una de las operaciones cargadas.
Las pruebas le permiten verificar si su integración funciona como lo desea.
Sí, puede usar varios perfiles de negocio en una solicitud de lote único si puede asegurar que las credenciales de operación (identificador de negocio y contraseña de autenticación) para cada fila de operación son válidas para permitir una autenticación y autorización satisfactorias.
De manera predeterminada, las credenciales de operación para cada operación de un lote usarán las credenciales de autenticación suministradas en el encabezado de solicitud del lote (tanto identificador como contraseña de negocio). Puede elegir usar el mecanismo de aplicación predeterminada o suministrar credenciales de operación contra cada fila de registro de operación. Con esto último, la autenticación de la operación usará las credenciales de nivel de operación y no aplicará de manera predeterminada las credenciales de lote de carga. Si las credenciales de nivel de operación son incorrectas, entonces se rechazará la solicitud de carga de lote.
En el archivo de lote de muestra a continuación, las operaciones VOID
usarán las credenciales de encabezado de solicitud de lote, ya que el identificador de negocio y la contraseña no se han suministrado.
merchant,apiPassword,apiOperation,order.id,transaction.id,transaction.amount,transaction.currency, cardDetails.card.number, cardDetails.card.expiry.month,cardDetails.card.expiry.year,card.number,result,error.cause, error.explanation,response.gatewayCode TESTMERCHANT,<TESTMERCHANT_API_PASSWORD>,PAY,921830104167,TXID1,30,AUD,5123456789012346,05,13,,,,, TESTMERCHANT,<TESTMERCHANT_API_PASSWORD>,PAY,921830104168,TXID1,30,AUD,5123456789012346,05,13,,,,, TESTMERCHANT,<TESTMERCHANT_API_PASSWORD>,PAY,921830104169,TXID1,100,AUD,345678901234564,05,13,,,,, ,,VOID,1256378915689,TXID1,100,AUD,4987654321098769,05,13,,,,, ,,VOID,1256378915690,TXID1,100,AUD,4987654321098769,05,13,,,,, ,,VOID,1256378915691,TXID1,100,AUD,4987654321098769,05,13,,,,,
Los envíos de lote pueden fallar debido a las siguientes condiciones de error.
Escenario | Mensaje de error |
---|---|
Lote incompleto debido a que el resumen del mensaje SHA-1 no coincide | Envío de lote falló debido a una de las siguientes razones:
|
Nombre de lote duplicado
|
Error en el envío de lote: actualmente se está cargando un lote con este nombre, o ya se cargó un lote con el mismo nombre pero con un contenido diferente. Si ya se está cargando el archivo, espere que termine de cargar. Si está usando un nombre de archivo que ya está tomado, cambie el nombre del archivo y vuelva a enviarlo. |
Si no tiene los privilegios necesarios para enviar lotes se devuelve un error de autenticación:
|
Error al autenticar: las credenciales proporcionadas en el registro <record number> son incorrectas. Esto se puede deber a:
|
Al proporcionar una contraseña sin un ID de negocio en el nivel de operación se devuelve un error de autenticación. | Error al autenticar. En el registro <record number> del archivo de lote se proporciona una contraseña, pero no un ID de negocio. Agregue un ID de negocio o elimine la contraseña para usar las credenciales del negocio en el nivel de lote para este registro, luego intente enviar la solicitud nuevamente. |
Cuando las credenciales de lote no tienen el formato de lote se devuelve un error de autenticación. | Error al autenticar: las credenciales proporcionadas en el encabezado:
|
Los errores de autenticación se generan cuando:
|
Error al autenticar: las credenciales proporcionadas para el lote no son válidas. Corrija las credenciales e intente enviar la solicitud nuevamente. |
Cuando el encabezado contiene caracteres no válidos se devuelve un error de análisis. | Error en el envío de lote: el lote no se pudo analizar, debido a que el encabezado contiene un carácter ilegal. Los caracteres permitidos son:
|
Cuando una fila de registro de operación contiene más valores de los definidos en el encabezado se devuelve un error de análisis. | Error en el envío de lote: no se pudo analizar el lote, debido a que el registro <record number> contiene más valores de los que se definen en el encabezado. Corrija el lote y luego intente enviarlo nuevamente. |
Cuando se ha sobrepasado el tamaño máximo del campo individual o se produce un error desconocido durante el análisis de un registro de operación, se devuelve un error de análisis. | Error en el envío de lote: no se pudo analizar el lote debido a un error en el registro <record number> . Asegúrese de que el lote cumple con el formato del archivo y que tiene la codificación correcta, luego intente enviarlo nuevamente. |
Cuando no se proporciona ninguna codificación o esta es incorrecta, se produce un error de codificación. | Error en la solicitud: no se reconoce la codificación proporcionada. Las codificaciones válidas son UTF-8 y LATIN1. Vuelva a enviar la solicitud con una codificación correcta. |
No se encontró el lote | Error en la solicitud: no se pudo encontrar ningún lote con este nombre. Corrija el nombre del lote y envíe la solicitud nuevamente. |
Se produjo un error en la comprobación de la longitud de la versión proporcionada. | Error en la solicitud: la versión proporcionada no es válida. Corrija la versión y envíe la solicitud nuevamente. |
Se produjo un error en la comprobación de la longitud del Nombre de Lote proporcionado. | Error en la solicitud: el nombre de lote proporcionado no es válido. Corrija el nombre del lote y envíe la solicitud nuevamente. |
Se produjo un error en la comprobación del ID de negocio proporcionado. | Error en la solicitud: el ID de negocio proporcionado no es válido. Corrija el ID de negocio y envíe la solicitud nuevamente. |
Se produjo un error en el motor de pagos | La solicitud no se pudo enviar al motor de pagos debido a un error interno en el motor de pagos. Vuelva a intentarlo más tarde. |
El procesamiento de operaciones por Batch puede fallar debido a errores en las comunicaciones o los sistemas. Esto puede generar uno de los siguientes errores:
Cuando esto ocurre y una operación se puede reintentar, Batch intentará enviar la operación nuevamente para su procesamiento hasta que se reciba una respuesta de que ya no se puede reintentar la operación o se alcance el límite de reintentos.
Batch almacena los nombres de lote y su correspondiente Código de integridad de mensaje (MIC) cargado por usted. Los lotes con un nombre de lote que se han enviado anteriormente pero con contenido diferente se pueden identificar y serán rechazados por Batch.
Los lotes con un mismo nombre y contenido que un lote enviado anteriormente también se pueden identificar y Batch devuelve el mismo estado que para el lote cargado antes. De manera que si el negocio sospecha que hubo un problema de transmisión, es capaz de verificar que el lote se cargó correctamente en Batch.
Los valores de la fila del encabezado de una solicitud de lote enviados para su procesamiento solo pueden contener caracteres que se puedan encontrar en nombres de campo NVP de API. Se permiten los siguientes caracteres:
Batch rechaza un lote si se encuentran errores de análisis. El análisis incluye separa el lote en filas y las filas en campos.
Se puede producir un error de análisis cuando:
Debe corregir estos errores primero antes de enviar el lote para procesamiento nuevamente.
El servicio de Batch no garantiza que procesará las operaciones en el mismo orden según se especifica en el archivo de lote, porque el despachador del Batch puede procesar operaciones en paralelo. Este comportamiento también se puede atribuir a la función de reintento, es decir, si algunas operaciones en un archivo de lote deben reintentarse, entonces las operaciones que están listas se procesarán primero, independientemente del orden en el cual se especificaron. Por ejemplo, incluso si se especifican operaciones posteriores después de operaciones iniciales (Capture seguida de Authorization, Void seguida de Pay), entonces Capture se puede realizar antes que Authorization, o bien Void antes que Pay.
Por tanto, en el caso de operaciones que deben seguir estrictamente un orden, se recomienda que ejecute el lote inicial de operaciones primero, espere el archivo de respuesta de lote y, si es satisfactoria, ejecute el lote posterior de operaciones.
Tokenization almacena detalles de tarjeta en un token. Para usar Tokenization con Batch, debe usar el identificador de token en el archivo de lote, como se muestra a continuación.
apiOperation,cardDetails.card.number,cardDetails.card.expiry.month,cardDetails.card.expiry.year,cardDetails.card.securityCode,cardDetails.cardToken,transaction.amount,transaction.currency,transaction.id,transaction.authorizationCode,order.id,card.start.month,card.start.year,card.issueNumber,card.bankAccountType
AUTHORIZE,,,,,200,10,AUD,TXID1,,10323711802,,,,
AUTHORIZE,,,,,300,20,AUD,TXID1,,10323711803,,,,
AUTHORIZE,,,,,400,10,AUD,TXID1,,10323711804,,,,
AUTHORIZE,,,,,500,5.99,AUD,TXID1,,10323711805,,,,
Las credenciales de operación incluyen identificador y contraseña de negocio. Las credenciales de operación para cada operación de un lote se aplicarán de manera predeterminada a las credenciales de autenticación suministradas en el encabezado de solicitud del lote (tanto identificador como contraseña de negocio). Sin embargo, si realmente especifica los valores para ambos campos contra las filas de registro de operación, la autenticación de la operación usará las credenciales de nivel de operación y no se aplicará de manera predeterminada a las credenciales del lote de carga.
Sí, puede procesar varios tipos de operaciones en un archivo de lote único, siempre y cuando NO se relacionen con el mismo pedido; es decir, que no contengan el mismo identificador de pedido. El servicio de Batch no garantiza que procesará las operaciones en el mismo orden según se especifica en el archivo de lote, porque el despachador del Batch puede procesar operaciones en paralelo. Este comportamiento también se puede atribuir a la función de reintento, es decir, si algunas operaciones en un archivo de lote deben reintentarse, entonces las operaciones que están listas se procesarán primero, independientemente del orden en el cual se especificaron. Por ejemplo, si las operaciones Pay y Void están en el mismo archivo de lote, Void puede realizarse primero que Pay. Sin embargo, si las operaciones NO están relacionadas con el mismo pedido, es decir, contienen diferentes identificadores de pedido, entonces puede tener varios tipos de operación en un archivo de lote único.
Sí, puede usar varias fuentes de detalles de tarjeta en un archivo de lote único, salvo el identificador de sesión de pago. Para obtener más información sobre varias fuentes, consulte Diversas fuentes de detalles de tarjeta.
Las operaciones de Autorización de la muestra a continuación usan tokens en vez de detalles de tarjeta.
apiOperation,order.id,transaction.id,transaction.amount,transaction.currency,cardDetails.card.number,cardDetails.card.expiry.month,cardDetails.card.expiry.year,card.number,cardDetails.cardToken,result,error.cause,error.explanation,response.gatewayCode
PAY,921830104167,TXID1,30,AUD,5123456789012346,05,13,,,,,,
PAY,921830104168,TXID1,50,AUD,5123456789012346,05,13,,,,,,
PAY,921830104169,TXID1,100,AUD,4987654321098769,05,13,,,,,,
AUTHORIZE,10072028281,TXID1,,,,,,,200,,,,,
AUTHORIZE,10072028282,TXID1,,,,,,,300,,,,,
AUTHORIZE,10072028283,TXID1,,,,,,,400,,,,,