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

如何接入 LinkPay

商户可通过以下两种方式发起在线支付流程：
方式 1：商户可接入本文档中定义的 LinkPay API，获取 LinkPay 支付链接（URL），供用户访问 LinkPay 支付页面进行支付。
方式 2：商户可在 EVO Cloud Portal 上手动创建 LinkPay 支付链接，并将其发送给用户，供用户访问 LinkPay 支付页面进行支付。

LinkPay API#

商户可通过 LinkPay API 接入 LinkPay。用户可以在商户订单页面发起交易，随后重定向至 LinkPay 支付页面完成支付。
基本处理流程如下：

发起 LinkPay#

用于发起 LinkPay 的商户订单页面示例如下：
image.png
用户确认交易并点击 Check Out 按钮，打开 LinkPay 支付页面进行支付。

处理流程#

调用 LinkPay API 时，商户订单页面与 LinkPay 之间的处理流程如下：
注意：
第 8 步仅适用于商户在调用 LinkPay API（第 3 步）时发送 returnURL 的情况。支付成功处理后，LinkPay 将在 5 秒内重定向至商户页面。同时，LinkPay 会在应答中包含如下所示的 URL：
HTTPs://www.merchantweb.com/?merchantOrderID=123123123123&result=success
第 9 步仅适用于商户在调用 LinkPay API（第 3 步）时发送 webhook 的情况。支付成功处理后，EVO Cloud 会向 webhook URL 发送异步通知。
第 10 步和第 11 步仅适用于商户需要查询支付交易状态和详情的情况。
有关 API 的详细定义，请参阅本文档中的查询 LinkPay 订单。

指定 LinkPay 支付页面的语言#

通过 LinkPay API 获取 LinkPay 支付链接（URL）后，商户可以在该 URL 后附加 lang 查询参数，以指定 LinkPay 支付页面的默认显示语言。
参数名称：lang
用法：将其作为查询参数附加到 LinkPay API 返回的支付链接（URL）后。
例如，附加该参数以使用简体中文显示页面：
https://hkg-counter.everonet.com/linkpay/b5e317070048425aa78d999782b0e0d0?lang=zh-CN
注意：
参数值不区分大小写，并将规范化为受支持的语言（见下方“规范化值”列）。例如，zh-cn 和 zh 均会规范化为 zh-CN。
如果未提供该参数，或提供的值不在支持列表中，页面将回退为英语（en-US）。

支持的语言#

参数值规范化值语言
en-US / enen-US英语
zh-CN / zh-cn / zhzh-CN简体中文
zh-TW / zh-twzh-TW繁体中文
jaja日语
th / th-THth泰语
ko-KR / koko-KR韩语
lo / lo-LAlo-LA老挝语
fr / fr-FRfr-FR法语
es / es-ES / es-419es-419西班牙语（拉丁美洲）
pt / pt-PT / pt-419pt-419葡萄牙语（拉丁美洲）
ruru俄语
swsw斯瓦希里语
任何其他值en-US英语（回退语言）

通过 Portal 创建 LinkPay 支付链接#

描述#

商户也可以通过 EVO Cloud Portal 创建支付链接，使商户和用户无需商户系统或技术参与即可完成在线支付。
收到用户的交易订单后，商户可使用 EVO Cloud 分配的 ID 和密码登录 EVO Cloud Portal，以发起支付交易。
在 EVO Cloud Portal 中输入交易信息以及电子邮件地址或电话号码后，EVO Cloud 可通过电子邮件或 SMS 向用户发送由 EVO Cloud 生成的支付链接。
用户收到电子邮件或 SMS 后，可单击支付链接进入 LinkPay 支付页面并完成支付。
商户可访问 EVO Cloud Portal 查询交易状态和详情，并接收 EVO Cloud 提供的相关交易报告。

处理流程#

通过 EVO Cloud Portal 发起 LinkPay 时，商户、用户、EVO Cloud Portal 与 LinkPay 之间的基本流程如下：

Portal 操作流程#

进入 everonet 平台首页，在 LinkPay 菜单下有 LinkPay Orders 和 LinkPay Templates 两个模块
image.png

LinkPay 模板#

在 LinkPay Templates 模块下，可以查看 LinkPay 支付模板，并可在顶部执行筛选、搜索和新增模板操作。
image.png
在模板右侧，可以执行停用、启用和删除操作。仅当模板处于停用状态时，才能执行删除操作。
image.png
单击 Templates ID 可查看模板详情。然后，单击右上角的编辑按钮修改模板内容。
image.png
在新增页面中，需要填写模板信息，包括名称、适用范围、类型，以及由谁填写用户相关信息。
image.png
完成并保存模板信息后，在为该门店创建 LinkPay 订单时，可以选择此模板。

LinkPay 订单#

在 LinkPay Order 列表中，可以将订单导出为 CSV 或 Excel。
image.png
单击订单 ID 可查看订单详情。订单状态显示在右上角。如果状态为 "Paid"，可以在下方查看相关交易。
image.png
如果订单类型为多笔支付，则相关交易中可能存在多笔交易。
20250626-141414.png
查看支付失败的交易详情时，可以看到支付失败响应码，并可通过该响应码查询失败原因。
image.png
如果订单状态为 "Unpaid"，可以重新向客户发送付款邮件通知。
image.png
新增 LinkPay 订单时，必须选择门店。
image.png
如果门店配置了模板，则在选择门店后，需要选择要使用的模板。
image.png
选择模板后，需要填写订单信息，并根据模板要求提供必填的用户信息。
image.png
根据 LinkPay 模板要求，如果客户信息需要由员工填写，则创建订单时该字段为必填；如果无需填写或由客户填写，则不会显示该字段；如果员工可选择填写，则该字段为可选。
image.png
20250625-101107.png
image.png
在订单创建页面底部，输入用户姓名和电子邮件地址后，可以选择发送订单创建提醒邮件。该邮件会提醒用户单击邮件中的链接进行支付。
image.png
创建订单时，输入客户姓名和电子邮件地址并选择电子邮件通知后，客户将收到付款提醒邮件。如果未选择电子邮件通知，客户将不会收到该邮件。

LinkPay 退款#

在交易详情页面中，可以在右上角执行退款操作。
image.png
可以填写退款金额和退款说明。
image.png

LinkPay 接入选项#

根据所选 API，商户可以通过不同方式接入 LinkPay。
选项 1选项 2选项 3选项 4
所选 API- N/A- LinkPay API- LinkPay API
- 查询 LinkPay 订单 API
- 异步通知		- LinkPay API
- 查询 LinkPay 订单 API
- 异步通知
- 退款 API
如何创建支付订单- EVO Cloud Portal- API "LinkPay"- API "LinkPay"- API "LinkPay"
如何获取支付结果- EVO Cloud Portal- 异步通知
- EVO Cloud Portal		- 异步通知
- 查询 LinkPay 订单 API
- EVO Cloud Portal		- 异步通知
- 查询 LinkPay 订单 API
- EVO Cloud Portal
如何退款- EVO Cloud Portal- EVO Cloud Portal- EVO Cloud Portal- 退款 API
- EVO Cloud Portal
如果商户希望通过异步通知接收支付结果，则在创建 LinkPay 订单并请求 LinkPay 支付链接时，需要发送 webhook 地址。
商户可通过查询 LinkPay 订单 API 或异步通知获取支付结果及相关交易信息。
上一页
商户入网
下一页
签名与报文头
Built with