佣金结算(SFT0502)

POST

/open/api/gateway.do

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

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

请求参数

Body 参数application/json

示例

{
    "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": 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

修改于 2025-01-08 04:09:04

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

佣金结算批次查询(SFT0503)