Implementación de una Integración de Hosted Payment Page
El modelo de Hosted Payment Page le permite recopilar detalles de pago de su pagador a través de una página web hospedada y que aparece en American Express Payment Gateway, gestionando así la seguridad y el cumplimiento de PCI por usted. Con este modelo de integración, nunca verá ni manejará los detalles de pago directamente porque los detalles de pago recopilados en la página de pago se envían directamente desde el explorador del pagador al American Express Payment Gateway.
Solicitar una página de pago
Usted solicita la Hosted Payment Page al enviar una solicitud de HTTPS POST al American Express Payment Gateway. Este es un paso crítico en la integración del negocio, puesto que los datos de la solicitud determinan el contenido que se muestra al pagador en la página de pago.
La solicitud HTTPS POST puede contener cualquiera de los campos descritos en la Hosted Payment PageReferencia de API. Asegúrese de incluir todos los campos obligatorios en su solicitud.
A continuación se muestra un código de muestra para una integración Hosted Payment Page básica:
<form method="post" action="https://gateway-na.americanexpress.com/api/page/version/36/pay">
<input type="hidden" name="merchant" value="<your_merchant_id>"/>
<input type="hidden" name="order.amount" value="100.00"/>
<input type="hidden" name="order.currency" value="USD"/>
<input type="hidden" name="order.description" value="37 Blue Widgets"/>
<input type="hidden" name="interaction.merchant.name" value="My Merchant Name"/>
<input type="hidden" name="interaction.cancelUrl" value="http://www.mymerchant.com"/>
<input type="submit" value="Checkout"/>
</form>
Apunte interaction.cancelUrl a una URL a la que desea que el explorador del pagador se redireccione si cancela su pago. Esto podría ser un vínculo al carrito de compras del pagador o a la página de inicio del sitio de su tienda.
Se recomienda que incluya el campo order.id en su solicitud para identificar fácilmente un pago iniciado desde la Hosted Payment Page. Puede utilizar un identificador generado por su carrito de compras o proporcionar el suyo propio; sin embargo, asegúrese de que sea único. Si no se proporciona un valor en el campo order.id, el American Express Payment Gateway generará uno automáticamente.
Prueba de su integración
Antes de iniciar transacciones en producción, debe probar su integración para garantizar una funcionalidad correcta.