目录

申请订单退款

功能介绍

此接口提供给用户退款使用。

  1. 不支持对同一笔交易单进行并发退款。
    • 一笔普通收单多次退款,时间间隔要在1分钟以上。
    • 合单多笔子单退款,时间间隔要在1分钟以上。
  2. 订单退款只支持180天内的订单
  3. 申请退款成功不代表退款成功,退款场景是异步处理,需收到退款成功的异步回调通知才表示退款成功。

使用约束

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

重入判定字段

支持原单重入场景

建议换单重试场景

商户退款订单(mercRefundOrderNo)

发起退款请求失败,建议根据错误码(400000 RETRY_TOO_MANY错误码场景,需要换单重试)排查后,原单重试。

  1. 400000 RETRY_TOO_MANY错误码场景,需要换单重试。
  2. 多次部分退款场景下,每次需要换单后发起请求。

接口原型

承载协议

HTTPS POST

接口方向

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

接口URL

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

数据格式

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

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

请求参数

响应参数

错误码

(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

业务处理失败

CHECK_ACCOUNT_STATUS

账号异常

400000

业务处理失败

CHECK_MERC_STATUS

商户状态异常

400000

业务处理失败

MERC_NOT_SUPPORT_REFUND

商户不支持退款

400000

业务处理失败

CHECK_AMOUNT_INVALID

金额校验失败

400000

业务处理失败

CHECK_ACCOUNT_BALANCE

账户余额不足

400000

业务处理失败

RETRY_TOO_MANY

重试次数超限,请换单重试

400000

业务处理失败

ORDER_CONCURRENT_ERROR

订单退款并发错误

说明:

解决方案:

1. 一笔普通收单多次退款,时间间隔要在1分钟以上

2. 合单多笔子单退款,时间间隔要在1分钟以上

400000

业务处理失败

NOT_IN_VALIDITY_PERIOD

不在有效期内

400000

业务处理失败

NOT_SUPPORTED_OPERATION

不支持的操作

400000

业务处理失败

RESTRICTED_USER_ACCOUNT

用户账户受限

400000

业务处理失败

RESTRICTED_USER_TRANSACTION

用户交易受限

400000

业务处理失败

RESTRICTED_MERCHANT_TRANSACTION

商户交易受限