承载协议	HTTPS GET
接口方向	开发者服务器-> 华为支付服务器
接口URL	https://petalpay-developer.cloud.huawei.com.cn/api/v2/aggr/transactions/orders/{sysTransOrderNo}
数据格式	请求消息：Content-Type: application/json 响应消息：Content-Type: application/json

请求参数

Request Header
展开
参数

是否必选

参数类型

描述

Content-Type

是

String

取值为：application/json; charset=UTF-8

PayMercAuth

是

String

取值为：PayMercAuth的JSON串

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

request path
展开
参数

是否必填

参数类型

描述

sysTransOrderNo

是

String

华为支付系统订单号。

参数	是否必填	参数类型	描述
sysTransOrderNo	是	String	华为支付系统订单号。

请求示例

收起
自动换行
深色代码主题
复制
GET /api/v2/aggr/transactions/orders/{sysTransOrderNo} HTTP/1.1
Content-Type: application/json;charset=UTF-8
PayMercAuth: 
{"callerId":"10132120***","traceId":"202305151047588466083","time":1684118878350,"authId":"120291744647139***","headerSign":"4Xb1tDGRC4f/B58ANIF6sa/Y2p8Eh4EXO7TpmBKrcSm********************hLipE8aZ0Ti6IB7idVf1Oi4P93Jn8MdFNExStZJVpRaTNOeN0znmsDJOALXgvh/RKeReQBbc4lXZp5wnyZmdwTesmPGdszSNP/s=","bodySign":"kf9AZmVjBSGUI2MldsIFShO+Ak00qpPKaXgJo+KnubAcMEY8hy1ij59nr5n+uvtmPSZlus0aA3hoMuVwN1TPo6********************dghaJShhzAsNjt8DE9ulUIlQ0Q95/dZt2jEHcXyLfGNVzDNfFPhvF08NnnGM4="}

响应参数

Response Header
展开
参数

是否必选

参数类型

描述

Content-Type

是

String

取值为：application/json; charset=UTF-8

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

Response Body

展开

参数	是否必选	参数类型	描述
resultCode	是	String	结果码，"000000"表示成功，其他表示失败。
resultDesc	是	String	结果描述。
subCode	否	String	业务错误码。
subDesc	否	String	业务错误描述信息。
sign	是	String	签名值。用于开发者对响应报文进行防篡改验证。
mercNo	否	String	商户号。
appId	否	String	应用ID。
sysTransOrderNo	否	String	华为支付系统订单号。
mercOrderNo	否	String	商户订单号，由商户自己生成，商户需保证订单信息唯一性。最大长度46。
orderStatus	否	String	订单状态。 TRX_SUCCESS：交易成功 TRX_FAILED：交易失败 TRX_APPLY：交易处理中 TRX_PROC：交易处理中
payload	否	String	预留信息，如商户请求时传递该参数，此时会原样返回。
currency	否	String	交易币种单位，最大长度为3。 CNY （默认）
totalAmount	否	long	订单总金额，单位：分。
payerAmount	否	long	买家实付金额，单位：分。
promotionAmount	否	long	优惠金额，单位：分。
finishTime	否	String	支付完成时间，UTC时间格式（yyyy-MM-dd'T'HH:mm:ss.SSSZ）。
paymentTools	否	String	支付工具。 WECHAT_MICROPAY：微信小程序支付 AGMT：快捷 ACCT：账户余额 UNIONPAY：云闪付 TRANSFER_PAY：转账支付
promotionDetail	否	List<PromotionItem>	营销信息。
payer	否	PayerOut	用户支付时客户端信息。

响应示例

收起
自动换行
深色代码主题
复制
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
    "resultCode": "000000",
    "resultDesc": "Success.",
    "sign": "MEQCIGYfDEcfhJMNex7C2coqJs0OKe9R********************T05ysqML9rExWubEpySCe+vnuHsSJbitk/Zkdlg==",
    "appId": "5765880207853***",
    "payer": {
        "openId": "600245669***"
    },
    "sysTransOrderNo": "12407030857530004914518***",
    "mercOrderNo": "czl00120240705***",
    "orderStatus": "TRX_SUCCESS",
    "payload": "example-payload",
    "currency": "CNY",
    "totalAmount": 100000,
    "payerAmount": 80000,
    "promotionAmount": 200,
    "finishTime": "2023-11-28T10:14:04.000+0800",
    "paymentTools": "AGMT",
    "promotionDetail": [
        {
            "promotionId": "1135261045***",
            "promotionType": "COUPON",
            "promotionAmount": 100,
            "promotionStatus": "PROMO_SUCCESS"
        },
        {
            "promotionId": "071752834***",
            "promotionAmount": 100,
            "promotionStatus": "PROMO_SUCCESS"
        }
    ]
}

错误码

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

展开

resultCode	resultDesc	subCode	subDesc
400000	业务处理失败	UNKNOW_ERROR	系统未知错误，请稍后重试或联系华为工程师处理
400000	业务处理失败	INVALID_ARGUMENTS	参数不合法
400000	业务处理失败	PAY_ORDER_NOT_EXIST	支付订单号不存在
400000	业务处理失败	MERC_ORDER_NOT_EXIST	商户订单号不存在
400000	业务处理失败	INVALID_MERCNO	无效商户号
400000	业务处理失败	CHECK_ORDER_STATUS	订单状态异常

查询代扣订单

商户订单号查询代扣订单

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问