拉卡拉开放平台
数字支付解决方案
──
 ^{最新版本 Ver 1.0}


拉卡拉支付集团
版权所有，盗版必究

接入说明

本章内容为拉卡拉数字支付开放平台的接入公用说明。

对于任何想要获得拉卡拉数字支付相关能力的机构、商户和个人，如目前尚无项目经理与您进行对接，请联系我司邮箱 dcdp@lakala.com 。

原拉卡拉智能终端开放平台接入的客户，请点击此处访问相关内容。

测试环境地址：https://test.wsmsd.cn/sit/ 生产环境地址：https://s2.lakala.com/

拉卡拉会分配给对接方一个appId 获取拉卡拉公钥 测试环境：https://test.wsmsd.cn/sit/gw/pubcerts?appId=xxx 生产环境：https://s2.lakala.com/gw/pubcerts?appId=xx

各类接口地址

labs主扫支付url：https://test.wsmsd.cn/sit/labs/txn/labs_order_pre_orderpay labs关单url：https://test.wsmsd.cn/sit/labs/txn/labs_order_close labs被扫支付url：https://test.wsmsd.cn/sit/labs/txn/labs_order_micropay labs退款url：https://test.wsmsd.cn/sit/labs/txn/labs_order_refund labs动态码url：https://test.wsmsd.cn/sit/labs/txn/labs_dycode_create labs订单查询url：https://test.wsmsd.cn/sit/labs/txn/labs_order_query 订单结算url：https://test.wsmsd.cn/sit/mrss/ledger/settle_ledger 结算结果查询url：https://test.wsmsd.cn/sit/mrss/ledger/settle_result_query

安全统一接入规范

请求到api网关的签名

Header中传送下列值

Authorization: 认证类型 签名信息 如

请求网关的Header处理

xxxxxxxxxx
2
1
Authorization: “LKLAPI-SHA256withRSA appid=”${appid}”,serial_no=”${serialNo}”,timestamp=”${timeStamp}”,nonce_str=”${nonceStr}”,signature=”${signature}”“
2
​

其中 LKLAPI-SHA256withRSA 表示拉卡拉安全接入签名加密方式，如果有对称加密，如 LKLAPI-SHA256withRSA-AES128、 LKLAPI-SHA256withRSA-RC4

格式如：LKLAPI-{签名方式}-{加密方式} 如果仅是MD5加签，则写成 LKLAPI-MD5 如无签名加密，则写成 LKLAPI 不存在就为空 ， 如仅仅使用3DES加密，则写成 LKLAPI–3DES

目前传统与智能终端是RSA1024签名方式则为 LKLAPI-SHA1withRSA

其中字段意义：

• appid=${appid} 机构或渠道接入申请的appid【必传】
• serial_no=${serialNo} 接入方加签用的证书序列号【有签名需要时必传】
• timestamp=${timeStamp} 接入方交易请求发起的系统时间（秒） long timestamp = System.currentTimeMillis()/1000【必传】
• nonce_str=${nonceStr} 12个字符的随机字符串【必传】

产生签名值signature的签名串拼接一共有5行，每一行为一个参数。行尾以\n（换行符，ASCII编码值为0x0A）结束，包括最后一行。如果参数本身以\n结束，也需要附加一个\n。

${appid}\n

${serialNo}\n ——存在则需要，不存在仅仅保留这个换行符\n

${timeStamp}\n

${nonceStr}\n

请求报文主体${body}\n

签名后的二进制值通过base64无76字符换行的方式进行传送 String signature = new String(Base64.encodeBase64(sign)) //不需要进行76字符换行

伪代码如

请求网关的签名伪代码

xxxxxxxxxx
4
1
String preSignData=${appId}+”\n”+${serialNo}+”\n”+${timestamp}+”\n”+${nonce_str} +”\n”+${body} +”\n”
2
byte [] signature = Base64.decodeBase64(map.get(“signature”))
3
log.info(“准备验签名的数据：\n{}”, preSignData);
4
boolean isSignOK = SecureUtils.verify(map.get(“signAlgorithm”), preSignData.getBytes(“utf-8”), accessDTO.getOrgPublicKey(), signature);

其中产生的签名用base64非76字符换行方式送出

拉卡拉响应签名

响应的Header信息包括：

