定制支付体验
如果您在使用 Hosted Checkout，可以自定义 Hosted Payment Page 上的信息显示，这与您的业务以及与付款人之间的交互有关系。 自定义在 INITIATE CHECKOUT 操作中定义。
您可以使用以下选项自定义付款体验：
- 显示品牌信息： 您可以使用
interaction.merchant对象中的相应字段显示徽标和联系详细信息。interaction.merchant对象中提供的字段仅显示在付款页集成的收据页上，不会显示在嵌入页面上。 - 管理付款人账单和电子邮件地址的显示： 从付款人处收集账单和电子邮件地址后，您可以通过将
interaction.displayControl.billingAddress和interaction.displayControl.customerEmail字段设置为以下值之一来显示它们并控制它们的编辑方式： - HIDE： 不显示地址。
- MANDATORY： 显示地址元素并强制付款人输入数据。
- OPTIONAL： 显示地址元素，但允许付款人选择不输入数据。
- READ_ONLY： 显示地址，但不允许付款人编辑。
- 管理送货详细信息的显示： 从付款人处收集运输详细信息后，您可以通过将
interaction.displayControl.shipping字段设置为以下值之一来控制其显示： - HIDE： 不显示运输详情。
- READ_ONLY： 显示运输详情，但不允许付款人编辑。
- 付款人不能编辑之前提供的任何运输详细信息。
- 如果未提供所需的运输详细信息，则“与运输相同”复选框的功能不可用。
- 管理语言和主题： 默认情况下， Hosted Payment Page 上显示的语言由付款人的浏览器决定。 但是，您可以通过在语言环境字段中指定语言标识符或 IETF 语言标签来覆盖此行为；例如 en_US、es 或 fr_CA。 如果网关不支持您指定的语言，则页面将以最匹配的语言显示。
- 订单 ID: 必须在您的请求中包含
order.id，以便轻松识别从 Hosted Checkout 发起的付款。 您可以使用购物车生成的识别码，也可以提供您自己的识别码。 但请确保识别码具有唯一性。
警告
有关各个字段的更多信息，请参阅 INITIATE CHECKOUT。
使用自定义详细信息的 Initiate Checkout 请求示例
| URL | https://na.gateway.mastercard.com/api/rest/version/{version}/merchant/{merchant_ID}/session |
| HTTP 方法 | POST |
{
"apiOperation": "INITIATE_CHECKOUT",
"interaction": {
"merchant": {
"name": "The Company Co",
"url": "https://www.merchant-site.com",
"logo": "https://upload.wikimedia.org/wikipedia/commons/2/21/Verlagsgruppe_Random_House_Logo_2016.png"
},
"displayControl": {
"billingAddress": "MANDATORY",
"customerEmail": "MANDATORY"
},
"timeout": 1800,
"timeoutUrl": "https://www.google.com",
"cancelUrl": "http://www.google.com",
"operation": "PURCHASE",
"style": {
"accentColor": "#30cbe3"
}
},
"billing": {
"address": {
"city": "St Louis",
"stateProvince": "MO",
"country": "USA",
"postcodeZip": "63102",
"street": "11 N 4th St",
"street2": "The Gateway Arch"
}
},
"order": {
"amount": "123.60",
"currency": "EUR",
"description": "This is the order description",
"id": "ORDER-4142773a-ac2e"
},
"customer": {
"email": "peteMorris@mail.us.com",
"firstName": "John",
"lastName": "Doe",
"mobilePhone": "+1 5557891230",
"phone": "+1 1234567890"
}
}
常见问题
对显示在付款页的文件大小和商家微标尺寸是否有限制？
文件大小或徽标宽度没有限制。 徽标高度至少应为 144 像素。
我能否使用托管提供程序来托管徽标图像？
可以，您可以在任何提供程序上托管您的徽标图像，只要 URL 是安全的 (HTTPS)。 如果您在寻找可以提供免费 HTTPS 托管的提供程序，请参见安全图像托管提供程序。