Los campos de Hosted Payment Session se usan para recopilar los detalles de tarjeta de parte del pagador de esta; cuando se envía, el formulario se publica directamente en el Servicio de Hosted Payment Session a través de HTTPS POST. Este es un requisito previo para realizar transacciones de pago o almacenamiento con una sesión.
El envío de la página de pago no inicia una transacción de pago.
Antes de enviar la página de pago, debe crear una sesión mediante la operación Create Session.
Esta operación devuelve un identificador de sesión, el cual debe incrustar en la URL de Servicio de Hosted Payment Session al enviar la página de pago.
La respuesta de formulario junto con los parámetros de la solicitud se devuelven a usted en el formulario validado. Esto le permite realizar una operación con el identificador de sesión en lugar de los detalles de la tarjeta. Para obtener más información, consulte Realizar una operación con la sesión.
Método HTTPS POST URL de formulario https://evopaymentsmexico.gateway.mastercard.com/form/<formSessionIdentifier> Autenticación Verificación de la sesión mediante el identificador de sesión.
Parámetros de solicitud
Si el valor del parámetro de solicitud es erróneo, entonces se devuelve un error en el valor de campo (consulte Administración de errores) o bien el pagador (o probador de integración) se redirecciona a una página que detalla el error.
gatewayReturnURL URL= (OBLIGATORIA)
La URL a la cual desea redirigir al pagador, después de enviar los detalles de la tarjeta. Si la URL no existe o no es válida, entonces se mostrará una página en el explorador que detalle el error. Este campo debe etiquetarse como hidden () en el formulario de pago.
Existencia
COMPULSORY
Reglas de validación
Debe ser una URL totalmente calificada que empiece con HTTP:// o HTTPS://, de preferencia este último, ya que se recomienda que el explorador se devuelva a una página protegida por SSL. Esto evitará la aparición de una ventana emergente del explorador que indique que el pagador se devuelve a un sitio seguro.
longitud mínima
8
longitud máxima
2000
gatewayCardNumber Dígitos, espacio, guion y caracteres de enmascarado= (OPCIONAL)
Número de la tarjeta de crédito del pagador tal como aparece en la tarjeta.
Enmascarado: Cuando se devuelve en la respuesta de formulario, el número de tarjeta se enmascarará de acuerdo con la configuración correspondiente del comerciante o 6.4, la que sea más restrictiva (por ejemplo, 000000xxxxxx0000). Si el pagador ingresa cualquier carácter enmascarado en el envío inicial, el valor se rechazará como no válido.
Seccionado: Cualquier espacio o guion encontrado en el ingreso del pagador se eliminará de la respuesta.
Truncado: Si la información sobrepasa la longitud máxima, la respuesta se truncará de acuerdo con esta y se indicará un error en el campo de respuesta.
Errores: Si el valor de campo no es válido, puede volver a mostrar el formulario (con el número de tarjeta enmascarado) indicando que hay un error en el campo.
Reenvío: Si el formulario se reenvía con los valores de respuesta y el número de tarjeta enmascarada se envía sin cambios, Hosted Payment Session aceptará esto como el número de tarjeta ingresado originalmente.
Caracteres de enmascarado: El carácter de enmascarado predeterminado es 'x'. Puede reemplazar este carácter por 'X' o '*' al reenviar y se reconocerá como enmascarado válido.
Existencia
OPCIONAL
Valor fijo
Reglas de validación
Los datos son una cadena que consta de los caracteres del 0 al 9, ' ' (espacio), '-' (guion). Los caracteres de enmascarado ('x', 'X' y '*') son válidos solo al reenviar.
longitud mínima
1
longitud máxima
30
gatewayCardSecurityCodeDígitos y caracteres de enmascarado= (OPCIONAL)
Código de seguridad de la tarjeta del pagador de esta, tal como aparece al anverso y al reverso de ella.
Enmascarado: Cuando se devuelve en la respuesta de formulario, el código de seguridad de la tarjeta estará totalmente enmascarado (por ejemplo, xxxx). Si el pagador ingresa cualquier carácter enmascarado en el envío inicial, el valor se rechazará como no válido.
Truncado: Si la información sobrepasa la longitud máxima, la respuesta se truncará de acuerdo con esta y se indicará un error en el campo de respuesta.
Errores: Si el valor de campo no es válido, puede volver a mostrar el formulario (con el código de seguridad de tarjeta enmascarado) indicando que hay un error en el campo.
Reenvío: Si el formulario se reenvía con los valores de respuesta y el CSC enmascarado se envía sin cambios, Hosted Payment Session aceptará esto como el CSC ingresado originalmente.
Caracteres de enmascarado: El carácter de enmascarado predeterminado es 'x'. Puede reemplazar este carácter por 'X' o '*' al reenviar y se reconocerá como enmascarado válido. Todo carácter enmascarado se considerará no válido en el envío inicial.
Existencia
OPCIONAL
Valor fijo
Reglas de validación
Los datos son una cadena que consta de los caracteres del 0 al 9. Los caracteres de enmascarado ('x', 'X' y '*') son válidos solo al reenviar.
longitud mínima
0
longitud máxima
10
gatewayCardExpiryDateMonth Dígitos= (OBLIGATORIO)
Mes de vencimiento, tal como aparece en la tarjeta. Los meses se enumeran ENE=1 hasta Diciembre=12. Si el valor de campo no es válido, puede volver a mostrar el formulario indicando que hay un error en este campo.
Existencia
OBLIGATORIO
Valor fijo
Reglas de validación
Los datos son un número entre 1 y 12 representado como una cadena.
longitud mínima
1
longitud máxima
2
gatewayCardExpiryDateYear Dígitos = (OBLIGATORIO)
Año de vencimiento, tal como aparece en la tarjeta. El año de la Era común es 2000 más este valor. Si el valor de campo no es válido, puede volver a mostrar el formulario indicando que hay un error en el campo.
Existencia
OBLIGATORIO
Valor Fijo
Reglas de validación
Los datos son una cadena que consta de los caracteres del 0 al 9. El valor debe estar entre 2000 y 2099 o 00 y 99.
longitud mínima
2
longitud máxima
4
gatewayRedirectDisplayBackgroundColorCaracteres alfanuméricos o de otro tipo= (OPCIONAL)
Color de fondo de la página representada en el explorador del pagador antes de que la respuesta de formulario se publique de vuelta en la integración del comerciante. Se recomienda que el color que especifica se mezcle bien con el esquema de color de su sitio Web para proporcionar una experiencia sin problemas al pagador. Este campo debe etiquetarse como oculto () en el formulario de pago.
Existencia
OPCIONAL
Reglas de validación
Las siguientes representaciones de CSS se consideran válidas. Los valores no válidos se eliminarán del ingreso y el valor predeterminado usado.
Hexadecimal: El formato de un valor RGB en notación hexadecimal es un '#' seguido inmediatamente de tres o seis caracteres hexadecimales. Por ejemplo, #F00, #FF0000
Nombres de color: Nombres de color como "red", "white" etc.
Valor RGB: "rgb" seguido de 3 valores numéricos en paréntesis, por ejemplo: "rgb(255,0,0)"
Título de la página representada en el explorador del pagador antes de que la respuesta de formulario se publique de vuelta en la integración del comerciante. Se recomienda que el título que especifica proporcione una sensación de continuidad al pagador para así mejorar la experiencia de compra. Este campo debe etiquetarse como oculto () en el formulario de pago.
Título del botón que se representará en el explorador del pagador si JavaScript está deshabilitado. Se recomienda que el texto que especifica para el botón se mezcle bien con la experiencia de compra para el pagador. Hacer clic en el botón publicará la respuesta de formulario de vuelta en la integración del comerciante. Este campo debe etiquetarse como oculto () en el formulario de pago.
Existencia
OPCIONAL
Reglas de validación
Texto
valor predeterminado
Haga clic aquí para continuar
longitud mínima
0
longitud máxima
255
Parámetros de respuesta
Todos los parámetros enviados en la solicitud se devolverán en la respuesta. Además, se devolverán los siguientes parámetros.
Los campos gatewayCardBrand, gatewayCardLocalBrand y gatewayCardFundingMethod se devuelven solo si se utiliza la solicitud Crear sesión en la versión 15+.
gatewayFormResponse Enumeración = (Siempre se devuelve)
Indica el resultado general del envío del formulario.
Existencia
Siempre se devuelve
Reglas de validación
Código de respuesta general en el formato R~D, donde R es un código de carácter único que indica el resultado y D es una descripción en inglés. Este valor debe revisarse antes de procesar otros campos en la respuesta de formulario.
El valor debe ser miembro de la siguiente lista. Los valores distinguen entre mayúsculas y minúsculas.
0~OK
Indica que el formulario es válido; se devuelve cuando no se encuentra ningún error de formulario.
2~Session identifier invalid or closed for updates
Indica sesión no válida; se devuelve cuando la sesión falta, ha caducado, se ha cerrado o no es válida.
3~Field Errors
Indica errores de campo; se devuelve si algún campo del formulario no se puede validar.
4~System Error
Indica error de sistema; se devuelve si se presenta un error de Puerta de enlace de pago u otro error.
gatewayCardScheme Enumeración=
Esquema de la tarjeta determinado a partir de la tarjeta suministrada.
Existencia
Siempre se devuelve
Reglas de validación
El valor debe ser miembro de la siguiente lista. Los valores distinguen entre mayúsculas y minúsculas.
AMEX
American Express
DINERS_CLUB
Diners Club
DISCOVER
Discover
JCB
JCB (Japan Credit Bureau)
MASTERCARD
Mastercard
UATP
UATP (Universal Air Travel Plan)
VISA
Visa
OTRO
No se pudo identificar el esquema de la tarjeta utilizada en la transacción.
gatewayCardBrand Enumeración=
La marca comercial que se utiliza para describir la tarjeta se reconoce y acepta a nivel mundial. Para la mayoría de los tipos de tarjeta principales habrá coincidencia con el nombre de esquema. En algunos mercados, una tarjeta también puede tener una marca compartida con una marca local que se reconoce y acepta dentro de su país/región de origen (ver gatewayCardLocalBrand). Puede usar esta información para respaldar decisiones de recargo. Esta información se reúne desde fuentes de terceros y puede que no sea exacta en todas las circunstancias.
Existencia
Siempre se devuelve
Reglas de validación
El valor debe ser miembro de la siguiente lista. Los valores distinguen entre mayúsculas y minúsculas.
AMEX
American Express
DINERS_CLUB
Diners Club
DISCOVER
Discover
JCB
JCB (Japan Credit Bureau)
MAESTRO
Maestro
MASTERCARD
Mastercard
VISA
Visa
UATP
UATP (Universal Air Travel Plan)
SOLO
Solo
SOLAMENTE_MARCAS_LOCALES
La tarjeta no tiene una marca global.
DESCONOCIDO
No se pudo identificar la marca de la tarjeta utilizada en la transacción.
gatewayCardLocalBrand Enumeración=
La marca comercial que se utiliza para describir la tarjeta se reconoce y acepta dentro de su país/región de origen. La tarjeta también puede tener una marca compartida con una marca comercial que se reconoce y acepta a nivel mundial (ver gatewayCardBrand). Puede usar esta información para respaldar decisiones de recargo. Esta información se reúne desde fuentes de terceros y puede que no sea exacta en todas las circunstancias.
Existencia
Condicional
Reglas de validación
El valor debe ser miembro de la siguiente lista. Los valores distinguen entre mayúsculas y minúsculas.
BANAMEX_COSTCO
Banamex Costco (México)
CARNET
Carnet (México)
CARTE_BANCAIRE
Carte Bancaire (Francia)
ELO
Elo (Brasil)
FARMERS
Farmers Card (Nueva Zelanda)
LASER
Laser (Irlanda)
Q_CARD
Q Card (Nueva Zelanda)
SORIANA
Soriana (México)
TRUE_REWARDS
True Rewards (Nueva Zelanda)
gatewayCardFundingMethod Enumeración=
El método que utiliza el pagador para proporcionar los fondos para el pago. Puede usar esta información para respaldar decisiones de recargo. Esta información se reúne desde fuentes de terceros y puede que no sea exacta en todas las circunstancias.
Existencia
Siempre proporcionado
Reglas de validación
El valor debe ser miembro de la siguiente lista. Los valores distinguen entre mayúsculas y minúsculas.
CARGO
El pagador tiene una línea de crédito con el emisor que se debe pagar mensualmente.
CRÉDITO
El pagador tiene una línea de crédito rotativa con el emisor.
DÉBITO
Los fondos se cargan inmediatamente en la cuenta con el emisor del pagador.
DESCONOCIDO
No se pudo determinar el método de financiamiento de la cuenta.
Identificador de sesión devuelto por la respuesta de la operación APICrear Sesión. Este valor debe anexarse a la URL de Servicio de Hosted Payment Session como la acción del formulario. Por ejemplo, action="https://evopaymentsmexico.gateway.mastercard.com/form/SESSION000112345678901234567890"
Tipo
Alfanumérico
Los datos deben tener formato del tipo: "SESSION" seguido de 24 dígitos (0 a 9), por ejemplo, SESSION000112345678901234567890