快应用预签约

功能介绍

调用此接口获取预签约号（preSignNo）,返回给商户快应用入参拉起华为支付签约收银台。

接口原型

请求参数

• Request Header

  参数	是否必选	参数类型	描述
  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/quick-app
  Content-Type: application/json;charset=UTF-8
  PayMercAuth: {"callerId":"10132120***","traceId":"202305151026422776499","time":1684117602555,"authId":"120291744647139***","headerSign":"u+H1Oe3fXV9mGCES89XA7tSjp8+TELYgG4bKyECwrVGwwExHtdWTnKc4WvEpfjLzpzKE2/+********************v6SBj/z0UcN9QrxXSeR8r6X46b7491N1jKg/lOG7eAFfwjEWJu5JyvY5KunSeE6DiKs=","bodySign":"yWDtXOBqDoItPgHmF57L6U5G7F/LhsILChu8YSpVV0HwRQCzdGAz53w********************McUWx7N6405QrcBimTcTN7pBpFA7pvFexUasPj10iUIFeaszpiRT2aQDaqLGaxvta6J5UxIUmAp+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

• 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********************jer0YAMabeCgTDG77e+2XJItvq/ZkIcCN5/B20pQ==",
    "preSignNo": "27713875*****"
  }

错误码

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