11.1.8 微信分代扣 - 易企通2.0

1、登记扣款成功后，调用本接口发起代扣。
2、本接口为受理接口，返回成功代表受理成功，需要等待通知订单终态，或调4.1.5发起代扣结果查询。
3、针对同一笔微信分服务单，在明确代扣失败的情况下，可以重复发起代扣，但是需要通过11.1.6登记扣款信息接口重新登记扣款，获得新的扣款单号（outTrace），并在代扣请求中使用新的扣款单号（oriOutTrace）发起再次扣款（orgTrace也需要更换）。

注意：测试环境无法进行代扣。

请求参数

Body 参数application/json

请求参数

reqBody

object (WxEntrustWithholdRequestVO)

必需

reqInfo

object (ReqInfo)

请求方信息

必需

reqOrderInfo

object (ReqOrderInfo)

基础订单信息

必需

基础订单信息

payInfo

object

支付信息

必需

wxBizParam

object (WxEntrustWithholdBizParam)

必需

settleParamInfo

object (SettleParamInfo)

清算信息

必需

marketingOrders

array[object (营销单) {7}]

营销信息

可选

separateInfo

object (TradeSeparateInfo)

分账信息

可选

暂不支持

otherParamInfo

object (OtherParamInfo)

其他信息

可选

其他信息

riskData

object (RiskData)

合规信息

必需

合规信息

示例

{
    "reqBody": {
        "reqInfo": {
            "mchtCode": "string",
            "termCode": "string"
        },
        "reqOrderInfo": {
            "orgTrace": "string",
            "oriOutTrace": "string",
            "backUrl": "string",
            "orderSub": "string",
            "transAmount": 0,
            "timeout": "string",
            "orderDes": "string",
            "orgInfo": "string",
            "returnRate": true
        },
        "payInfo": {
            "bizScen": "string",
            "bizType": "string",
            "payType": "string",
            "transDate": "string"
        },
        "wxBizParam": {
            "transScene": "string",
            "areaInfo": "string",
            "subAppId": "string",
            "subOpenId": "string",
            "sceneInfo": {
                "storeCode": "string",
                "storeName": "string",
                "address": "string",
                "areaCode": "string"
            },
            "detail": {
                "costPrice": 0,
                "receiptId": "string",
                "goodsDetail": [
                    {
                        "goodsId": "string",
                        "wxpayGoodsId": "string",
                        "goodsName": "string",
                        "quantity": 0,
                        "price": 0
                    }
                ]
            },
            "attach": "string",
            "businessCategory": "string",
            "currency": "string",
            "goodsTag": "string",
            "openId": "string"
        },
        "settleParamInfo": {
            "delaySettleFlag": "0",
            "patnerSettleFlag": "0",
            "splitSettleFlag": "0"
        },
        "marketingOrders": [
            {
                "activityId": 1,
                "marketingCurrency": "str",
                "marketingExtInfo": {},
                "marketingTransAmount": 1,
                "mchtCode": "string",
                "registrationId": 10000000000000000000,
                "termCode": "string"
            }
        ],
        "separateInfo": {
            "separaBatchTrace": "string",
            "transSumCount": 0,
            "transSumAmt": 0,
            "separateOrderDetailList": [
                {
                    "separateTrade": "string",
                    "body": "string",
                    "subject": "string",
                    "sepaTransAmount": 1,
                    "isD0": "s",
                    "sepaRatio": 1,
                    "receiveMchtCode": "string",
                    "receiveTermCode": "string",
                    "sepaFeeAmount": 0,
                    "sepaFeeRatio": 0
                }
            ]
        },
        "otherParamInfo": {
            "handlingFee": 0,
            "orgSmerCode": "string",
            "orgSterminalCode": "string",
            "otherFee": "string",
            "customInfo": "string",
            "smallMchtCode": "string",
            "projectId": "string"
        },
        "riskData": {
            "customerIp": "string",
            "terminalInfo": {
                "terminalType": "st",
                "terminalIp": "string",
                "location": "string",
                "networkLicense": "strin",
                "serialNum": "string",
                "terminalId": "string",
                "encryptRandNum": "string",
                "secretText": "string",
                "appVersion": "string",
                "ctryNo": "st",
                "areaNo": "string",
                "mobileCountryCd": "str",
                "mobileNetNum": "st",
                "iccId": "stringstringstringst",
                "locationCd1": "stri",
                "lbsNum1": "string",
                "lbsSignal1": "stri",
                "locationCd2": "stri",
                "lbsNum2": "string",
                "lbsSignal2": "stri",
                "locationCd3": "stri",
                "lbsNum3": "string",
                "lbsSignal3": "stri",
                "telecomSysId": "stri",
                "telecomNetId": "stri",
                "telecomLbs": "stri"
            }
        }
    }
}

