文档管理中心
您当前正在浏览HarmonyOS最新文档,覆盖已发布的所有API版本,可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明

通过combinedSysTransOrderNo查询订单信息

功能介绍

开发者可以调用此接口查询已经在华为支付创建成功的合单支付订单详细信息。

说明

resultCode返回“000000”表示查询支付订单成功,不代表支付订单成功,订单状态需根据orderStatus字段判断。

场景描述

用户已完成合单支付,开发者调此接口获取合单支付订单信息。

接口原型

  • 承载协议: HTTPS GET

  • 接口方向: 开发者服务器 -> 华为支付服务器

  • 接口URL: https://petalpay-developer.cloud.huawei.com.cn/api/v2/partner/combined/transactions/orders/{combinedSysTransOrderNo}

  • 数据格式:

    请求消息:Content-Type: application/json

    响应消息:Content-Type: application/json

请求参数

Request Header

展开
参数 是否必选 参数类型 描述
Content-Type String 取值为:application/json; charset=UTF-8
PayMercAuth String 取值为:PayMercAuth的JSON字符串

request path

展开
参数 是否必选 参数类型 描述
combinedSysTransOrderNo String 华为支付合单支付主订单号。

请求示例

收起
自动换行
深色代码主题
复制
  1. GET /api/v2/partner/combined/transactions/orders/{combinedSysTransOrderNo} HTTP/1.1
  2. Content-Type: application/json;charset=UTF-8
  3. PayMercAuth:
  4. {"callerId":"10132120***","traceId":"202305151047588466083","time":1684118878350,"authId":"120291744647139***","headerSign":"4Xb1tDGRC4f/B58ANIF6sa/Y2p8Eh4EXO7TpmBKrc********************TesmPGdszSNP/s=","bodySign":"kf9AZmVjBSGUI2MldsIFShO+Ak******************lQ0Q95/dZt2jEHcXyLfGNVzDNfFPhvF08NnnGM4="}

响应参数

Response Header

展开
参数 是否必选 参数类型 描述
Content-Type String 取值为:application/json; charset=UTF-8

Response Body

展开
参数 是否必选 参数类型 描述
resultCode String 结果码,"000000"表示成功,其他表示失败。
resultDesc String 结果描述。
subCode String 业务错误码。
subDesc String 业务错误描述信息。
sign String 签名值。用于开发者对响应报文进行防篡改验证。
combinedSysTransOrderNo String 华为支付合单支付交易订单号。
combinedMercOrderNo String 合单支付商户主订单号,由商户在创建合单支付订单时生成,商户需保证订单信息唯一性。最大长度46。
combinedAppId String 商户申请并关联的应用id。
orderStatus String

订单状态。

- TRX_SUCCESS:交易成功

- TRX_FAILED:交易失败

- TRX_APPLY:交易处理中

- TRX_PROC:交易处理中

payload String 合单商户下单时传入的预留字段,原样返回。
subOrders List<SubOrderResult> 合单支付子订单信息。
payer PayerOut 用户支付时客户端信息。

响应示例

收起
自动换行
深色代码主题
复制
  1. HTTP/1.1 200 OK
  2. Content-Type: application/json; charset=UTF-8
  3. {
  4. "resultCode": "000000",
  5. "resultDesc": "Success.",
  6. "sign": "MEYCIQDOsSJ5gL9mcYKi9usz4I/u********************77jclylTWJOTThPxOdJs+2zsDv3sg38UY/Wy",
  7. "combinedSysTransOrderNo": "12407030857530004914518***",
  8. "payload": "example-payload",
  9. "combinedMercOrderNo": "czl00120240705***",
  10. "orderStatus": "TRX_SUCCESS",
  11. "subOrders": [
  12. {
  13. "sysTransOrderNo": "12407030857530004914518***",
  14. "mercOrderNo": "czl00120240705***",
  15. "orderStatus": "TRX_SUCCESS",
  16. "payload": "example-payload",
  17. "currency": "CNY",
  18. "totalAmount": 40,
  19. "payerAmount": 1,
  20. "paymentTools": "AGMT"
  21. }
  22. ]
  23. }

错误码

resultCode非400000的错误码请查看公共错误码说明

展开
返回码 错误码 错误描述 解决方案
400000 UNKNOW_ERROR 服务暂不可用,请稍后重试 稍后重试。
400000 INVALID_ARGUMENTS 参数不合法 检查请求参数。
400000 PAY_ORDER_NOT_EXIST 支付订单号不存在 检查入参订单号是否正确。
400000 MERC_ORDER_NOT_EXIST 商户订单号不存在 检查入参订单号是否正确。
400000 INVALID_MERCNO 无效商户号 检查入参商户号是否正确。
400000 CHECK_ORDER_STATUS 订单状态异常 请检查是否使用相同订单重复下单。
在 API参考 中进行搜索
请输入您想要搜索的关键词