目录

发起免密代扣

功能介绍

调用此接口发起代扣服务,鸿蒙支付服务会直接从用户账户扣除相应的服务费用。

使用约束

换单重试,视为新的业务订单,需开发者自行将新的业务订单关联业务原订单。接口重入规则说明如下(供参考):

重入判定字段

支持原单重入场景

建议换单重试场景

商户订单号

(mercOrderNo)

  1. 代扣请求接口失败,根据错误码排查后,支持原商户订单号重试。
  2. 代扣请求接口成功,原商户订单号重入,接口幂等返回。该笔订单状态以异步结果通知或同步查询接口里为准。

代扣请求成功,代扣订单查询或代扣回调通知扣款状态为TRX_FAILED,则订单进入失败终态。如需重新扣款时,需要换单重试。

接口原型

承载协议

HTTPS POST

接口方向

开发者服务器-> 华为支付服务器

接口URL

https://petalpay-developer.cloud.huawei.com.cn/api/v1/aggr/transactions/withhold

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

请求参数

响应参数

错误码

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

resultCode

resultDesc

subCode

subDesc

400000

业务处理失败

UNKNOW_ERROR

服务暂不可用, 请稍后重试

400000

业务处理失败

CUST_NOT_EXIST

用户不存在或已销户

400000

业务处理失败

INVALID_ARGUMENTS

参数不合法

400000

业务处理失败

INVALID_MERC_NO

无效商户号

400000

业务处理失败

CHECK_TRANSACTION_ORDER_STATUS

交易订单状态异常

400000

业务处理失败

CHECK_MERC_STATUS

商户状态异常

400000

业务处理失败

MERC_NOT_SUPPORT_ALLOCATION

商户不支持分账

400000

业务处理失败

CHECK_ACCOUNT_STATUS

用户状态异常

400000

业务处理失败

INVALID_PAYMENT_TYPE

用户无有效支付方式

400000

业务处理失败

WITHHOLD_OVER_TIMES

代扣次数超限

400000

业务处理失败

INVALID_APPID

appId不匹配