医加云·开放平台

主题

聚合支付 FunctionCode | 暂无 ​

提供自助机扫码聚合支付服务，该服务通过集成支付宝、微信支付、银联二维码、数字人民币等主流支付方式，用户只需使用手机扫码或展示付款码，即可完成自助交易。

简介 ​

alt text

接口说明 ​

  • 请求方式 POST
  • Headers serviceCode: xxx
  • Headers Content-Type: application/json
  • Headers Authorization: Bearer ${app_token}
正式环境 测试环境
https://api.linkingopen.com/service/openapicore/gatewayhttps://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-天，1c-当天）String否
payment_type支付方式，支持支付宝、微信、银联、数字人民币等（枚举值：alipay/weixin/unionpay/eshimin/elecny）String是
notify_url异步通知接收地址，用于接收支付结果回调String否
operator_id商户操作员编号，用于区分不同操作员String否
terminal_id商户机具终端编号，用于区分不同设备String否
disable_pay_channels禁用支付渠道（如 credit_group 表示禁用信用卡相关支付）String否
business_params订单扩展信息，以 JSON 格式传递自定义参数（如备注、业务编码）business_params否
order_type业务类型（枚举值：APPOINTMENT=挂号，TREATMENT=门诊缴费，HOSPITALIZATION=住院等）String否

返回参数 ​

名称 描述 类型 必填
sub_code业务返回码（枚举值：如 TRADE_HAS_SUCCESS 表示交易已成功）String否
sub_msg业务返回码的具体描述（如“交易已被支付”）String否
out_trade_no外部订单号，32位字符以内，需确保唯一性String是
qr_code预下单生成的二维码码串，用于生成支付二维码（示例值为支付宝二维码链接）String是

接口示例 ​

参数示例 ​

以下是JSON：

  • VitePress 站点位于项目的 docs 目录中。
  • 你使用的是默认的生成输出目录 （.vitepress/dist）。
  • VitePress 作为本地依赖项安装在项目中，并且你已在 package.json 中设置以下脚本：
json
{
        "timeout_express": "2m",
        "terminal_id": "",
        "total_amount": "0.01",
        "order_type": "TREATMENT",
        "subject": "医疗费",
        "out_trade_no": "CS20250318115500XXXXXXX",
        "operator_id": "",
        "body": "",
        "payment_type": "alipay",
        "notify_url": "",
        "disable_pay_channels": ""
    }
json
  {
        "out_trade_no": "CS20250318115500XXXXXXX",
        "qr_code": "https://qr.alipay.com/XXXXXXXXX"
    }

SDK示例 ​

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

public class SDKExample {
    public static void Main() {
        // .NET 示例：初始化SDK并调用方法
        SDK sdk = new SDK();
        sdk.Initialize();
        sdk.ProcessImage("image.jpg");
    }
}
Js
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小程序未处于上架状态小程序上架状态再操作