营销金结算订单同步(SFT0510)

开发中

POST

营销金结算同步接口

代付管理

营销金结算同步接口

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0510

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object

必需

outBatchNo

string

外部批次号

可选

会校验商户下是否重复

taxBaseCode

string

服务商编码

必需

busType

string

业务类型

可选

非必填，默认灵活用工（1001：灵活用工；1007：营销返利）

deductionMethod

integer

服务费承担方式

可选

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

computeMode

string

计算模式

可选

1 外扣模式、2 内扣模式默认:1

payChannelCode

string

交易通道

必需

3000001:支付宝 3000002:微信 3000003:招商银行 3000005:平安银行 3000007:兴业银行

openInvoiceModel

integer

开票模式

必需

0:不可开票 1:订单开票 2:汇总开票默认:0 如果设置1和2时，SFT0404接口该参数设置为0

serviceRate

number

执行费率

可选

百分比*100

tradeTime

string <date-time>

交易时间

必需

yyyy-MM-dd HH:mm:ss， orderList下订单tradeTime字段优先

remark

string

交易备注

可选

orderList

array [object {11}]

必需

示例

{
    "apiCode": "string",
    "merchantNo": "string",
    "requestNo": "string",
    "timestamp": "string",
    "version": "string",
    "sign": "string",
    "bizModel": {
        "outBatchNo": "string",
        "taxBaseCode": "string",
        "busType": "string",
        "deductionMethod": 0,
        "computeMode": "string",
        "payChannelCode": "string",
        "openInvoiceModel": 0,
        "serviceRate": 0,
        "tradeTime": "2019-08-24T14:15:22Z",
        "remark": "string",
        "orderList": [
            {
                "outOrderNo": "string",
                "payeeName": "string",
                "payeeCertNo": "string",
                "payeeBankName": "string",
                "payeeAcctNo": "string",
                "payeeMobileNo": "string",
                "payerAmount": 0,
                "payeeAmount": 0,
                "serviceAmount": 0,
                "tradeTime": "2019-08-24T14:15:22Z",
                "remark": "string"
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '营销金结算同步接口' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "string",
    "merchantNo": "string",
    "requestNo": "string",
    "timestamp": "string",
    "version": "string",
    "sign": "string",
    "bizModel": {
        "outBatchNo": "string",
        "taxBaseCode": "string",
        "busType": "string",
        "deductionMethod": 0,
        "computeMode": "string",
        "payChannelCode": "string",
        "openInvoiceModel": 0,
        "serviceRate": 0,
        "tradeTime": "2019-08-24T14:15:22Z",
        "remark": "string",
        "orderList": [
            {
                "outOrderNo": "string",
                "payeeName": "string",
                "payeeCertNo": "string",
                "payeeBankName": "string",
                "payeeAcctNo": "string",
                "payeeMobileNo": "string",
                "payerAmount": 0,
                "payeeAmount": 0,
                "serviceAmount": 0,
                "tradeTime": "2019-08-24T14:15:22Z",
                "remark": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

status

string

同步总状态

必需

1 同步成功

batchNo

string

平台批次号号

必需

failCount

integer

失败笔数

必需

明细中失败笔数

orderList

array [object {12}]

订单明细

必需

outOrderNo

string

外部订单号

可选

不校验是否重复

payeeName

string

收款人姓名

可选

payeeCertNo

string

收款人身份证号

可选

payeeAcctNo

string

收款账号

必需

银行卡号、openId、支付宝账号

payeeMobileNo

string

收款人手机号

必需

payerAmount

number

付款金额

必需

单位元，保留2位小数

payeeAmount

number

实际收款金额

必需

单位元，保留2位小数

serviceAmount

number

服务费

可选

单位元，保留2位小数

tradeTime

string <date-time>

交易时间

可选

yyyy-MM-dd HH:mm:ss，如果为空，使用批次下的tradeTime

remark

string

交易备注

可选

status

integer

同步状态

可选

1 成功 2 失败(同步后在平台是失败状态)

failMsg

string

同步错误信息

可选

状态为2时，校验错误信息

示例

异常示例异常示例成功示例

{
    "code": 500,
    "msg": "服务商编码不能为空"
}

营销金结算批次订单查询(SFT0504)