承载协议 | HTTPS POST |
|---|---|
接口方向 | 开发者服务器-> 华为支付服务器 |
接口URL | https://petalpay-developer.cloud.huawei.com.cn/api/v2/aggr/preorder/create/app |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 取值为:application/json; charset=UTF-8 |
PayMercAuth | 是 | String | 取值为:PayMercAuth的JSON串 |
参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
appId | 是 | String | 接入方应用ID。 |
mercOrderNo | 是 | String | 商户订单号,由商户自己生成,商户需保证订单信息唯一性。最大长度46。 |
mercNo | 是 | String | 商户号。最大长度12。 |
tradeSummary | 是 | String | 交易的摘要。格式建议:“商户应用名称-商品描述”。最大长度128。 |
totalAmount | 是 | long | 订单金额,必须为大于0的整数值,单位:分。 |
currency | 否 | String | 交易币种单位,最大长度为3。
|
goodsDetail | 否 | List<GoodDetail> | 订单详细信息列表。 |
allocationType | 否 | String | 分账类型。
注意: 使用该字段需联系开发者的商户对接人协助申请开通分账能力。分账相关操作参见分账交易管理。 |
callbackUrl | 是 | String | 回调通知地址,通知URL必须为外网环境可直接访问的URL,要求为https地址。具体要求参考通知回调接口说明。最大长度为512。 |
payload | 否 | String | 商户预留信息,在查询和回调通知时会原样返回。最大长度255。 |
expireTime | 否 | String | 交易过期时间。此时间必须为准确的UTC时间。 格式要求:"yyyy-MM-dd'T'HH:mm:ss.SSSZ" 。 说明:
/** * 获取UTC格式的过期时间 * @param expectedExpiredTime 交易过期时间,请换算为分钟 * @return UTC时间 */ private static String getTradeExpireTime(int expectedExpiredTime) { SimpleDateFormat formater = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ"); formater.setTimeZone(TimeZone.getTimeZone("UTC")); Calendar calendar = Calendar.getInstance(); calendar.set(Calendar.MINUTE, calendar.get(Calendar.MINUTE) + expectedExpiredTime); return formater.format(calendar.getTime()); } |
payer | 否 | 支付者信息。 | |
selectPromotions | 否 | 平台券信息。 |
POST /api/v2/aggr/preorder/create/app
Content-Type: application/json;charset=UTF-8
PayMercAuth: {"callerId":"10132120***","traceId":"202305151026422776499","time":1684117602555,"authId":"120291744647139***","headerSign":"u+H1Oe3fXV9mGCES89XA7tSjp8+TELYgG4bKyECwrVGwwExHtdWTnKc4WvEpfjLzpzKE2/+KY********************cN9QrxXSeR8r6X46b7491N1jKg/lOG7eAFfwjEWJu5JyvY5KunSeE6DiKs=","bodySign":"yWDtXOBqDoItPgHmF57L6U5G7F/LhsILChu8YSpVV0HwRQCzdGAz53wDkCRLiAEVGDDu6E6KxPAHE0TIkTxHMcUWx7N6405Q********************FexUasPj10iUIFeaszpiRT2aQDaqLGaxvta6J5UxIUmAp+wGdV/juGEvQ="}
Accept: application/json
{
"appId": "101831***",
"mercOrderNo": "202303281684117601***",
"mercNo": "101723200xxx",
"tradeSummary": "Mate50 手机",
"totalAmount": 2,
"currency": "CNY",
"callbackUrl": "https://www.xxxxxx.com/hw/pay/callback",
"payload": "example-payload",
"expireTime": "2023-03-28T17:50:12.000+0800"
} 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 取值为:application/json; charset=UTF-8 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
resultCode | 是 | String | 返回码,"000000"表示成功,其他表示见错误码。 |
resultDesc | 是 | String | 结果描述。 |
subCode | 否 | String | 业务错误码。 |
subDesc | 否 | String | 业务错误描述信息。 |
sign | 是 | String | 签名值。用于开发者对响应报文进行防篡改验证。 |
prepayId | 是 | String | 预下单Id。 |
mercOrderNo | 否 | String | 商户订单号。 |
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"resultCode": "000000",
"resultDesc": "Success.",
"sign": "MEQCIEIWzdpziRyTi8vhwWHFuDdxfsiwO********************eCgTDG77e+2XJItvq/ZkIcCN5/B20pQ==",
"prepayId": "1230515104757089051032517***",
"mercOrderNo": "202303281684118876***"
} (resultCode非400000的错误码请看公共错误码说明)
resultCode | resultDesc | subCode | subDesc |
|---|---|---|---|
400000 | 业务处理失败 | UNKNOW_ERROR | 系统未知错误,请稍后重试或联系华为工程师处理 |
400000 | 业务处理失败 | INVALID_ARGUMENTS | 参数不合法 |
400000 | 业务处理失败 | INVALID_MERCNO | 无效商户号 |
400000 | 业务处理失败 | REJECTED_BY_RISK_CONTROL | 风控拒绝 |
400000 | 业务处理失败 | NO_MATCH_MATCHING_PRODUCT | 未匹配到商户产品 |
400000 | 业务处理失败 | CHECK_ORDER_STATUS | 订单状态异常 |
400000 | 业务处理失败 | BANK_CARD_NOT_SUPPORT | 银行卡不支持 |
400000 | 业务处理失败 | INVALID_APPID | appId不匹配 |