营销金结算付款(SFT0502)

POST

/open/api/gateway.do

代付管理

接口调用成功后，通过主动查询或者结果通知查询最终付款结果，付款通知只告知总结果，明细需通过查询

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0502

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object

必需

outBatchNo

string

外部批次号

必需

记录外部批次号（）

acctNo

string

存管账号

必需

businessCode

string

业务类型

必需

营销返利:B00005，必传

deductionMethod

string

服务费扣款方式

可选

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

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

营销活动创建（SFT1101)

营销金结算批次查询(SFT0503)