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

展开

参数	是否必填	参数类型	描述
callbackUrl	是	String	结果回调地址，最大长度512。
acceptMercNo	是	String	分账接收方商户号。
acceptMercType	是	String	分账接收方商户身份。 01：平台 02：供应商 03：分销商 04：服务商 05：其他 06：入驻商家 07：门店 08：员工 09：店主 10：平台类商户/服务商 11：总部 12：品牌方
description	否	String	说明。
relationFileUrl	是	String	关系证明材料下载地址，此地址必须是公网地址且一次性地址。华为支付系统会通过异步去下载材料，下载失败会通过回调接口返回通知。
relationFileType	是	String	文件类型附件上传按钮，支持格式：zip、rar、jpg、png，最大支持20M。

请求示例

POST /api/v1/partner/allocation/receivers/add HTTP/1.1
Content-Type: application/json;charset=UTF-8
PayMercAuth: 
{"traceId":"189445492757762462","headerSign":"qzIR6PtuRJfLnHVFB6LNd230YfGJu48ym4w7OrvJrLNgYHvlBfTz2FdWkoaVxNHLJf3zcomUtTkiVM3********************MyTZtE3WDOLscnFUIB19EhijJ8MuiA8g0TFkeHxCN4SfQLezFSQ4l9zAC8/r4NCpsEJDyJj1vKsP0iO+Fy/R6gv/3zdQnnr5mghy2j7LocRovwsEZ9As1gZrJiYqfM1MJvQr5ACgAPlE9mhu/ush9tDPaU6/h9PTZLDe0ibPRwV4zE8vXYMXWvU=","bodySign":"MOaAqrzevXRXwtnkckvkxiw1H/FBYqDAJuBtugz4WRpki7znUnAEbfOxDPVpuRL********************MEJoxjPhi5hGg9pWPZy+Sum1rHrwUy2crytn4yFeYCi8gkd0M5KlY7sW6WrQWfMLTebuq9eiM3uMNI4y2i2RxitGIHDibzGDTqjcT7F3ItLifV/OpjQ4whxw5fz04UIVyT5pru/of7XjmKnMgtpYfAvvY/NkMOYjiIoEvsueX+Bku5Ejfx/Y1iI/BiFGFACk/o0wlo=","callerId":"10132120***","time":1690339281811,"authId":"120291744647139***"}
Accept: application/json
{
  "acceptMercNo": "101320000***",
  "acceptMercType": "01",
  "callbackUrl": "https://www.xxxxxx.com/hw/pay/callback/callback",
  "description": "String",
  "relationFileUrl": "https://xxxxxx/FileServer/getDisposableFile/dfa404d1e1f5e3bd664fafb9cbb55eeb94e54735f285e8828a0cae565daf85ea",
  "relationFileType": "png"
}

响应参数

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	商户号。
subMercNo	否	String	特约商户号或平台子商户号。
mercStatus	否	String	当前商户状态。 20：正常 30：冻结 40：销户 50：预销户
flowId	否	String	审批流程id。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
  "resultCode": "000000",
  "resultDesc": "success",
  "sign": "MEUCIGxB/k8Zibl1nApC9LbwymidgFD********************NoP+iMiNVg2XmKFXEeBUh67PRQSV5j5WTUjKSu2o=",
  "flowId": "20230726104121550001"
}

错误码

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

展开

resultCode	resultDesc	subCode	subDesc
400000	业务处理失败	INVALID_ARGUMENTS	参数不合法
400000	业务处理失败	MERC_NOT_SUPPORT_ALLOCATION	商户不支持分账
400000	业务处理失败	INVALID_MERC_NO	无效商户号
400000	业务处理失败	ALLOCATION_PERMISSIONS_LIMIT	商户暂无分账权限

更新分账上限比例

查询分账白名单

意见反馈

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

意见反馈

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

社区提问智能客服提问