1. 接入指南
Linkpay API
  • 接入指南
    • LinkPay 概述
    • LinkPay 工作原理
    • 商户入网
    • 如何接入 LinkPay
    • 签名与报文头
    • 定制化服务
    • 支付方式列表
    • 支付方式细分类型列表
    • 响应码
    • 版本记录
    • Agent Toolkit 概述
    • Agent Toolkit 快速入门
  • API
    • 下载 OpenAPI 规范文件
    • LinkPay
      • 响应码
      • LinkPay
    • 查询 LinkPay 订单
      • 响应码
      • 查询 LinkPay 订单
    • 退款
      • 响应码
      • 退款
    • 查询 LinkPay 退款
      • 响应码
      • 查询 LinkPay 退款
    • 异步通知
      • 响应码
      • LinkPay 支付结果通知
      • 退款结果通知
      • 撤销结果通知
    • 关单
      • 关单
  1. 接入指南

LinkPay 工作原理

在 LinkPay 上发起支付交易#

本章介绍如何在 LinkPay 上发起支付交易，以及 LinkPay 如何通过 EVO Cloud 和 PSP 处理交易。

前往 LinkPay 支付页面#

通过 API 调用或支付链接提交详细订单信息后，用户网页可重定向至如下所示的 LinkPay 支付页面。用户需要选择银行卡支付或钱包支付。
image.png
注意：
LinkPay 界面中有三个可定制元素，分别对应上图中的位置 1、2 和 3。每个位置的定制方式各不相同：
位置 1：商户 Logo，由商户提供。收单机构可在 EVO Cloud Portal 中为商户启用 Checkout (LinkPay) 功能时上传该 Logo。
位置 2：商户名称，此处内容与 EVO Cloud Portal 中设置的“Store Name”一致。
位置 3：收单机构名称，此处内容与 EVO Cloud Portal 中的“Acquirer English Name”一致。该名称可由收单机构定义，并由 CIL 运营团队设置。
有关元素定制的详细信息，请参阅《EVO Cloud Portal User Manual》。

银行卡支付流程#

如果用户希望使用信用卡或借记卡支付，则需要在 LinkPay 支付页面填写银行卡信息。
截图如下：
如果创建 LinkPay 订单时设置了 User Reference 和 Vault ID，页面上将显示“Save card details for next time”复选框。
image.png
如果用户在上一次支付时选择了“Save card details for next time”，则下次支付时，用户将在 LinkPay 中看到已保存的银行卡，并可直接使用该银行卡付款。
image.png
根据 EVO Cloud 中配置的卡组织和收单机构，交易可能需要进行 3DS 认证，用户将被重定向至 3DS 认证页面。
3DS 认证页面的示例截图如下：
image.png
完成认证后，LinkPay 将返回以下支付页面并显示支付结果。
image.png

LinkPay 支付页面后端处理流程#

对于银行卡支付交易，LinkPay 后端在 PC 端和移动端的处理流程相同。以下是 LinkPay 中不含 3DS 流程的银行卡支付交易流程图。
以下是 LinkPay 中包含 3DS 流程的银行卡支付交易流程图。
此图说明了 LinkPay 支付页面的处理流程；商户与 LinkPay 之间的交互详见如何接入 LinkPay

Alipay 交易流程#

PC 网页端用户旅程#

使用网页浏览器打开 LinkPay 支付链接，选择“Alipay”，然后点击“Continue”。
image.png
浏览器将显示 Alipay 支付二维码，用户需要使用 Alipay 钱包扫描二维码以完成支付。
image.png
支付完成后将显示支付成功页面。
image.png

移动端 WAP 用户旅程#

在手机上打开 LinkPay 支付链接，并继续选择支付方式。
选择“Alipay”进行支付。
浏览器将唤起用户手机上的 Alipay APP。
用户在 Alipay APP 中完成支付后，将显示支付成功页面。
image.pngimage.pngimage.pngimage.pngimage.png

LinkPay 支付页面后端处理流程#

对于 Alipay，LinkPay 后端在 PC 端和移动端的处理流程相同。以下是 LinkPay 中的 Alipay 处理流程图。
此图说明了 LinkPay 支付页面的处理流程；商户与 LinkPay 之间的交互详见如何接入 LinkPay

AlipayHK 交易#

PC 网页端用户旅程#

使用网页浏览器打开 LinkPay 支付链接，选择“AlipayHK”，然后点击“Continue”。
image.png
页面将立即弹出 AlipayHK 二维码供用户支付。用户需要使用 AlipayHK APP 扫描二维码以完成支付。
image.png
支付完成后将显示支付成功页面。
image.png

移动端 WAP 用户旅程#

在手机上打开 LinkPay 支付链接，并继续选择支付方式。
选择“AlipayHK”进行支付。
浏览器会将用户重定向至 Alipay 托管的支付页面以完成支付。
用户在 Alipay 页面完成支付后，将显示支付成功页面。
image.pngimage.pngimage.pngimage.png

LinkPay 支付页面后端处理流程#

对于 AlipayHK，LinkPay 后端在 PC 端和移动端的处理流程不同。以下是 PC 端的 AlipayHK 处理流程图。
以下是移动端的 AlipayHK 处理流程图。
此图说明了 LinkPay 支付页面的处理流程；商户与 LinkPay 之间的交互详见如何接入 LinkPay

