lingyue-open-api
  1. 5. 付款相关
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. 5. 付款相关

5.1 - 商户付款申请

POST
settle.remit.api.payment
商户调用此接口给灵活用工人员的银行卡、微信、支付宝进行付款;
如请求接口网络异常或非成功响应码,建议通过5.2 商户付款订单查询接口确认最终状态;
再次发起建议原批次号重新发起付款,以防重复付款。
建议一个付款批次仅包含一条付款明细,便于对账处理。

请求参数

Body 参数application/json必填

示例
{
  "custBatchNo": "235da0917a03436492162ab06d8e3339",
  "batchNum": 1,
  "batchAmt": 0.01,
  "serverCallbackUrl": "http://localhost/sop/callBack",
  "recvType": "BANK",
  "remitDetailList": [
    {
      "custOrderNo": "46dbb2873b864fd79e44c28871a6d441",
      "orderAmt": 0.01,
      "recvCustName": "张三",
      "recvMobile": "18510287007",
      "recvIdType": "IDENTITY",
      "recvIdNo": "110101199001018795",
      "recvCardNo": "6227001234567890123",
      "recvBankName": "银行",
      "remark": "xxx备注",
      "businessType": "劳务报酬",
      "incomePlatformName": "xxx平台",
      "siteName": "xxx的小店",
      "siteNo": "shop_12345",
      "siteUrl": "https://shop.taobao.com/xxxx"
    }
  ]
}

请求示例代码

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.comsettle.remit.api.payment' \
--header 'Content-Type: application/json' \
--data-raw '{
  "custBatchNo": "235da0917a03436492162ab06d8e3339",
  "batchNum": 1,
  "batchAmt": 0.01,
  "serverCallbackUrl": "http://localhost/sop/callBack",
  "recvType": "BANK",
  "remitDetailList": [
    {
      "custOrderNo": "46dbb2873b864fd79e44c28871a6d441",
      "orderAmt": 0.01,
      "recvCustName": "张三",
      "recvMobile": "18510287007",
      "recvIdType": "IDENTITY",
      "recvIdNo": "110101199001018795",
      "recvCardNo": "6227001234567890123",
      "recvBankName": "银行",
      "remark": "xxx备注",
      "businessType": "劳务报酬",
      "incomePlatformName": "xxx平台",
      "siteName": "xxx的小店",
      "siteNo": "shop_12345",
      "siteUrl": "https://shop.taobao.com/xxxx"
    }
  ]
}'

返回响应

🟢200成功
application/json
code对应描述
0000成功,受理成功,可以通过调用“商户付款订单查询”接口获取订单终态
0001参数错误或收款账户类型错误
0010客户状态非法
0010参数错误或者批次号已存在,订单不能置为失败,需要通过“商户付款订单查询”
0012服务费配置不存在
0013客户渠道配置不存在
0042任务编码配置尚未生效,请联系运营处理
5001限额配置错误
5003超过限额
9001账户不存在
9001当前为月末结算期,禁止发起交易
9002账户余额不足
9005未开通付款至支付宝
9006批次的付款账户类型同明细不符
9999系统异常,代表受理异常,订单受理状态未知,不能直接置为失败,需要通过“商户付款订单查询”接口获取订单终态或者进行原批次号重试,或联系我方技术支持进行处理
注:表中存在重复的 code 值(例如 0010、9001),请根据业务场景以接口返回的具体描述为准。
Body

示例
{
  "appId": "102510201388202",
  "code": "10000",
  "merchantRequestNo": "1764054669042",
  "msg": "请求成功",
  "response": "{\"code\":\"0000\",\"message\":\"成功\",\"custBatchNo\":\"3f5259f79cbc4a70a082359439d63d4c\",\"platBatchNo\":\"110202511253215868108927001\",\"batchAmt\":0.01,\"batchServFeeAmt\":0.00,\"totalDeduction\":0.01,\"batchStatus\":0,\"recvType\":\"BANK\"}"
}
修改于 2025-11-26 08:01:34
上一页
5. 付款相关
下一页
5.1.1 - 付款回调
Built with