• 原始送上来的Lklapi-Appid
• 拉卡拉证书序列号Lklapi-Serial， api网关给的公钥证书序列号【详见下面接口返回】 ——存在则需要
• 时间戳Lklapi-Timestamp
• 请求随机串Lklapi-Nonce
• 签名值Lklapi-Signature

其中，产生签名值Lklapi-Signature的签名串拼接一共有5行，每一行为一个参数。行尾以\n（换行符，ASCII编码值为0x0A）结束，包括最后一行。如果参数本身以\n结束，也需要附加一个\n。

${appid}\n ——存在则需要，不存在仅仅保留这个换行符\n

${serialNo}\n ——存在则需要，不存在仅仅保留这个换行符\n

${timeStamp}\n

${nonceStr}\n

响应报文主体${body}\n

伪代码如：

拉卡拉响应伪代码

xxxxxxxxxx
13
1
String nonce_str = com.lakala.sequence.utils.RandomUtils.generateString(12)
2
long timestamp = System.currentTimeMillis()/1000
3
String serialNo = accessDTO.getCertiSerial().split(EdgeConstants.MARK_COMMA)[0]
4
String preSignData=${appId}+”\n”+${serialNo}+”\n”+${timestamp}+”\n”+${nonce_str} +”\n”+${body} +”\n”
5
log.info(“准备验签名的数据：\n{}”,preSignData);
6
byte[] sign = SecureUtils.sign(context.get(“signAlgorithm”), preSignData.getBytes(“utf-8”), accessDTO.getPrivateKeyMap().get(serialNo))
7
String signature = new String(Base64.encodeBase64(sign)) //不需要进行76字符换行
8
Headers headers = zuulMessage.getHeaders()
9
headers.set(“Lklapi-Appid”, appId)
10
headers.set(“Lklapi-Serial”, serialNo)
11
headers.set(“Lklapi-Nonce”, nonce_str)
12
headers.set(“Lklapi-Timestamp”, String.valueOf(timestamp))
13
headers.set(“Lklapi-Signature”, signature)

注：对称加密传输时，默认采用AES-256的 CBC模式 AES/CBC/PKCS5Padding 初始向量16字节的 0x00

返回response：

接入流程

Demo文件下载

1. 签名验签参考OpenplatformDemo.java文件
2. 具体请求服务参考HandlerBusiDemo.java文件

附件

openplatformSDK.rar

证书生成指引

方式1

使用openssl工具来生成公私钥 将生成的公钥证书发给拉卡拉进行配置 参考文档：https://blog.csdn.net/bbwangj/article/details/82503675

方式2

此方式生成的私钥不是PEM格式，使用此方式生成证书请参考本页代码，不要使用DEMO代码。

访问https://getacert.com/ 点击Generate self-signed Certificate

输入公司名、城市、国家等相关信息，有效期可自行选择

确认信息后提交

生成4个文件，下载公钥证书和P12文件，私钥文件和CSR文件不需要下载，公钥证书请发送给拉卡拉对接人员，P12文件请妥善保存。如发生丢失作废失效等情况可以重新申请新证书并发送给拉卡拉。

签名代码如下： 别名需要修改成生成证书时候填写的公司名称，密码统一为password无需修改；

证书签名代码示例

xxxxxxxxxx
14
1
    String data = "testinfo";   //需要签名的信息
2
    String p12Filename = "resource/lakala.p12";  //证书名称，请修改为相应文件地址
3
    String alias = "lakala";    //生成证书时候填写的Hostname
4
    String pwd = "password";    //证书密码，统一为password无需修改
5
​
6
    InputStream is = new FileInputStream(p12Filename); //生成p12文件输入流
7
    Signature s = Signature.getInstance("SHA256WithRSA");  //生成签名对象
8
    KeyStore ks = KeyStore.getInstance("PKCS12");  //生成P12对象
9
    ks.load(is, pwd.toCharArray());    //从p12文件流中读取密钥
10
    PrivateKey pri = (PrivateKey)(ks.getKey(alias, pwd.toCharArray()));    //获取私钥
11
    s.initSign(pri);    //设置私钥
12
    s.update(data.getBytes());    //设置需要签名的数据
13
    byte[] sign = s.sign();        //签名
14
    String signStr = Base64.getEncoder().encodeToString(sign);    //生成Base64格式的签名

下载测试证书 生产验签证书请从拉卡拉对接人员处获取。 验签代码如下

验签代码示例

xxxxxxxxxx
8
1
    String certFilename = "resource/lkl-apigw-v1.cer";    //拉卡拉提供的证书名称,请根据实际位置修改路径
