1. 3.接入顺序及验签规则
lingyue-open-api
  • 1.文档概述
  • 2.名词解释
  • 3.接入顺序及验签规则
    • 网关地址
    • 密钥生成工具
    • SDK下载
      • SDK下载地址
    • 验签网关
      POST
    • 回调通知
      POST
  • 4. 灵活用工人员相关
    • 4.1 - 灵活用工人员注册接口
      POST
    • 4.2 - 灵活用工人员签约接口
      POST
    • 4.2.1 - 签约回调
      POST
    • 4.3 - 灵活用工人员签约查询
      POST
    • 4.4 - 灵活用工人员个税及增值税查询
      POST
    • 4.5 - 灵活用工人员状态信息查询
      POST
    • 4.6 - 灵活用工人脸识别认证
      POST
    • 4.2.1 - 人脸识别认证回调
      POST
    • 4.7 - 灵工人员同步人脸识别记录
      POST
  • 5. 付款相关
    • 5.1 - 商户付款申请
      POST
    • 5.1.1 - 付款回调
      POST
    • 5.1.2 - 订单冲正回调
      POST
    • 5.2 - 商户付款订单查询
      POST
    • 5.3 - 成功付款对账文件下载
      POST
    • 5.4 - 本月风控余额查询
      POST
    • 5.5 - 灵活用工人员税费测算
      POST
  • 6. 账户相关
    • 6.1 - 商户余额查询
      POST
    • 6.2 - 商户汇款记录查询
      POST
    • 6.3 - 汇款回调
      POST
  • 7. 发票相关
    • 7.1 - 商户可开票金额查询
    • 7.2 - 可开票订单列表查询
    • 7.3 - 发票申请
    • 7.4 - 发票申请结果查询
  • 8. 回单相关
    • 8.1 - 批次电子回单查询
    • 8.2 - 明细电子回单查询
  • 9. 完税相关
    • 9.1 - 完税证明查询
  • 10.众包相关
    • 10.1 - 商户众包申请
    • 10.2- 商户众包更新
    • 10.3 - 商户众包查询
    • 10.4 - 业务确认单及成果验收单查询及下载
    • 10.5 - 业务确认单及成果验收单上传
  1. 3.接入顺序及验签规则

回调通知

POST

一、回调通知公钥#

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqIh4dbuxTOA63kTTQDNa6wOvbqAe28N/zd4e1c913Fc1F16 vKQ/vaxpeocYf7yBnuEyQZoEkBOoQQcLeTLXvyTSyvz4wLcqwmlvIhH37pFs+MLWb/ovZ3nbd1L15RNpGNR59pnUSwS KkjwsbgtFng/ptMWZwUkv11egs+2UjpsltHtaEkw/w2Ai0N8JZTqaFdCnqZGkht4CSVQKOMZrAeF4AD1Siwfk0PqsFG QeJh1/iMdEA7+6P/s2K+OZjT0833nsM5MSoPOHJO4Y3mA+95KFLt30icJGNXm2U/jN4ykD6HPG4X0G8J2g8SuhB86YI OeSQB53afArB2ayfievz5QIDAQAB

二、异步通知规则描述#

1、筛选并排序#

所有参数（不含sign字段，尤其需要注意不包含返回值为空的字段）升序排序。即按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

2、拼接参数#

排序后的参数和对应值，组合成“参数=参数值”的格式，然后把这些参数用&字符连接起来，例如：app_id = 10210715580801&merchant_request_no=001，此时生成的字符串为待签名字符串。biz_content对应的value不需要排序。

3、调用签名函数#

使用java对应的SHA256WithRSA(对应sign_type为RSA2)签名函数，利用公钥对待签名字符串进行验签。

4、请求格式#

application/x-www-form-urlencoded

5、通知#

商户收到异步通知后，返回success（不区分大小写），则只推送一次；否则总共推送三次，三次后不再重复通知，需要通过商户付款订单查询接口主动发起查询获取。

请求参数

Body 参数application/json必填

示例
{
    "method": "callBack",
    "sign_type": "RSA2",
    "timestamp": "2025-10-15",
    "version": "1.0",
    "merchant_request_no": "917934dabf3c46fd949b91fca80e144f",
    "biz_content": "对应回调接口的内容",
    "sign": "neBMx4MWftkfnZg0BfIHraUzmd1kVXtqvFj+nbITOB1t895rL44vFIcQiqdV795X2JoqO1DoeR1NnueSpo7MWbGTq6O3jXLnIhVSjVwbWbKgDETb+mr9x1Blco3JdLqxT5rh2hC79AtZChTI1iZ8prtF7ACW/VtRzNgFEq4DVhAi+EDKeqiu4neN1MJ1DMEhjyXpTEj4Qw4hrmG611L3ahvXQHiFCW+fjJl2+n+RBSksZ/zxqPcfBlA085MYgUpcdk99b72O4Te+UNabkVRrSz/wAKMLULzWQoQH+AfGcP/ILe5wwBuW9xOQ5hiGRDrE0U5V22Gkgb5P4ohsN0M5tQ=="
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://lylw.faqianbei.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "callBack",
    "sign_type": "RSA2",
    "timestamp": "2025-10-15",
    "version": "1.0",
    "merchant_request_no": "917934dabf3c46fd949b91fca80e144f",
    "biz_content": "对应回调接口的内容",
    "sign": "neBMx4MWftkfnZg0BfIHraUzmd1kVXtqvFj+nbITOB1t895rL44vFIcQiqdV795X2JoqO1DoeR1NnueSpo7MWbGTq6O3jXLnIhVSjVwbWbKgDETb+mr9x1Blco3JdLqxT5rh2hC79AtZChTI1iZ8prtF7ACW/VtRzNgFEq4DVhAi+EDKeqiu4neN1MJ1DMEhjyXpTEj4Qw4hrmG611L3ahvXQHiFCW+fjJl2+n+RBSksZ/zxqPcfBlA085MYgUpcdk99b72O4Te+UNabkVRrSz/wAKMLULzWQoQH+AfGcP/ILe5wwBuW9xOQ5hiGRDrE0U5V22Gkgb5P4ohsN0M5tQ=="
}'

返回响应

🟢200成功
application/json
Body

示例
success
修改于 2025-11-26 07:51:02
上一页
验签网关
下一页
4. 灵活用工人员相关
Built with