集成步骤
要在您的系统中实现基本 Hosted Session 解决方案,请按照以下说明操作。
先决条件
在实施 Hosted Session 解决方案之前,请先检查 Your payment service provider 以确保您满足以下先决条件:
- 确保您有商家账户,并且您的商家配置文件已启用 Hosted Session 服务。
- 确保您使用 API v18 或更高版本。
- 选择并设置您的 API 身份验证方法。
实施 Hosted Session 集成
Hosted Session 解决方案通过 API 操作(请求和响应)发挥作用,这些操作用于管理会话以及发起或检索各项付款交易的信息(举例)。 当需要付款人参与来收集交易的付款详细信息时,您还需要 Session JavaScript 库来管理应用或网页中的托管付款单字段。 有关处理会话的更多信息,请参阅 会话基础知识。
您可以使用 REST 服务器 API 的所有可用 API 操作。 但是,您不需要与 Hosted Checkout 相关的 API 操作,仅相关的集成方法需要这些操作。
要执行操作,您必须先在您的商家配置文件上让 your payment service provider 启用此操作。 要检查哪些操作可供您使用或解决任何 API 错误,请联系 your payment service provider。 可供您使用的操作仅限于在 Mastercard Gateway 上您的商家配置文件中配置的收单行功能。 如果收单行在网关上不支持某项功能,执行该功能的任何操作请求都会被网关拒绝(针对该收单行)。
当需要付款人参与时,您使用 Hosted Session 集成方法执行的每项任务都包含以下步骤:
- 在您的服务器中,创建一个新的会话作为交易所需的所有敏感数据的容器。
- 在您的应用或网站中,将托管表单字段附加到您的付款页,并允许付款人填写这些字段。
- 在您的应用或网站中,使用提供的数据更新会话。
- 在您的服务器中,向网关发送付款交易请求,在其中引用会话。
- 在您的服务器中,检索付款交易的响应数据。 解释响应并在您的应用或网站中向付款人显示交易结果。
有关处理上述步骤 1-4 的信息,请参阅进行付款。 有关处理交易结果的信息,请参阅解释响应。
有关包含常见交易操作请求的示例请求集合,请下载 Postman 集合。
集成完成后,您可以管理基本请求和响应: