跳到主要内容

pay.trans.{outTradeNo}.update-profit-share-info

重新设置分账方

  • 请求路由: pay.trans.{outTradeNo}.update-profit-share-info
  • 交互模型: Request Response
  • 访问限制: 无

请求​

RSocket.rr({
  "route" : "pay.CCO202311161153192837.update-profit-share-info",
  "args" : {
    "subOutTradeNo" : "CCO202311161153192837",
    "targets" : [
      {
        "targetType" : "PARTNER",
        "targetId" : "XXXXXXXXXXX@mzd",
        "targetName" : "张1",
        "description" : "合伙人分润",
        "amount" : 1
      },
      {
        "targetType" : "CHANNEL",
        "targetId" : "XXXXXX@mzd",
        "targetName" : "渠道9001",
        "description" : "渠道分润",
        "remark" : "该渠道享受特殊折扣0.3%",
        "amount" : 1
      }
    ],
    "discounts" : [
      {
        "id" : "CCB202403070938108",
        "type" : "coupon",
        "name" : "20元包车满减券",
        "amount" : 2000,
        "payer" : {
          "targetType" : "PLATFORM",
          "targetId" : "PLATFORM",
          "targetName" : "平台"
        }
      }
    ]
  }
});

请求参数​

名称类型必须说明
outTradeNoString是订单编号
subOutTradeNoString否子订单编号，子订单有多个时必须提供提供
targetsObject否新的分账方
targets.descriptionString否分账的原因描述，分账账单中需要体现
最长80个字符
targets.amountNumber否分账金额
仅当本次订单的分账金额与分账方配置不一致时提供
targets.manualSplitBoolean否是否手动分账
默认为false
targets.manualSplitPayTypeNumber否手动分账的支付类型
0 - 平台从订单收款方收账，再转给分账接收方，到达账期分账时将产生2笔线下支付;
1 - 订单收款方直接支付给分账接收方;
2 - 订单收款方直接支付给收分账接收方，且标记为已支付;
3 - 平台直接支付给收分账接收方，例如平台垫付优惠券成本等状况;
默认为0
targets.remarkString否详细备注信息
与description不同，description用于提交到微信平台，remark用于保存详细的业务备注
targets.accountingDateString否记账时间
用作与第三方对账时，与其会计期间匹配。
targets.targetTypeString否帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
targets.targetIdString否targetType下的帐户标识
targets.targetNameString否帐户名
discountsObject否折扣信息
discounts.idString否折扣标识，如优惠券id
discounts.typeString否折扣类型，例如"coupon"
discounts.nameString否折扣名称，如折扣券名称
discounts.amountNumber否折扣金额，单位：分
discounts.costNumber否折扣券购买价格，单位：分
discounts.refundNumber否该折扣项涉及的退款金额，单位：分
discounts.payerObject否折扣出资方
discounts.payer.targetTypeString否帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
discounts.payer.targetIdString否targetType下的帐户标识
discounts.payer.targetNameString否帐户名
discounts.extraObject否其他扩展属性

返回​

修改后的PrePsyRequest信息

{
  "appId" : "wxd0be3263c2bdd6bf",
  "openId" : "oKQgr46obJ_88888888xzqNjt2MA",
  "outTradeNo" : "CCO202311161153192837",
  "subOrders" : [
    {
      "subMchid" : "1658844586",
      "description" : "深圳-香港",
      "amount" : {
        "total" : 10,
        "currency" : "CNY"
      },
      "profitShareTargets" : [
        {
          "targetType" : "PARTNER",
          "targetId" : "18900010001@mzd",
          "targetName" : "张1",
          "description" : "合伙人分润",
          "amount" : 1
        },
        {
          "targetType" : "CHANNEL",
          "targetId" : "CH9001@mzd",
          "targetName" : "渠道9001",
          "description" : "渠道分润",
          "remark" : "该渠道享受特殊折扣0.3%",
          "amount" : 1
        }
      ],
      "discounts" : [
        {
          "id" : "CCB202403070938108",
          "type" : "coupon",
          "name" : "20元包车满减券",
          "amount" : 2000,
          "payer" : {
            "targetType" : "PLATFORM",
            "targetId" : "PLATFORM",
            "targetName" : "平台"
          }
        }
      ]
    }
  ]
}

返回属性​

