- Pautas de integración
- Implementación de una integración de Hosted Payment Session
- Crear un formulario de pago
Crear un formulario de pago
Crear y enviar el formulario son pasos críticos en la integración del negocio para un modelo de Hosted Payment Session. Los campos del formulario orientado al pagador, incluidos los detalles de la tarjeta y otra información adicional, se envían directamente al Hosted Payment Session Servicio mediante HTTPS POST.
Cómo crear un formulario de pago
El formulario de pago puede contener cualquiera de los campos descritos en la sección Referencia de campos de formulario más cualquier campo adicional que desee utilizar para solicitar información al pagador.
A continuación se muestra un formulario de pago HTML de muestra que recopila todos los detalles de la tarjeta:
<form action="https://eu-gateway.mastercard.com/form/<session_id>" method="post">
<input type="hidden" name="gatewayReturnURL" value="http://www.example.com/example"/>
Card Number: <input type="text" name="gatewayCardNumber" value="" size="16" maxlength="30"/>
Card Expiry Month: <input type="text" name="gatewayCardExpiryDateMonth" value="" size="2" maxlength="2"/>
Card Expiry Year: <input type="text" name="gatewayCardExpiryDateYear" value="" size="4" maxlength="4"/>
Card Security Code: <input type="text" name="gatewayCardSecurityCode" value="" size="4" maxlength="4"/>
<input type="hidden" name="gatewayRedirectDisplayBackgroundColor" value="#808000"/>
<input type="hidden" name="gatewayRedirectDisplayTitle" value="Check Your Submitted Payment Details"/>
<input type="hidden" name="gatewayRedirectDisplayContinueButtonText" value="Click to Continue"/>
<input type="submit" value="Continue"/>
</form>
Donde:
<session_id>= por ejemplo,SESSION000112345678901234567890: el identificador de sesión recibido cuando se creó la sesión de pago en el paso Create Session.http://www.example.com/example- La página de su sitio web a la que se debe redirigir al pagador. Los datos del pagador se incluirán como POST en esta dirección después de que el Servicio de Hosted Payment Session haya actualizado la sesión y aplicado la validación o el enmascarado a los valores originales.
Abra su formulario de pago en un explorador. Con el formato, debería verse así:
El formulario de pago debe enviarse mediante HTTPS POST como se muestra en el formulario anterior. El POST se envía directamente al Servicio de Hosted Payment Session.
Cómo recopilar detalles parciales mediante un formulario de pago
Es posible que no desee recopilar todos los detalles de tarjeta con Hosted Payment Session. Por ejemplo, es posible que solo desee recopilar el código de seguridad de tarjeta para poder usarlo en combinación con una tarjeta previamente almacenada (consulte Tokenization).
A continuación se muestra un formulario de pago HTML de muestra que recopila únicamente el código de seguridad de tarjeta:
<form action="https://eu-gateway.mastercard.com/form/<session_id>" method="post">
<input type="hidden" name="gatewayReturnURL" value="http://www.example.com/example"/>
Card Security Code: <input type="text" name="gatewayCardSecurityCode" value="" size="4" maxlength="4"/>
<input type="hidden" name="gatewayRedirectDisplayBackgroundColor" value="#808000"/>
<input type="hidden" name="gatewayRedirectDisplayTitle" value="Check Your Submitted Payment Details"/>
<input type="hidden" name="gatewayRedirectDisplayContinueButtonText" value="Click to Continue"/>
<input type="submit" value="Continue"/>
</form>
Notas
name, ni configure el nombre con otra cosa que no sea “submit”.
No use
<input type="submit" name="submit" value="Continue"/>
Use
<input type="submit" value="Continue"/>