2
    CertificateFactory cf = CertificateFactory.getInstance("X.509");    //生成X509格式证书工厂
3
    InputStream ci = new FileInputStream(certFilename);        //创建证书文件输入流
4
    Certificate cert = cf.generateCertificate(ci);        //从证书文件流中读取证书
5
    Signature signature = Signature.getInstance("SHA256WithRSA");  //生成签名对象
6
    signature.initVerify(cert);        //设置验签证书
7
    signature.update(data.getBytes());        //设置需要验证签名的数据
8
    boolean result = signature.verify(sign);    //验签

附件

• lkl-apigw-v1-test.cer.rar

交易接口

公共参数说明

接口文档中，必选栏目：M 必须，C 可选

交易接口说明

访问URL说明

交易接口公共请求参数

termExtInfo字段说明

termBaseStation、termLoc、termIp三者必须上送一个

交易接口公共响应参数

主扫支付（C扫B）接口

包括：jsapi/natvie/H5/APP/小程序。其中微信NATIVE已废弃

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_order_pre_orderpay 生产环境：https://s2.lakala.com/labs/txn/labs_order_pre_orderpay

主扫支付请求参数

主扫支付请求参数：extendParams字段说明

响应参数

主扫支付响应参数

JSAPI支付

（transType=51）

主扫JSAPI支付响应参数：payMode=WECHAT 时返回

主扫JSAPI支付响应参数：payMode=ALIPAY 时返回

主扫JSAPI支付响应参数：payMode=UQRCODEPAY 时返回

主扫JSAPI支付响应参数：payMode=LKLACC 时返回

NATIVE支付

（transType=41）

主扫NATIVE支付响应参数

微信小程序支付

（transType=71）

主扫-微信小程序支付响应参数：

微信App支付

（transType=61）

主扫-微信App支付响应参数

支付宝H5支付

（transType=81）

主扫-支付宝H5支付响应参数

示例报文

NATIVE请求报文

xxxxxxxxxx
18
1
{
2
    "reqData": {
3
        "mercId": "822100050210643",
4
        "termNo": "47846848",
5
        "payMode": "ALIPAY",
6
        "amount": "000000000001",
7
        "openId": "",
8
        "spbillCreateIp": "127.1.10",
9
        "transType": "41",
10
        "orderId": "20200728165211",
11
        "appId": "",
12
        "subject": "测试专用"
13
    },
14
    "ver": "1.0.0",
15
    "timestamp": "1541589957000",
16
    "reqId": "baff59de4694438ca9089862253517a5",
17
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
18
}

NATIVE成功响应报文

xxxxxxxxxx
16
1
{
2
    "respData": {
3
        "tradeTime": "20200729150043",
4
        "code": "https://qr.alipay.com/bax01969llc2hqjjifvm50ff",
5
        "orderId": "20200728165211",
6
        "lklOrderId": "20200729110113200266211202870109"
7
    },
8
    "timestamp": 1596006044804,
9
    "rnd": null,
10
    "ver": "1.0.0",
11
    "reqId": "baff59de4694438ca9089862253517a5",
12
    "respId": null,
13
    "retCode": "000000",
14
    "retMsg": "交易成功",
15
    "cmdRetCode": "GLOBAL_SUCCESS"
16
}

NATIVE失败响应报文

xxxxxxxxxx
7
1
{
2
    "retCode":"PT10FF",
3
    "retMsg":"生成订单失败",
4
    "sign":"",
5
    "timestamp":1553823081169,
6
    "ver":"1.0.0"
7
}

JSAPI请求报文

xxxxxxxxxx
18
1
{
2
    "reqData": {
3
        "mercId": "822162070120015",
4
        "termNo": "47827142",
5
        "payMode": "WECHAT",
6
        "amount": "000000000001",
7
        "openId": "olpr-0pHIp1AjaAr29LENlHi0cJ0",
8
        "spbillCreateIp": "127.0.0.1",
9
        "transType": "51",
10
        "orderId": "2020072915yhl1422",
11
        "appId": "wx9ef39b708f16694d",
12
        "subject": "测试专用"
13
    },
14
    "ver": "1.0.0",
15
    "timestamp": "1541589957000",
16
    "reqId": "baff59de4694438ca9089862253517a5",
17
    "termExtInfo":{"termLoc":"+155621.316/-125622.12"}
18
}

JSAPI成功响应报文

