- 1.总体介绍
- 2.接口规范
- 3.统一交易类
- 4.支付宝产品类
- 5.订单分账类
- 6.余额分账类
- 6.1 余额分账指引
- 6.2 余额分账接口
- 7.风控管理类
- 7.1 投诉管理类
- 7.2 风险管理类
- 8.商户管理类
- 9. 先享后付类
- 10.账户管理类
- 产品手册
- 回收站
- 数据模型
- 公共请求参数
- 公共返回参数
- 公共响应结构
- 商户入网材料
- 业务请求参数
- 营业执照信息
- 文件上传请求
- 法人证件信息
- 商户入网请求
- 结算卡信息
- 进件标识查询请求
- 入网查询请求
- 结算卡变更请求
- 产品变更请求
- 结算卡更新信息
- 变更查询请求
- AUT查询请求
- 分账关系绑定请求
- AUT微信配置请求
- 分账关系解绑请求
- AUT配置详情查询请求
- 分账关系更新请求
- 微信支付配置响应
- 分账关系查询请求
- 授权目录配置状态
- 商户入网响应
- AppId配置状态
- 商户变更响应
- AUT拆分请求
- 变更审核状态响应
- 商户基本信息
- 分账关系响应
- 人员证件信息
- 余额分账申请请求
- 商户营业执照信息
- 余额分账明细请求
- 商户经营信息
- 分账查询请求
- 经营场景信息
- 分账退款申请请求
- 经营资质信息
- 分账退款明细请求
- 商户结算卡信息
- 分账退款查询请求
- 对公卡信息
- 余额分账响应
- 签约信息
- 分账明细响应
- 产品开通信息
- 余额分账退款响应
- 产品配置详情
- 分账退款明细响应
- AUT查询响应
- 提现申请请求
- 异步通知响应结构
- 提现查询请求
- 进件状态通知数据
- 提现响应数据
- 变更状态通知数据
- 入网报备通知数据
- 余额分账通知数据
- 分账明细通知
- 余额退款通知数据
- 提现通知数据
- 退款明细通知
3.2.4 统一退款接口
正式环境
https://openapi.3ypay.com
正式环境
https://openapi.3ypay.com
POST
/openapi/order/pay/refund
请求参数
Body 参数application/json必填
示例
{
"appId": "APP_xxxxx",
"bizContent": "{\"amount\":1.01,\"mchRefundOrderNo\":\"xxxxxx\",\"notifyUrl\":\"https://x.x.x/x\",\"payOrderNo\":\"P202xxxxxxxxxxxxx\",\"reason\":\"测试退款\"}",
"charset": "UTF-8",
"requestId": "REQxxxxxxxxxxxx",
"sign": "xxxxxxxxx",
"signType": "RSA2",
"subSn": "xx",
"timestamp": 1762845607144,
"version": "1.0"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.3ypay.com/openapi/order/pay/refund' \
--header 'Content-Type: application/json' \
--data '{
"appId": "APP_xxxxx",
"bizContent": "{\"amount\":1.01,\"mchRefundOrderNo\":\"xxxxxx\",\"notifyUrl\":\"https://x.x.x/x\",\"payOrderNo\":\"P202xxxxxxxxxxxxx\",\"reason\":\"测试退款\"}",
"charset": "UTF-8",
"requestId": "REQxxxxxxxxxxxx",
"sign": "xxxxxxxxx",
"signType": "RSA2",
"subSn": "xx",
"timestamp": 1762845607144,
"version": "1.0"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"appId": "APP_xxxxxxx",
"code": 200,
"data": "{\"reason\":\"测试\",\"amount\":0.0500,\"payOrderNo\":\"P20251xxxxxx39127\",\"mchRefundOrderNo\":\"MER-Rxxxxxx113\",\"mchOrderNo\":\"\",\"refundOrderNo\":\"R202xxxxxx3623\",\"message\":\"商户xxxx账户余额不足\",\"instOrderNo\":\"3002xxxxx00906168630\",\"refundAmount\":0.01,\"status\":4}",
"msg": "请求成功",
"sign": "L65ZH+txNYc4B5Wgut6J2KFNOTvhTEkvDFAaEx9jJn1N7HrQLbr/XMPBg7DbqhVZkDfFYTa5k2PWwcLVrzyp8XNY5mWbc/IE+UhPADyMqIq31Z655FXjUc+MJLaL0jpCZ8YEFTC3tuPSVZf0Lq5Mpn0diNYZ9h9vGoBe5o+p57prMSL8qN1yEJ7Rz4W+PQyoGKRO/GXuK9YEXJv48dYwb/L4LpSxXMAc3ZavuxZLoW+MO1t5e7LNkQ774M07W2/q0HCbcw407kuz2VTKfnzx/fniETb3inWDLnbfhSqRIcdZ/ze9UB/9qsIQRJqnakT49mecu215ci400xip9RpzUA==",
"signType": "RSA2",
"timestamp": 1763005195222
}