HarmonyOS 鸿蒙Next预下单接口咨询

HarmonyOS 鸿蒙Next预下单接口咨询 【问题描述】：查看官网 平台类商户/服务商预下单接口https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-partner-pas-prepay，对请求参数有些疑问，平台服务商和子商户的请求参数，哪些字段不一样，是否有具体的示例，文档中只有一个请求示例，不知道是服务商的请求示例还是子商户的请求示例，参数比较多，理解起来比较复杂，能否分别写两个示例，具体哪些参数不同。希望文档可以优化一下

【问题现象】：

POST /api/v1/partner/aggr/pay-and-sign/preorder/create/app HTTP/1.1
Content-Type: application/json;charset=UTF-8
PayMercAuth: {"callerId":"10132120***","traceId":"202305151026422776499","time":1684117602555,"authId":"120291744647139***","headerSign":"u+H1Oe3fXV9mGCES89XA7tSjp8+TELYgG4bKyECwrVGwwExH********************g/lOG7eAFfwjEWJu5JyvY5KunSeE6DiKs=","bodySign":"yWDtXOBqDoItPgHmF57L6U5G7F/Lh********************IFeaszpiRT2aQDaqLGaxvta6J5UxIUmAp+wGdV/juGEvQ="}
Accept: application/json

{
 "spAppId": "5765880207853***",
 "subAppId": "5765880207853***",
 "spMercNo": "10132120***",
 "subMercNo": "10193600***",
 "mercOrderNo": "czl00120240705***",
 "tradeSummary": "xx商城-手机",
 "totalAmount": 2,
 "currency": "CNY",
 "callbackUrl": "https://www.xxxxxx.com/hw/pay/callback",
 "payload": "example-payload",
 "expireTime": "2023-03-28T17:50:12.000+0800",
 "contractInfo": {
    "planId": "1***",
    "mercContractCode": "2024020316555432***",
    "callbackUrl": "https://www.xxxxxx.com/hw/sign/callback"
  }
}

【版本信息】：不涉及

【复现代码】：不涉及

【尝试解决方案】：不涉及


更多关于HarmonyOS 鸿蒙Next预下单接口咨询的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

HarmonyOS Next预下单接口采用ArkTS语言开发，基于分布式能力实现跨设备业务协同。该接口属于系统能力接口，需在module.json5中声明ohos.permission.DISTRIBUTED_DATASYNC权限。接口通过分布式数据管理实现多端数据同步，调用时将生成全局唯一的订单标识符。具体接口方法包括：createPreOrder()用于创建预订单，setDistributedData()实现数据跨设备流转。开发时需配置正确的分布式设备组网，并确保设备间认证通过。

更多关于HarmonyOS 鸿蒙Next预下单接口咨询的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next的支付预下单接口中，平台服务商和子商户的主要参数差异体现在商户身份标识字段上。以下是具体说明：

平台服务商请求示例： 关键参数为spMercNo（平台服务商商户号），subMercNo通常为空或填写默认值。例如：

{
  "spAppId": "5765880207853***",
  "subAppId": "5765880207853***", 
  "spMercNo": "10132120***",
  "subMercNo": "",
  "mercOrderNo": "czl00120240705***",
  "tradeSummary": "xx商城-手机",
  "totalAmount": 2
}

子商户请求示例： 必须同时填写spMercNo（所属平台服务商）和subMercNo（子商户自身商户号）：

{
  "spAppId": "5765880207853***",
  "subAppId": "5765880207853***",
  "spMercNo": "10132120***", 
  "subMercNo": "10193600***",
  "mercOrderNo": "czl00120240705***",
  "tradeSummary": "xx商城-手机", 
  "totalAmount": 2
}

核心区别：

  • 平台服务商：subMercNo可为空，交易计入平台服务商账户
  • 子商户：必须准确填写subMercNo，交易计入指定子商户账户
  • 其他参数如appId、订单信息等字段要求基本一致

文档中的示例实际展示了子商户的请求场景，因为同时包含了平台服务商和子商户的商户号。建议在实际调用时根据商户身份类型正确设置这两个关键参数。

回到顶部