xxxxxxxxxx
21
1
{
2
    "respData": {
3
        "timeStamp": "1596008125",
4
        "tradeTime": "20200729153540",
5
        "package": "prepay_id=wx29153525159581b728038c9c1125323300",
6
        "paySign": "wWYfaNyyMuqAHVppUfQHXLGLUVcDeCyMsbiMbT9NSEiO2+Y/1uYSFS27LYINaF9f5OoI6MJFvpZfwFGCTVByoNWUH+vfyeK96ITTsy0w44ng2paqdWRHN0D9qtUyVUcbNcf2C5jQ05H65SHNI8oUnUbwlHgGe5AA4JFqKdqiODXQ4g47F11B5/a3masTmHtE7VyIU8nIXz9iPRJh28NiY2DRSX7KMU8OGZb6Y+sAi2fLqfkB9sVHnWD3BzuXDI5xIAVj3BvF3LR38/JWeR9mEqCuQLo7VdC5WnmnqZyVo6KFExNL5Gsin85AILz8S8ibOn4ADmU7sXs0LiJ2bc7K3Q==",
7
        "orderId": "2020072915yhl1422",
8
        "lklOrderId": "20200729110113100266211202870161",
9
        "appId": "wx2421b1c4370ec43b",
10
        "signType": "RSA",
11
        "nonceStr": "20ee06fc255a4606942470808e015112"
12
    },
13
    "timestamp": 1596008140382,
14
    "rnd": null,
15
    "ver": "1.0.0",
16
    "reqId": "baff59de4694438ca9089862253517a5",
17
    "respId": null,
18
    "retCode": "000000",
19
    "retMsg": "交易成功",
20
    "cmdRetCode": "GLOBAL_SUCCESS"
21
}

JSAPI失败响应报文

xxxxxxxxxx
11
1
{
2
    "respData": null,
3
    "timestamp": 1596006460198,
4
    "rnd": null,
5
    "ver": "1.0.0",
6
    "reqId": "baff59de4694438ca9089862253517a5",
7
    "respId": null,
8
    "retCode": "BPS10028",
9
    "retMsg": "主扫支付失败(参数错误)",
10
    "cmdRetCode": "PREPAY_ORDER_ERROR"
11
}

错误码

主扫支付接口错误码

关单接口（C扫B/主扫）

主扫支付关闭订单（支持动态二维码）

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_order_close 生产环境：https://s2.lakala.com/labs/txn/labs_order_close

关单接口请求参数

注：ornMerOrderId+ornOrderSource和ornOrderId 两者只送其一，如果同时都送会校验两者之间的关系。ornOrderId是做交易时的请求orderId。

关单接口响应参数

关单接口请求报文

xxxxxxxxxx
11
1
{
2
    "reqData": {
3
        "mercId": "822162070120015",
4
        "termNo": "47827142",
5
        "ornOrderId": "2020072915yhl1422"
6
    },
7
    "ver": "1.0.0"
8
    "timestamp": "1541589957000",
9
    "reqId": "baff59de4694438ca9089862253517a5",
10
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
11
}

关单接口成功响应报文：

xxxxxxxxxx
14
1
{
2
    "respData": {
3
        "retcode": "BBS00000",
4
        "message": "订单已关闭"
5
    },
6
    "timestamp": 1596008376231,
7
    "rnd": null,
8
    "ver": "1.0.0",
9
    "reqId": "baff59de4694438ca9089862253517a5",
10
    "respId": null,
11
    "retCode": "000000",
12
    "retMsg": "交易成功",
13
    "cmdRetCode": "GLOBAL_SUCCESS"
14
}

关单接口错误码

被扫支付接口（付款码支付/B扫C）

收银员使用扫码设备读取用户微信/支付宝/云闪付等APP付款码以后，二维码或条码信息传送至商户收银台， 由商户收银台或者商户后台调用该接口发起支付对用户进行收款。

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_order_micropay 生产环境：https://s2.lakala.com/labs/txn/labs_order_micropay

被扫支付接口请求参数

被扫支付接口extendParams字段说明

支持的authCode说明

被扫支付接口响应参数

authCode为UQRCODEPAY的银联付款码若要支持银联单品营销功能，需要上送公共说明中的参数orderInfo、goodsInfo、termExtInfo中的termSN、termType，响应参数会新增公共说明中的参数issAddnData、couponInfo。具体见银联单品营销示例报文。 银联单品营销只支持全额退款。

