2.1 委托代征佣金发放API - 灵工系统-对外文档

对已签约/未签约的灵工,进行银行卡/支付宝/微信方式佣金发放

请求参数

Header 参数

merchantNo

string

商户编号

必需

默认值:

agreementId

string

协议编号

必需

默认值:

appKey

string

appKey

必需

默认值:

requireTime

string

必需

请求时间格式（yyyy-MM-dd HH:mm:ss）

默认值:

sign

string

签名

必需

默认值:

signType

string

必需

签名类型 MD5/RSA

默认值:

orderId

string

必需

每个 request 的 id，要求每次请求的 id 不一样，会在response 中原样返回

默认值:

Body 参数application/json

bankType

integer <int32>

必需

打款通道 1银行卡 3支付宝&安全发 6微信&微工卡

bizOrderNo

string

必需

商户端业务批次号(32位，对接端唯一)

示例值:

M1234567893456

callbackUrl

string

可选

发放批次完成自定义回调地址,如果未传会以默认配置的回调地址进行通知，后台默认回调地址配置后次字段生效

onlyPayFlag

integer <int32>

可选

打款明细中的订单号只全系统支付唯一

payDetailList

array[object (API批次打款明细) {10}]

必需

打款明细（长度建议不要超过500）

accountNo

string

必需

收款账号，如果是微信则传开户时appId所对应的openid

示例值:

633565894365445

amount

string

必需

金额（元）。银行卡单笔最低0.01元，支付宝单笔最低0.1元，微信单笔最低0.3元

示例值:

100

detailOrderNo

string

商户端订单号

必需

示例值:

M0000001

frequency

integer <int32>

可选

顺丰业务中用到的版本号，存入了employ_id字段

idCard

string

可选

身份证。免签模式下，非必传；静默签，H5签及小程序签模式下，必传

示例值:

330429200515122600

merchantRemark

string

打款备注

可选

示例值:

服务费

payAccountType

integer <int32>

必需

收款类型 1银行卡 2支付宝 6微信

示例值:

phone

string

可选

本人手机号。免签模式下，非必传；静默签，H5签及小程序签模式下，必传

示例值:

130100000000

userName

string

必需

收款人姓名。免签模式下，非必传；静默签，H5签及小程序签模式下，必传

示例值:

范蠡

weixinAppId

string

可选

微信appId,与openid对应

payMethod

integer <int32>

必需

收款方式 1银行卡 2支付宝 6微信

remarks

string

备注

可选

示例值:

测试打款

taskNo

string

可选

业务任务号(税地为订单开票或协议开启任务结算，则为必填),需要正确任务编码，如果没有要求可以不用传

totalAmount

string

总金额

必需

示例值:

100

totalCount

integer <int32>

总笔数

必需

示例值:

示例

{
    "bankType": 0,
    "bizOrderNo": "M1234567893456",
    "callbackUrl": "string",
    "onlyPayFlag": 0,
    "payDetailList": [
        {
            "accountNo": 633565894365445,
            "amount": 100,
            "detailOrderNo": "M0000001",
            "frequency": 0,
            "idCard": 330429200515122600,
            "merchantRemark": "服务费",
            "payAccountType": 1,
            "phone": 130100000000,
            "userName": "范蠡",
            "weixinAppId": "string"
        }
    ],
    "payMethod": 0,
    "remarks": "测试打款",
    "taskNo": "string",
    "totalAmount": 100,
    "totalCount": 1
}

返回响应

🟢200成功

*/*

Body

code

integer <int32>

返回码

可选

data

object (API打款批次返回结果)

可选

bizOrderNo

string

必需

商户端业务批次号(32位，对接端唯一)

示例值:

M1234567893456

platformOrderNo

string

平台端打款批次号

必需

示例值:

P211101019011915410

msg

string

返回信息

可选

示例

{
    "code":"200",  
    "msg":"请求成功",
    "data":{
        "bizOrderNo":"M1234567893456",
        "platformOrderNo:"P211101019011915410" 
     }
}