佣金结算(SFT0502)

POST

/open/api/gateway.do

代付管理

批量佣金代发，支持最大5000笔
接口调用成功后，通过主动查询或者结果通知查询最终付款结果，付款通知只告知总结果，明细需通过查询

注：如调用平台接口异常(网络超时等异常)或系统返回异常编码为500时，注意使用商户批次号调用佣金结算批次查询(SFT0503)接口确认是否申请成功，在未明确结果前，务必不要当失败处理

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0502

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object

必需

acctNo

string

存管账号

必需

deductionMethod

string

服务费扣款方式

可选

1:企业承担 1 2:个人承担需要运营配置支持, 如配置一个可不传

outBatchNo

string

外部批次号

必需

记录外部批次号（）

projectCode

string

项目编码

可选

项目为空会以存管账户归属服务商取用工企业默认的最新项目

remark

string

付款备注

可选

orderList

object

必需

示例

{
    "apiCode": "SFT0502",
    "bizModel": "{\"acctNo\":\"206610026101800006\",\"deductionMethod\":1,\"outBatchNo\":\"O20240111000011\",\"orderList\":[{\"payeeAcctNo\":\"6225882014306068\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"15814488937\",\"payeeName\":\"周亮飞\",\"payeeType\":\"BANK\",\"payerAmount\":200,\"remark\":\"佣金\"},{\"outOrderNo\":\"O20240111000022\",\"payeeAcctNo\":\"622588201222222\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"510722197212037066\",\"payeeMobileNo\":\"15800000001\",\"payeeName\":\"张三\",\"payeeType\":\"BANK\",\"payerAmount\":1000,\"remark\":\"佣金\"}],\"outBatchNo\":\"P202401110000002\",\"projectCode\":\"20230210270005\",\"remark\":\"测试付款\"}",
    "sign": "F7HwL/NzhiKIlZfGSYhqDrLA98keMu0PkbNRv3g6uXpe75O1WaLpSavKOKWaHxaolyaHngCQLVPGlIp6WVrFKePiCkQrokgeNCMnoiZJ9Bx4Eq05/BCosISIFDqJzKp3QLaIguhxGgWUQ7Y1jNpBzicdnyvCj85PMeqVjPVwkGc=",
    "requestNo": "e77f2530-d5c1-4b38-bc09-9acbfc733a80",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111154013"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0502",
    "bizModel": "{\"acctNo\":\"206610026101800006\",\"deductionMethod\":1,\"outBatchNo\":\"O20240111000011\",\"orderList\":[{\"payeeAcctNo\":\"6225882014306068\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"15814488937\",\"payeeName\":\"周亮飞\",\"payeeType\":\"BANK\",\"payerAmount\":200,\"remark\":\"佣金\"},{\"outOrderNo\":\"O20240111000022\",\"payeeAcctNo\":\"622588201222222\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"510722197212037066\",\"payeeMobileNo\":\"15800000001\",\"payeeName\":\"张三\",\"payeeType\":\"BANK\",\"payerAmount\":1000,\"remark\":\"佣金\"}],\"outBatchNo\":\"P202401110000002\",\"projectCode\":\"20230210270005\",\"remark\":\"测试付款\"}",
    "sign": "F7HwL/NzhiKIlZfGSYhqDrLA98keMu0PkbNRv3g6uXpe75O1WaLpSavKOKWaHxaolyaHngCQLVPGlIp6WVrFKePiCkQrokgeNCMnoiZJ9Bx4Eq05/BCosISIFDqJzKp3QLaIguhxGgWUQ7Y1jNpBzicdnyvCj85PMeqVjPVwkGc=",
    "requestNo": "e77f2530-d5c1-4b38-bc09-9acbfc733a80",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111154013"
}'

返回响应

🟢200OK

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

acctNo

string

存管账号

必需

batchNo

string

平台批次号

必需

outBathNo

string

外部批次号

必需

deductionMethod

string

服务费扣款方式

必需

1:企业承担 2:个人承担

projectCode

string

项目编码

必需

totalCount

string

总笔数

必需

totalAmount

string

总金额

必需

元，2位小数

successCount

string

成功笔数(申请不返回)

必需

successAmount

string

成功金额(申请不返回)

必需

元，2位小数

successServiceAmount

string

成功服务费(申请不返回)

必需

元，2位小数

failCount

string

失败笔数(申请不返回)

必需

failAmount

string

失败金额(申请不返回)

必需

元，2位小数

status

integer

批次状态

必需

0:处理中 2:失败，代发多笔存在成功的状态即为0:处理中

orderList

object

订单列表

必需

orderNo

string

平台订单号

必需

outOrderNo

string

商户订单号

必需

payeeName

string

收款人

必需

payeeCertNo

string

收款人身份证号

必需

payeeMobileNo

string

收款人手机号

必需

payeeType

string

收款类型

必需

BANK:银行卡 ALI_PAY:支付宝 WE_CHAT:微信

payeeBankName

string

收款账户银行名称

必需

payeeAcctNo

string

收款账号

必需

payerAmount

number

付款金额

必需

元，2位小数

payeeAmount

number

收款金额(申请不返回)

必需

元，2位小数

serviceAmount

number

服务费(申请不返回)

必需

元，2位小数

remark

string

付款备注

必需

failMsg

string

付款失败信息

必需

status

integer

付款状态

必需

0:处理中 1:付款成功 2:付款失败

示例

{
    "code": 200,
    "data": {
        "acctNo": "206610026308300056",
        "deductionMethod": 1,
        "detailList": [
            {
                "mobileNo": "15920146112",
                "payeeAcctNo": "6236683320028850857",
                "payeeAmount": 1,
                "payeeBankName": null,
                "payeeCertNo": "440781199103146010",
                "payeeName": "冯炎辉",
                "payeeType": "BANK",
                "payerAmount": 1,
                "remark": null,
                "serverAmount": 0.05
            }
        ],
        "projectCode": "20231008550001",
        "successAmount": 1,
        "successNum": 1,
        "successServerAmount": 0.05,
        "totalAmount": 1,
        "totalNum": 1
    },
    "message": "操作成功"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

佣金结算服务费预计算(SFT0501)

佣金结算批次查询(SFT0503)