线上H5支付 FunctionCode | 暂无

提供全场景线上支付服务，支持支付宝、微信支付、银联等多渠道

简介

提示

我是一个特殊说明

接口说明

• 请求方式 POST
• Headers serviceCode: xxx
• Headers Content-Type: application/json
• Headers Authorization: Bearer ${app_token}

正式环境	测试环境
https://api.linkingopen.com/service/openapicore/gateway	https://api.linkingopen.com/test/service/openapicore/gateway

请求参数

名称	描述	类型	必填
out_trade_no	外部订单号，32位字符以内，需确保唯一性	String	是
total_amount	交易的订单金额，单位为元，精确到小数点后两位，取值范围[0.01, 100000000]	Price	是
subject	订单标题，用于展示在支付页面（建议简明扼要）	String	是
body	订单详细描述，可包含商品规格、数量等信息	String	否
timeout_express	订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d（m-分钟，h-小时，d-天）	String	否
return_url	支付成功后跳转回商户的页面地址	String	否
notify_url	支付结果异步通知接收地址，用于更新订单状态	String	否
disable_pay_channels	禁用支付渠道（如 credit_group 表示禁用信用卡相关支付）	String	否
business_params	订单扩展信息，以 JSON 格式传递自定义参数（如备注、业务编码）	business_params	否
agreement_sign_params	支付签约场景使用的扩展参数（如签约协议内容）	agreement_sign_params	否
withholding_id	代扣签约编号，36位字符以内，唯一标识签约关系	String	是
withholding_notify_url	签约结果异步通知接收地址，用于确认签约状态	String	是
order_type	业务类型（枚举值：APPOINTMENT=挂号，TREATMENT=门诊缴费，HOSPITALIZATION=住院等）	String	是

请求参数 agreement_sign_params

名称	描述	类型	必填
withholding_id	代扣签约编号，36位字符以内，唯一标识签约关系	String	是
withholding_notify_url	签约结果异步通知接收地址，用于确认签约状态	String	是

返回参数

名称	描述	类型	必填
sub_code	业务返回码，例如 TRADE_HAS_SUCCESS 表示交易已成功	String	否
sub_msg	业务返回码对应的描述信息，这里表示交易已被支付	String	否
goto_url	需跳转的 URL 地址	String	是

接口示例

参数示例

以下是JSON：

• VitePress 站点位于项目的 docs 目录中。
• 你使用的是默认的生成输出目录 （.vitepress/dist）。
• VitePress 作为本地依赖项安装在项目中，并且你已在 package.json 中设置以下脚本：

请求参数

{
        "out_trade_no": "CS20250318141930XXXXXXXX",
        "total_amount": "100.00",
        "subject": "挂号付费",
        "return_url": "https://fwcbj.linkingcloud.cn/app/unattended/index.html#/outpatientService/guahao/detail?outTradeNo=CS20250318141930XXXXXXXX&dataSource=guahaoConfirm",
        "notify_url": "https://XXXXXXXXXXXXXXXXXX",
        "user_id": "",
        "disable_pay_channels": null,
        "order_type": "APPOINTMENT",
        "order_info": ""
    }

返回参数

 {
        "goto_url": "https://openapi.linkingcloud.cn/p/XXXXXXXXXXXXXX"
    }

SDK示例

Java

public class SDKExample {
    public static void main(String[] args) {
        // Java示例：初始化SDK并调用一个方法
        SDK sdk = new SDK();
        sdk.initialize();
        sdk.processImage("image.jpg");
    }
}

.NET

using System;

public class SDKExample {
    public static void Main() {
        // .NET 示例：初始化SDK并调用方法
        SDK sdk = new SDK();
        sdk.Initialize();
        sdk.ProcessImage("image.jpg");
    }
}

Node

async function runExample() {
    // Node.js 示例：初始化SDK并调用异步方法
    const sdk = new SDK();
    await sdk.initialize();
    await sdk.processImage('image.jpg');
}

常见业务状态码

错误码	描述	解决方案
SYSTEM_ERROR	系统繁忙	服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
APP_NOT_ONLINE	小程序未处于上架状态	小程序上架状态再操作