Referencia de campos de Hosted Payment Session

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.

Referencia de API de Crear sesión[REST][NVP]

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
gatewayCardSecurityCode Dí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
gatewayRedirectDisplayBackgroundColor Caracteres 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)"
valor predeterminado
#000000 (blanco)
longitud mínima
3
longitud máxima
30
gatewayRedirectDisplayTitle Alfanumérico = (OPCIONAL)
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.
Existencia
OPCIONAL
Reglas de validación
Texto
valor predeterminado
Detalles de pago enviados
longitud mínima
0
longitud máxima
255
gatewayRedirectDisplayContinueButtonText Alfanumérico = (OPCIONAL)
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 =