多码合一并笔订单交易回调通知

最新更新时间：2023.06.13

回调通知多码合一并笔订单交易结果。

温馨提示：
1.若在并笔订单交易接口中未给notifyUrl参数赋值，则不会触发该通知。
2.建议使用并笔订单交易查询接口作为辅助，确认订单最终交易状态。

---

接口说明

请求URL： 在并笔订单交易接口中所传的notifyUrl

请求方式： POST

业务请求参数

名称	必传	类型	说明
ownerMergeNo	是	string	商户自传的合并交易订单号
osMergeNo	是	string	开放平台的合并交易订单号（开放平台内唯一）
subOrders	是	List	子单交易结果
↪ ownerTradeNo	是	string	第三方商户创建的唯一订单号
↪ osTradeNo	是	string	开放平台交易记录唯一订单号（开放平台内唯一）
↪ tpTradeNo	是	string	该笔交易记录在支付机构(支付宝/微信)的订单号
↪ tradeStatus	是	string	交易状态 WAIT：交易创建，等待买家付款；SUCCESS: 支付成功；SUCCESS_PART_REFUND: 支付成功有部分退款；SUCCESS_FULL_REFUND: 支付成功全额退款；FAILURE：支付失败（包含用户取消支付、超时关闭）；CLOSE：已关闭，订单超过操作时限
↪ orderFee	是	int	该笔订单的资金总金额 单位为分
↪ paymentFee	是	int	交易的用户实付金额 单位为分
↪ remark	是	string	商户给开放平台的的附加数据，支付平台原封不动返回
↪ osMerchantCode	是	string	平台分配商户编号
↪ osStoreCode	是	string	门店编号
↪ createdTime	是	long	交易下单时间，时间戳，标准北京时间
↪ payTime	是	long	用户完成支付的时间，时间戳，标准北京时间
↪ payChannel	是	string	支付渠道 ALI_PAY：支付宝，WX_PAY：微信
↪ payProduct	是	string	支付产品类型 APP：手机App客户端，MINI_APP：小程序，M_WEB：手机网页支付，PC_WEB：电脑网页支付，USER_QR：用户扫描商家二维码支付，MCH_QR：商家扫描用户付款码支付，FACE：刷脸付
↪ title	是	string	支付标题
↪ callbackUrl	否	string	回调地址，请求交易下单传参则有值
↪ refundFee	是	int	退款金额，单位为分
↪ payBusiness	否	string	业务类型，请求交易下单传参则有值
↪ ownerBusinessNo	否	string	商户维护:商户创建的订单业务号，商户自传，支付回调原封返回
↪ ownerPayTerminal	否	string	商户支付终端，商户自传，支付回调原封返回
↪ ownerAppBuyerId	否	string	商户应用对应用户ID,openId
↪ buyerLoginId	否	string	买家在支付机构的登录账号

公共响应参数

名称	必传	类型	说明
code	是	int	请求结果code，成功返回8888,详细请参考错误码说明)
msg	是	string	请求结果描述，失败时会返回错误原因
data	否	Object	请求结果返回的业务响应参数，若无业务参数则返回空

注意：若成功接收到回调，请按照响应参数要求返回。若平台接收不到响应成功的参数，则会间隔一段时间后重复通知。

业务响应参数

无

入参格式

{
  "code": 8888,
  "msg": "处理成功",
  "data": {
    "ownerMergeNo": null,
    "osMergeNo": "os_merge_20211126",
    "subOrders": [
      {
        "ownerTradeNo": "owner_merge_17830263201019",
        "tpTradeNo": "tp_merge_25775531258369",
        "osTradeNo": "os_merge_25775531250618",
        "tradeStatus": "WAIT",
        "orderFee": 1,
        "paymentFee": 2,
        "remark": null,
        "osMerchantCode": "2163737276721967",
        "osStoreCode": "123",
        "createdTime": 1637998177598,
        "payTime": 1637998191002,
        "payChannel": "WX_PAY",
        "payProduct": "USER_QR",
        "title": "iPhone13 Pro Max",
        "callbackUrl": null,
        "refundFee": 0,
        "payBusiness": null
      },
      {
        "ownerTradeNo": "owner_merge_19831263201019",
        "tpTradeNo": "os_merge_25531263201019",
        "osTradeNo": "os_merge_25531263201281",
        "tradeStatus": "WAIT",
        "orderFee": 2,
        "paymentFee": 2,
        "remark": null,
        "osMerchantCode": "2163737276721967",
        "osStoreCode": "123",
        "createdTime": 1637998177598,
        "payTime": 1637998191002,
        "payChannel": "WX_PAY",
        "payProduct": "USER_QR",
        "title": "iPhone12 Pro Max",
        "callbackUrl": null,
        "refundFee": 0,
        "payBusiness": null
      }
    ]
  },
  "error": null
}

出参格式：

{
  "code": 8888,
  "msg": "处理成功",
  "data": null
}

code 为 8888 表示操作成功，其它值则为失败，具体内容参见错误码说明)。