被扫支付接口请求报文

xxxxxxxxxx
15
1
{
2
    "reqData": {
3
        "mercId": "822100050210643",
4
        "termNo": "47846848",
5
        "payMode": "ALIPAY",
6
        "authCode":"288078062895929480",
7
        "amount": "1",
8
        "orderId": "2020072915yhl3l987kl",
9
        "subject": "测试专用"
10
    },
11
    "ver": "1.0.0",
12
    "timestamp": "1541589957000",
13
    "reqId": "baff59de4694438ca9089862253517a5",
14
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
15
}

被扫支付接口成功响应报文

xxxxxxxxxx
19
1
{
2
    "respData": {
3
        "tradeTime": "20200729160052",
4
        "orderId": "2020072915yhl3l987kl",
5
        "amount": "1",
6
        "weOrderNo": "2020072922001464161428488717",
7
        "lklOrderId": "20200729110113200166211202870175",
8
        "openId": "2088802829664168",
9
        "settlementTotalFee": "1"
10
    },
11
    "timestamp": 1596009653049,
12
    "rnd": null,
13
    "ver": "1.0.0",
14
    "reqId": "baff59de4694438ca9089862253517a5",
15
    "respId": null,
16
    "retCode": "000000",
17
    "retMsg": "交易成功",
18
    "cmdRetCode": "GLOBAL_SUCCESS"
19
}