名称类型说明
spMchidString微信支付平台的服务商标识
该标识为微信支付平台合作伙伴或者普通商户标识。仅当明确需要指定特定服务商来提供微信支付功能时，提供该参数。
未提供时，依据配置根据当前请求的客户端应用自动选取；
appIdString付款应用ID
由微信生成的应用ID，全局唯一。请求基础下单接口时请注意AppID的应用属性，例如公众号场景下，需使用应用属性为公众号的服务号AppID
openIdString付款方在应用中的openId
payerInfoObject付款方的平台帐户信息
在非线上支付等场景时，需要提供该参数
payerInfo.targetTypeString帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
payerInfo.targetIdStringtargetType下的帐户标识
payerInfo.targetNameString帐户名
outTradeNoString商户系统内部订单号
只能是数字、大小写字母_-*且在同一个商户号下唯一。
subOrdersObject[]子订单列表
至少1个条目。当条目多于1个时，请求合单支付
subOrders.[].outTradeNoString子订单号
仅当子订单数超过1个时，提供该参数指定子订单编号，一般使用主订单编号加数字后缀组成，例如：CCO202311281608193004-1,CCO202311281608193004-2
subOrders.[].subMchidString二级商户标识
支付给二级商户时必填。
subOrders.[].payeeInfoObject收款方的平台帐户信息
subOrders.[].payeeInfo.targetTypeString帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
subOrders.[].payeeInfo.targetIdStringtargetType下的帐户标识
subOrders.[].payeeInfo.targetNameString帐户名
subOrders.[].descriptionString商品描述
subOrders.[].timeExpireString订单失效时间
subOrders.[].profitShareTargetsObject[]指定本次订单的分账方
subOrders.[].profitShareTargets.[].descriptionString分账的原因描述，分账账单中需要体现
最长80个字符
subOrders.[].profitShareTargets.[].amountNumber分账金额
仅当本次订单的分账金额与分账方配置不一致时提供
subOrders.[].profitShareTargets.[].manualSplitBoolean是否手动分账
默认为false
subOrders.[].profitShareTargets.[].manualSplitPayTypeNumber手动分账的支付类型
0 - 平台从订单收款方收账，再转给分账接收方，到达账期分账时将产生2笔线下支付;
1 - 订单收款方直接支付给分账接收方;
2 - 订单收款方直接支付给收分账接收方，且标记为已支付;
3 - 平台直接支付给收分账接收方，例如平台垫付优惠券成本等状况;
默认为0
subOrders.[].profitShareTargets.[].remarkString详细备注信息
与description不同，description用于提交到微信平台，remark用于保存详细的业务备注
subOrders.[].profitShareTargets.[].accountingDateString记账时间
用作与第三方对账时，与其会计期间匹配。
subOrders.[].profitShareTargets.[].targetTypeString帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
subOrders.[].profitShareTargets.[].targetIdStringtargetType下的帐户标识
subOrders.[].profitShareTargets.[].targetNameString帐户名
subOrders.[].goodsTagString订单优惠标记
subOrders.[].amountObject支付金额信息
subOrders.[].amount.totalNumber支付金额，单位为分
subOrders.[].amount.currencyString标价币种，符合ISO 4217标准的三位字母代码
CNY：人民币，境内商户号仅支持人民币
subOrders.[].detailObject优惠功能
subOrders.[].detail.costPriceNumber订单原价
1、商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。
2、当订单原价与支付金额不相等，则不享受优惠。
3、该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。
subOrders.[].detail.invoiceIdString商家小票ID
subOrders.[].detail.goodsDetailObject[]单品列表信息
条目个数限制：【1，6000】
subOrders.[].detail.goodsDetail.[].merchantGoodsIdString商户侧商品编码
由半角的大小写字母、数字、中划线、下划线中的一种或几种组成。
subOrders.[].detail.goodsDetail.[].wechatpayGoodsIdString微信支付商品编码
微信支付定义的统一商品编号（没有可不传）
subOrders.[].detail.goodsDetail.[].goodsNameString商品的实际名称
subOrders.[].detail.goodsDetail.[].quantityNumber用户购买的数量
subOrders.[].detail.goodsDetail.[].unitPriceNumber商品单价
单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)
subOrders.[].discountsObject[]订单使用的折扣信息
subOrders.[].discounts.[].idString折扣标识，如优惠券id
subOrders.[].discounts.[].typeString折扣类型，例如"coupon"
subOrders.[].discounts.[].nameString折扣名称，如折扣券名称
subOrders.[].discounts.[].amountNumber折扣金额，单位：分
subOrders.[].discounts.[].costNumber折扣券购买价格，单位：分
subOrders.[].discounts.[].refundNumber该折扣项涉及的退款金额，单位：分
subOrders.[].discounts.[].payerObject折扣出资方
subOrders.[].discounts.[].payer.targetTypeString帐户类型
由调用方根据分账方身份类型定义，例如：COMPANY,PARTNER,CHANNEL等
subOrders.[].discounts.[].payer.targetIdStringtargetType下的帐户标识
subOrders.[].discounts.[].payer.targetNameString帐户名
subOrders.[].discounts.[].extraObject其他扩展属性
subOrders.[].extraObject扩展信息，下游应用可以传递关联业务数据以便据此进行汇总统计
contextDataObject支付订单上下文信息，这些信息会在支付回调中被传递
supportFapiaoBoolean电子发票入口开放标识
传入true时，支付成功消息和支付详情页将出现开票入口。
需要在微信支付商户平台或微信公众平台开通电子发票功能，传此字段才可生效。
prepayIdString针对同一个订单重复支付时，提交之前返回的prepayId
sceneInfoObject支付场景描述
sceneInfo.payerClientIpString用户的客户端IP
支持IPv4和IPv6两种格式的IP地址。
sceneInfo.deviceIdString商户端设备号（门店号或收银设备ID）
sceneInfo.storeInfoObject商户门店信息
sceneInfo.storeInfo.idString商户侧门店编号
sceneInfo.storeInfo.nameString商户侧门店名称
sceneInfo.storeInfo.areaCodeString地区编码，详细请见省市区编号对照表。
sceneInfo.storeInfo.addressString详细的商户门店地址
isCreditBoolean是否记账(月结)账户

下载结果模型定义