lingyue-open-api
  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
  • 5. 付款相关
    • 5.1 - 商户付款申请
      POST
    • 5.1.1 - 付款回调
      POST
    • 5.2 - 商户付款订单查询
      POST
    • 5.3 - 成功付款对账文件下载
      POST
    • 5.4 - 本月风控余额查询
      POST
    • 5.5 - 灵活用工人员税费测算
      POST
  • 6. 账户相关
    • 6.1 - 商户余额查询
      POST
    • 6.2 - 商户汇款记录查询
      POST
  • 7. 发票相关
    • 7.1 - 商户可开票金额查询
      POST
  • 8. 回单相关
    • 8.1 - 批次电子回单查询
      POST
    • 8.2 - 明细电子回单查询
      POST
  • 9. 完税相关
    • 9.1 - 完税证明查询
  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