```

被扫支付接口错误码

撤销接口（B扫C/付款码/被扫交易）

当日支付成功且需要取消的交易，可以调用该接口。接口逻辑 ： 支付成功的撤销支付（资金会退还给用户）。 调用支付接口后请勿立即调用撤销订单接口，建议支付后至少15s后再调用撤销订单接口。

请求URL：

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_order_micropay_reverse 生产环境：https://s2.lakala.com/labs/txn/labs_order_micropay_reverse

被扫撤销接口请求参数

ornOrderId和lklOrderNo 必须送一个

撤销接口响应参数

撤销接口请求报文

xxxxxxxxxx
12
1
{
2
    "reqData": {
3
        "mercId": "822100050210643",
4
        "termNo": "47846848",
5
        "orderId": "202007233yhl3l987kl",
6
        "ornOrderId": "20ujk072915yhl3l987kl"
7
    },
8
    "ver": "1.0.0",
9
    "timestamp": "1541589957000",
10
    "reqId": "baff59de4694438ca9089862253517a5",
11
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
12
}

撤销接口成功响应报文

xxxxxxxxxx
15
1
{
2
    "respData": {
3
        "retcode":"BBS00000",
4
        "message": "订单已撤销",
5
        "orderId": "202007233yhl3l987kl"
6
    },
7
    "timestamp": 1596013728589,
8
    "rnd": null,
9
    "ver": "1.0.0",
10
    "reqId": "baff59de4694438ca9089862253517a5",
11
    "respId": null,
12
    "retCode": "000000",
13
    "retMsg": "交易成功",
14
    "cmdRetCode": "GLOBAL_SUCCESS"
15
}

撤销接口失败响应报文

xxxxxxxxxx
10
1
{
2
    "reqId":"",
3
    "respData":null,
4
    "respId":"",
5
    "retCode":"PT10FF",
6
    "retMsg":"撤销交易失败",
7
    "rnd":"",
8
    "timestamp":1555579845015,
9
    "ver":"1.0.0"
10
}

撤销接口错误码

外部订单查询

使用场景是B端使用外部订单生成二维码，供用户扫码支付，在这种场景下，B端发起查询，只有生成二维码的订单信息，这时，用这个接口查询

请求URL：

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_ext_order_query 生产环境：https://s2.lakala.com/labs/txn/labs_ext_order_query

外部订单查询请求参数

外部订单查询响应参数

订单查询响应接口中的retCode及retMsg只代表查询流程的业务状态，交易的状态需根据respData中的tradeState字段来判定。

外部订单查询请求报文

xxxxxxxxxx
10
1
JSON
2
{
3
    "reqData": {
4
        "mercId": "822126090640003",
5
        "exterMerOrderNo": "DD2020120404122424424",
6
        "exterOrderSource": "OS",
7
        "termNo": "47781282"
8
    },
9
    "ver": "1.0.0"
10
}

外部订单查询成功响应报文

xxxxxxxxxx
25
1
{
2
    "ver": "1.0.0",
3
    "respId": null,
4
    "respData": {
5
        "amount": "1",
6
        "platformDiscountAmount": null,
7
        "payTime": null,
8
        "ornOrderId": null,
9
        "payMode": null,
10
        "openId": "2088902457052615",
11
        "bankType": null,
12
        "clientDiscountAmt": "0",
13
        "weOrderNo": "2020121422001452615717639231",
14
        "serverDiscountAmt": "0",
15
        "tradeState": "SUCCESS",
16
        "lklOrderNo": "20201214110113200266211401190905",
17
        "settlementTotalFee": null
18
    },
19
    "rnd": null,
20
    "retCode": "000000",
21
    "retMsg": "交易成功",
22
    "cmdRetCode": "GLOBAL_SUCCESS",
23
    "timestamp": 1607917705503,
24
    "reqId": "baff59de4694438ca9089862253517a5"
25
}

交易订单查询

根据商户订单号或者平台订单号查询平台的具体订单信息

请求URL：

交易订单查询请求参数

ornOrderId和lklOrderNo 必须送一个

交易订单查询响应参数

订单查询响应接口中的retCode及retMsg只代表查询流程的业务状态，交易的状态需根据respData中的tradeState字段来判定。

交易订单查询请求报文示例

xxxxxxxxxx
10
1
JSON
2
{
3
    "reqData": {
4
        "mercId": "822126090640003",
5
        "ornOrderId": "DD2020120404122424424",
6
        "lklOrderNo": "20201214110113200266211401190905",
7
        "termNo": "47781282"
8
    },
9
    "ver": "1.0.0"
10
}

交易订单查询响应报文示例

xxxxxxxxxx
24
1
{
2
    "ver": "1.0.0",
3
    "respId": null,
4
    "respData": {
5
        "amount": "1",
6
        "platformDiscountAmount": null,
7
        "payTime": null,
8
        "ornOrderId": null,
9
        "openId": "2088902457052615",
10
        "bankType": null,
11
        "clientDiscountAmt": "0",
12
        "weOrderNo": "2020121422001452615717639231",
13
        "serverDiscountAmt": "0",
14
        "tradeState": "SUCCESS",
15
        "lklOrderNo": "20201214110113200266211401190905",
16
        "settlementTotalFee": null
17
    },
18
    "rnd": null,
19
    "retCode": "000000",
20
    "retMsg": "交易成功",
21
    "cmdRetCode": "GLOBAL_SUCCESS",
22
    "timestamp": 1607917705503,
23
    "reqId": "baff59de4694438ca9089862253517a5"
24
}

退款接口

请求URL：

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_order_refund 生产环境：https://s2.lakala.com/labs/txn/labs_order_refund

退款接口请求参数

lklOrderNo和ornOrderId 必须送一个

退款接口响应参数

退款请求示例报文

xxxxxxxxxx
13
1
{
2
    "reqData": {
3
        "mercId": "822100050210643",
4
        "termNo": "47846848",
5
        "amount": "1",
6
        "ornOrderId": "202760072915yhl3l987kl",
7
        "refundOrderId": "567890984476678"
8
    },
9
    "ver": "1.0.0",
10
    "timestamp": "1541589957000",
11
    "reqId": "baff59de4694438ca9089862253517a5",
12
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
13
}

退款请求成功响应示例报文

xxxxxxxxxx
17
1
{
2
    "respData": {
3
        "retcode":"BBS00000",
4
        "message": "订单已退款",
5
        "retAmt": "1",
6
        "refundOrderId": "567890984476678",
7
        "refundLklOrderNo": "20200729110113201266161202870208"
8
    },
9
    "timestamp": 1596010956013,
10
    "rnd": null,
11
    "ver": "1.0.0",
12
    "reqId": "baff59de4694438ca9089862253517a5",
13
    "respId": null,
14
    "retCode": "000000",
15
    "retMsg": "交易成功",
16
    "cmdRetCode": "GLOBAL_SUCCESS"
17
}

退款接口错误码

生成动态二维码接口

请求URL：

测试环境：https://test.wsmsd.cn/sit/labs/txn/labs_dycode_create 生产环境：https://s2.lakala.com/labs/txn/labs_dycode_create

动态二维码请求接口说明

动态二维码txnField字段说明

动态二维码orderField字段说明

动态二维码响应参数

动态二维码请求示例

xxxxxxxxxx
13
1
{
2
    "reqData":{
3
        "mercId": "822290070111135",
4
        "termNo": "29034705",
5
        "merName": "BPS商户名称",
6
        "codeValidPeriod": "60",
7
        "orderField":{"amount":"123","subject":"订单标题","exterMerOrderNo":"2020112513522260","description":"订单描述","exterOrderSource":"OS10","orderRemark":"订单备注"},
8
        "txnField":{"settleType":"0","appId":"0","notifyUrl":"http://abc.com","attach":"附加域","goodsDetail":"0","goodsTag":"0"}
9
},
10
    "ver": "1.0.0",
11
    "timestamp": "1541589957000",
12
    "reqId": "baff59de4694438ca9089862253517a5"
13
}

动态二维码响应示例

xxxxxxxxxx
15
1
{
2
    "respData": {
3
        "qrCode": "A11DA22943B3A6A5BA4EE994",
4
        "qrCodeUrl": "http://q.huijingcai.top/r/A11DA22943B3A6A5BA4EE994",
5
        "codeExpiredTime": "60"
6
    },
7
    "timestamp": 1606899198562,
8
    "rnd": null,
9
    "ver": "1.0.0",
10
    "reqId": "baff59de4694438ca9089862253517a5",
11
    "respId": null,
12
    "retCode": "000000",
13
    "retMsg": "交易成功",
14
    "cmdRetCode": "GLOBAL_SUCCESS"
15
}

微信openid查询

请求URL：

测试环境：https://test.wsmsd.cn/sit/saas/query/wx_openid_query 生产环境：https://s2.lakala.com/saas/query/wx_openid_query

微信openid查询请求接口说明

微信openid查询响应参数

微信openid查询请求示例

xxxxxxxxxx
12
1
{
2
    "reqData": {
3
        "mercId": "822290070111135",
4
        "termNo": "29034705",
5
        "authCode": "136519690623734145",
6
        "subAppid":""
7
    },
8
    "ver": "1.0.0",
9
    "timestamp": "1541589957000",
10
    "reqId": "baff59de4694438ca9089862253517a5",
11
    "termExtInfo":{"termLoc":"+155621.316,-125622.12"}
12
}

微信openid查询响应示例

xxxxxxxxxx
13
1
{
2
    "appid": "",
3
    "cmdRetCode": "GLOBAL_SUCCESS",
4
    "reqId": "",
5
    "respData": {
6
        "openId": "oUpF8uBegFLdKvbbII8hXQKSZHy0",
7
        "subOpenId": ""
8
    },
9
    "retCode": "000000",
10
    "retMsg": "交易成功",
11
    "timestamp": 1611136188637,
12
    "ver": "1.0.0"
13
}

子商户号查询

请求URL：

测试环境：https://test.wsmsd.cn/sit/saasmgt/submer/query 生产环境：https://s2.lakala.com/saasmgt/submer/query

子商户号查询请求接口说明

备注：

因为银联AT微信的子商户号有多个，需要根据accessId来区分

子商户号查询响应参数

子商户号查询请求示例

xxxxxxxxxx
12
1
{
2
    "reqData":{
3
        "barcodeMerchantNo":"822290059470417",
4
        "terminalNo":"47782155",
5
        "businessOrgNo":"1900009211",
6
        "accessId":"24006513",
7
        "tradeMode":"WECHAT"
8
    },
9
    "ver":"1.0.0",
10
    "timestamp":"1541589957000",
11
    "reqId":"baff59de4694438ca9089862253517a5"
12
}

子商户号查询响应示例

xxxxxxxxxx
18
1
{
2
    "appid": "",
3
    "cmdRetCode": "GLOBAL_SUCCESS",
4
    "reqId": "",
5
    "respData": {
6
        "accessId": "24006513",
7
        "terminalNo": "47782155",
8
        "barcodeMerchantNo": "822290059470417",
9
        "subMerchantNo": "314448745",
10
        "tradeMode": "WECHAT",
11
        "serverId": "UNION-WX",
12
        "businessOrgNo": "1900009211"
13
    },
14
    "retCode": "000000",
15
    "retMsg": "交易成功",
16
    "timestamp": 1618207567252,
17
    "ver": "1.0.0"
18
}

错误码

BPS错误码

交易系统错误码

LABS错误码

结算接口

公共参数说明

接口文档中，必选栏目：M 必须，C 可选

结算接口版本

结算接口公共请求参数

结算接口公共响应参数

订单结算接口

用于分账完成时请求。