WeChat Pay 交易#

PC 网页端用户旅程#

使用网页浏览器打开 LinkPay 支付链接，选择“WeChat Pay”，然后点击“Continue”。
image.png
页面将立即弹出 WeChat 二维码供用户支付。
image.png
支付完成后将显示支付成功页面。
image.png

移动端 WAP 用户旅程#

商户必须向 WeChat 申请开通 H5 支付。
在手机上打开 LinkPay 支付链接，点击“Checkout”按钮以选择支付方式。
选择“WeChat”。
浏览器将唤起用户手机上的 WeChat APP。
用户在 WeChat APP 中完成支付后，将显示支付成功页面。
image.pngimage.pngimage.pngimage.pngimage.png

LinkPay 支付页面后端处理流程#

对于 WeChat Pay，LinkPay 后端在 PC 端和移动端的处理流程不同。以下是 PC 端的 WeChat Pay 处理流程图。
以下是移动端的 WeChat Pay 处理流程，包括以下两种支付场景。
a.WeChat H5 支付：WeChat Pay 用户访问商户 H5 网站，并在移动浏览器中完成支付。
b.WeChat 公众号支付：WeChat Pay 用户访问商户移动网站，并在 WeChat 内置浏览器或 WeChat 公众号中完成支付。
此图说明了 LinkPay 支付页面的处理流程；商户与 LinkPay 之间的交互详见如何接入 LinkPay

Octopus 交易#

PC 网页端用户旅程#

使用网页浏览器打开 LinkPay 支付链接，选择“Octopus”，然后点击“Continue”。
浏览器会将用户重定向至 Octopus 托管的支付页面以完成支付。
用户需要使用 Octopus APP 扫描二维码或输入付款码以完成支付。
image.png
WEB-2.pngWAP-8_1.jpegWEB-3-2.png
支付完成后将显示支付成功页面。
image.png

移动端 WAP 用户旅程#

在手机上打开 LinkPay 支付链接，并继续选择支付方式。
选择“Octopus”进行支付。
浏览器会将用户重定向至 Octopus 托管的支付页面以完成支付，然后用户选择“Tap to Pay”以唤起 Octopus APP。
用户在 Octopus 页面完成支付后，将显示支付成功页面。
WAP-1_1.jpegWAP-2_1.jpegWAP-3_1.jpegWAP-4-EN_1.jpegWAP-6_1.jpegWAP-7_1.jpegWAP-8_1.jpegWAP-9_1.jpegWAP-10_1.jpeg

LinkPay 支付页面后端处理流程#

对于 Octopus，LinkPay 后端在 PC 端和移动端的处理流程不同。
以下是 PC 端的 Octopus 处理流程图。
以下是移动端的 Octopus 处理流程图。

一键绑卡#

PC 网页端用户旅程#

创建 LinkPay 订单时，选择“Single Payment”作为订单类型，并在订单信息中填写 User Reference 和 Vault ID。
image.png
使用网页浏览器打开 LinkPay 支付链接，输入银行卡号。
输入正确的银行卡号后，系统将要求您继续输入银行卡有效期、安全码和持卡人姓名。
image.png
您可以选择保存银行卡信息，以便下次使用。
image.png
再次进入交易页面时，您可以直接使用之前保存的银行卡进行支付。
image.png
同时，您可以选择使用其他银行卡，并以相同方式保存。您也可以删除当前保存的银行卡信息。

移动端网页用户旅程#

在手机上打开 LinkPay 支付链接，并继续选择支付方式。
输入银行卡号后，您可以选择保存信息以便下次使用，系统还将要求您填写有效期、安全码及其他信息。
保存信息后，下次进入页面时，您可以选择已保存的银行卡进行支付，也可以删除现有银行卡信息或使用其他银行卡支付。

LinkPay 订单多次支付功能#

PC 网页端用户旅程#

点击跳转至 LinkPay 使用流程

用户在 PC 页面上的支付旅程#

客户收到电子邮件后，可点击邮件中的支付链接进行支付操作。
image.png
在支付界面中，用户需要根据 LinkPay 模板要求填写相应信息。
image.png
右侧显示员工创建订单时输入的信息，包括商品描述、订单号、到期日期、价格等。
image.png
如果模板要求客户填写账单地址和配送地址，则填写信息时，账单地址与配送地址默认相同。如果实际地址不同，客户需要点击“Specify a separate delivery address”创建单独的配送地址，从而区分这两个地址。
image.png
完成并核实信息后，即可进入支付方式选择界面。与上一个界面相比，右侧会显示客户填写的信息，以供再次核实。用户可在此界面选择所需的支付方式。
image.png
选择支付方式并填写相应信息后，用户可点击支付按钮完成支付。
image.png
支付结果可能为支付成功、支付失败或订单超时等。
image.png
image.png
image.png

独立绑卡#

PC 网页端用户旅程#

使用网页浏览器打开 LinkPay 支付链接，选择“Credit or Debit Card”，然后点击“Add Card”。
image.png
根据 EVO Payment 中配置的卡组织和收单机构，可能需要进行 3DS 认证，用户将被重定向至 3DS 认证页面。3DS 认证页面的示例截图如下：
image.png
完成认证后，LinkPay 将返回以下结果页面并显示绑卡结果。
image.png
上一页
LinkPay 概述
下一页
商户入网
Built with