承载协议	HTTPS POST
接口方向	开发者服务器-> 华为支付服务器
接口URL	https://petalpay-developer.cloud.huawei.com.cn/api/v2/contract/presign/app
数据格式	请求消息：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 Body

展开

参数	是否必选	类型	说明
appId	是	String	接入方应用ID。
planId	是	String	协议模板ID，该模板ID是商户在向华为支付提交代扣权限申请时由华为支付生成。
mercContractCode	是	String	商户签约协议号。商户请求签约时传入的签约协议号，商户侧须唯一。最大长度64。
mercNo	是	String	商户号。
callbackUrl	是	String	签约完成后的回调地址，最大长度为512。
payer	否	PayerIn	支付者信息。

请求示例

收起
自动换行
深色代码主题
复制
POST /api/v1/contract/presign/app
Content-Type: application/json;charset=UTF-8
PayMercAuth: {"callerId":"10132120***","traceId":"202305151026422776499","time":1684117602555,"authId":"120291744647139***","headerSign":"u+H1Oe3fXV9mGCES89XA7tSjp8+TELYgG4bKyECwrVGwwExHtdWTnKc4WvEpfjLzpzKE2/********************rMv6SBj/z0UcN9QrxXSeR8r6X46b7491N1jKg/lOG7eAFfwjEWJu5JyvY5KunSeE6DiKs=","bodySign":"yWDtXOBqDoItPgHmF57L6U5G7F/LhsILChu8YSpVV0HwRQCzdGAz53wDkC********************UWx7N6405QrcBimTcTN7pBpFA7pvFexUasPj10iUIFeaszpiRT2aQDaqLGaxvta6J5UxIUmAp+wGdV/juGEvQ="}
Accept: application/json
{
  "appId": "101831***",
  "callbackUrl": "https://www.xxxxxx.com/hw/pay/callback/callback",
  "mercContractCode": "2024020316555432***",
  "mercNo": "101723200xxx",
  "planId": "1***"
}

响应参数

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	签名值。用于开发者对响应报文进行防篡改验证。
preSignNo	是	String	预签约号。

响应示例

收起
自动换行
深色代码主题
复制
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
  "resultCode": "000000",
  "resultDesc": "Success.",
  "sign": "MEQCIEIWzdpziRyTi8vhwWHFuDdxfsiwOGSr6********************ljer0YAMabeCgTDG77e+2XJItvq/ZkIcCN5/B20pQ==",
  "preSignNo": "27713875*****"
}

错误码

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

展开

resultCode	resultDesc	subCode	subDesc
400000	业务处理失败	NO_MATCH_MATCHING_PRODUCT	未匹配到商户产品
400000	业务处理失败	INVALID_ARGUMENTS	参数不合法
400000	业务处理失败	INVALID_APPID	appId不匹配

签约代扣

元服务预签约

意见反馈

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

意见反馈

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

社区提问 AI 助手提问