开发指引

更新时间：2021-12-16 16:18:01

开始接入

image.png
温馨提示：阅读本文档之前，请认真仔细的确认您已经执行了下面的三步操作，并获得了有效的扫呗接入资料：

  1. 签订合作协议
  2. 提交接口帐户数据开户登记表，用于开立测试和生产环境帐户
  3. 开发人员与扫呗技术支持建立联系

测试环境

⑴测试服务地址
① 测试环境地址（支付）：http://test.lcsw.cn:8045/lcsw/+相关API接口URL​
② 测试环境地址（签约）：http://test.lcsw.cn:8045/lcsw_mch/+相关API接口URL
若8045端口服务有问题，第一时间反馈给对接技术同学
​

⑵测试账号
测试账号统一由我司技术同学分配。

  • 商户系统：
    • 机构号inst_no
    • 令牌key

  • 支付系统：

    • 商户号merchant_no
    • 终端号terminal_id
    • 令牌access_token


    拿到测试环境后，合作方即可进入测试联调阶段，有问题可在相关对接群中咨询技术同学。
    ​

    生产环境

    注意：接口联调必须先在测试环境联调，由技术同学验收通过后，才可正式接入线上生产环境。
    生产环境账号参数：由商务或运营同事提供
    生产环境域名：统一由技术同学提供

注：以上资料在测试环境中和生产环境中并不相同，准备调试和切换环境时请认真核对并确认无误。
​

通信协议

本文档中的所有接口，未明确说明的，增均采用HTTP标准通信协议，请求和响应的Content-type均为application/json，字符编码统一为UTF-8。

接口的完整URL由统一前缀+接口的URL组成，测试环境和生产环境的统一前缀完全不同，测试环境的URL前缀为http://test.lcsw.cn:8045/lcsw。

例如测试环境下创建商户接口的完整URL为http://test.lcsw.cn:8045/lcsw/merchant/100/add。生产环境的统一前缀在测试环境调试通过以后，从扫呗的技术支持处获得。

接口安全

签名

本文档中的每一个接口，未明确说明的，均在请求参数附加一个名为key_sign的参数，此参数即本次请求参数的签名字符串。举个粟子：
假设必填请求参数如下

{
    "pay_ver":"100",
    "pay_type":"010",
    "service_id":"020",
    "merchant_no":"889521000000001",
    "terminal_id":"10000001",
    "terminal_trace":"1234567890",
    "terminal_time":"20161001120010"
}

  1. 按文档中参数列表的顺序拼接参数

    string1="pay_ver=100&pay_type=010&service_id=020&merchant_no=889521000000001&terminal_id=10000001&terminal_trace=1234567890&terminal_time=20161001120010";

    支付接口参数拼接顺序是文档序，商户接口的参数拼接顺序是字典序（），具体参数拼接顺序请仔细阅读接口参数中的key_sign说明
    ​

  2. 拼接令牌

    string2=string1+"&access_token=03c3ef1574c442cd96520aa6772cb5d2";

    支付接口的令牌参数名是access_token，通过创建终端接口获得；商户接口的令牌参数名是key，由扫呗人工颁发。

  3. 通过摘要算法取得签名字符串

    key_sign=md5(string2);


    最后将要请求接口的参数应该是这个样子：

    {
 "pay_ver":"100",
 "pay_type":"010",
 "service_id":"020",
 "merchant_no":"889521000000001",
 "terminal_id":"10000001",
 "terminal_trace":"1234567890",
 "terminal_time":"20161001120010",
 "key_sign":"bc3e6ac8355bf3a4c2cf9cd00d6065b8"
}

警告

令牌是一个非常重要的数据，请您必须小心谨慎的确保此数据保存在足够安全的地方。您从扫呗官方获得此数据的同时，即表明您保证不会被用于非法用途和不会在没有得到您授权的情况下被盗用，一旦因此数据保管不善而导致的经济损失及法律责任，均由您独自承担。
​

业务时序图

签约时序图

image.png

刷脸扣费时序图

image.png

© 利楚商服 2020 All rights reserved.