返回响应

🟢200OK

application/json

Body

rspBody

object (WxEntrustWithholdResponseVO)

可选

marketingRespParamInfoList

array[object (营销单返回) {9}]

营销信息

可选

respOrderInfo

object (TradeQueryRespOrderInfo)

查询信息

可选

respStateInfo

object (RespStateInfo)

可选

riskParamInfo

object (RiskInfo)

可选

settleRespParamInfo

object (SettleRespParamInfoVO)

可选

wxRespParamInfo

object (WxQueryRespParamInfoVO)

可选

rspHeader

object (RspHeader)

应答头

可选

rspCode

string

应答码

可选

rspInfo

string

应答消息

可选

transCode

string

交易代码

可选

transSequence

string

交易流水

可选

easyPayCertificateId

string

易生证书id

可选

示例

{
    "rspBody": {
        "marketingRespParamInfoList": [
            {
                "activityId": 0,
                "currency": "string",
                "marketingBusinessSceneCode": "string",
                "marketingPayAbilityCode": "string",
                "marketingPayMethodCode": "string",
                "registrationId": 0,
                "respMarketingExtInfo": {
                    "property1": {},
                    "property2": {}
                },
                "transAmount": 0,
                "upOrderNo": "string"
            }
        ],
        "respOrderInfo": {
            "productTrace": "string",
            "mchtRateList": [
                {
                    "feeId": 0,
                    "mchtCode": "string",
                    "calcType": "string",
                    "calcVal": "string",
                    "feeHighLimit": "string",
                    "feeLowLimit": "string",
                    "amtHighLt": "string",
                    "amtLowLt": "string",
                    "cardType": "string",
                    "cardIssuerCode": "string",
                    "feeCalcMode": "string",
                    "feeInst": "string",
                    "instalNum": 0,
                    "levelOrder": "string",
                    "addCalcType": "string",
                    "addCalcVal": "string",
                    "billingCycle": "string",
                    "effDatetime": "string",
                    "expDatetime": "string",
                    "isRefundFee": "string",
                    "feeMode": "string",
                    "feeType": "string",
                    "isNeedConfigFee": true,
                    "payMethodCode": "string",
                    "businessSceneCode": "string",
                    "payAbilityCode": "string"
                }
            ],
            "orgTrace": "string",
            "outTrace": "string",
            "pcTrace": "string",
            "unTrace": "string",
            "transAmount": 0,
            "separateAmountSum": 0,
            "refundAmountSum": 0,
            "stlmAmountSum": 0,
            "dateEnd": "string",
            "timeEnd": "string",
            "payAmount": 0,
            "stlmAmount": 0,
            "userId": "string",
            "cardType": "string"
        },
        "respStateInfo": {
            "appendRetCode": "string",
            "appendRetMsg": "string",
            "respCode": "string",
            "respDesc": "string",
            "transState": "string",
            "transStatusDesc": "string"
        },
        "riskParamInfo": {
            "terminalIp": "string",
            "terminalLocation": "string"
        },
        "settleRespParamInfo": {
            "settleAmt": 0,
            "finalAmt": 0,
            "settleDate": "string",
            "settleTime": "string",
            "delaySettleFlag": "string",
            "patnerSettleFlag": "string",
            "splitSettleFlag": "string"
        },
        "wxRespParamInfo": {
            "openId": "string",
            "subOpenId": "string",
            "cardIssuerCode": "string",
            "wxDiscountsInfo": {
                "discountsInfo": [
                    {
                        "promotionId": "string",
                        "name": "string",
                        "scope": "string",
                        "type": "string",
                        "amount": 0,
                        "activityId": "string",
                        "wxpayContribute": 0,
                        "merchantContribute": 0,
                        "otherContribute": 0,
                        "currency": "string",
                        "goodsDetail": {
                            "goodsId": "string",
                            "goodsRemark": "string",
                            "discountAmount": 0,
                            "goodsName": "string",
                            "quantity": 0,
                            "price": 0
                        }
                    }
                ],
                "couponAmount": 0
            },
            "attach": "string"
        }
    },
    "rspHeader": {
        "rspCode": "string",
        "rspInfo": "string",
        "transCode": "string",
        "transSequence": "string",
        "easyPayCertificateId": "string"
    }
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found