实施 Hosted Payment Page 集成
此页面记录了一项遗留功能。 Hosted Payment Page 协议已被 Hosted Checkout JavaScript 集成弃用。 有关如何获取付款结果以及进一步定制集成的更多信息,请参阅 Hosted Checkout 页面。
该 Hosted Payment Page 模型允许您通过由 Mastercard Gateway托管和显示的网页从付款人处收集付款详细信息,从而为您管理安全性和 PCI 合规性。 使用此集成模型,您永远不会直接看到或处理付款详细信息,因为在付款页收集的付款详细信息从付款人浏览器直接提交到 Mastercard Gateway。
请求付款页面
您可以通过将 HTTPS POST 请求发送到 Mastercard Gateway 来请求 Hosted Payment Page。 此步骤对于商家集成至关重要,因为您的请求中的数据决定了付款页上向付款人显示的内容。
HTTPS POST 请求可以包含 Hosted Payment Page API 参考中介绍的任何一个字段。 请确保您的请求中包含所有必填字段。
基本 Hosted Payment Page 集成的示例代码如下所示:
<form method="post" action="https://na-gateway.mastercard.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>
指向 interaction.cancelUrl 一个 URL,当付款人取消付款时,您希望付款人的浏览器重定向到该 URL。 这可以是返回付款人购物车的链接,也可以是您的购物网站主页的链接。
建议您在请求中包含 order.id 字段,以便轻松识别从 Hosted Payment Page 发起的付款。 您可以使用购物车生成的标识符或提供您自己的标识符;但是,请确保它是唯一的。 如果您没有在 order.id 字段中提供值, Mastercard Gateway 将自动为您生成一个。
默认情况下,您的商家配置决定了在付款页上向付款人提供的功能。 例如,付款方式(信用卡、PayPal 等)、交易来源(互联网、呼叫中心等)、付款选项(付款方案)、3-D 安全服务、风险管理等。
测试您的集成
在投入使用前,您必须测试您的集成以确保功能正确。