原路退款

POST /v1/mid-open-api/inbound/refund
需要验证签名

接口描述

异步接口，根据来账流水号申请退款。接口接受请求并同步校验参数，最终结果通过异步回调通知业务方，业务方也可以根据退款查询接口查询结果。

请求头

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

请求参数

Parameter	Type	Required	Description
partner_order_id	string(64)	M	合作伙伴请求单号,唯一幂等。
client_id	string(64)	M	注册PingPong返回的客户ID
transaction_id	string(64)	M	来账流水单号

返回响应

Parameter	Type	Required	Description
partner_order_id	string(64)	M	合作伙伴请求单号,唯一幂等。
status	string(64)	M	状态 PROCESSING、SUCCESS、FAILED

返回示例

成功

{
    "code": 200,
    "data": {
        "partner_order_id": "PO20220620151628",
        "status": "PROCESSING"
    },
    "message": "SUCCESS"
}

失败

{
    "code": 900003,
    "data": null,
    "message": "order not exist"
}

错误码

返回码	描述	解决方案
900000	system error	系统错误，请联系PingPong技术人员核查
900001	repeated request	请求单号重复，请使用来账流水单号查询结果进行相应处理或咨询PP技术人员
900002	illegal param	参数有误，请根据提示更正信息
900004	order not exist	请检查单号是否正确
920002	account balance is not enough	账户余额不足，无法发起退款
952000	channel not support refund	该渠道不支持退款，可通过调用付款接口或联系PP人员
952001	inbound has reversal,can't be refund	被召回的入账单不允许退款