1. 退款申请
Merchant API Documentation
  • 引言
  • 签名算法
  • 信用测试卡
  • 开启正式模式
  • 本地付测试
  • 代付
    • 代付申请接口_ PAY_PAL
      POST
    • 代付申请接口_ ACH_DEBIT
      POST
    • 代付申请接口_CASHAPP
      POST
    • 检索代付交易接口
      GET
    • 代付取消申请接口
      POST
  • 客户
    • 创建客户
      POST
    • 更新客户
      PUT
    • 检索客户
      GET
    • 删除客户
      DELETE
    • 列出所有客户
      GET
  • 代收(收款)
    • 收银台
      POST
    • 本地支付(直连)
      POST
    • 信用卡支付(直连)【PCI】
      POST
    • Web SDK-V2
      POST
    • 检索代收交易接口
      GET
    • Google Pay SDK
      POST
  • 退款申请
    • 退款申请接口
      POST
    • 检索退款接口
      GET
  • 余额查询
    • 检索余额接口
      GET
  • 异步通知
    • 代收异步通知
    • 代付异步通知
  • 订阅
    • 创建订阅
    • 检索订阅
    • 取消订阅
  • 重复性支付
    • 首次重复性支付(直连)
    • 首次重复性支付【收银台】
    • 首次重复性支付【SDK】
    • 后续重复性支付
  • 数据模型
    • 代收模型
      • 信用卡信息
        • CARD
        • 设备信息
      • 代收请求体
      • 代收响应体
      • option配置项
      • option配置项
    • 资金模型
      • 资金响应体
    • 客户模型
      • 客户请求体
      • 客户响应体
      • 收货地址 shipping
      • 产品/服务信息 product
    • 退款模型
      • 退款请求体
      • 退款响应体
    • 代付模型
      • 代付请求体
      • 代付响应体
      • 代付取消请求体
    • 订阅模型
      • 订阅请求体
      • 订阅响应体
      • 订阅计划请求体
      • 订阅计划响应体
      • 其他订阅请求体
    • 响应体基本模型
    • 请求头
  1. 退款申请

退款申请接口

POST
/pay-api/trade/refund

请求参数

Authorization
Body 参数application/json

示例
{
    "tradeNo": "pay_202606261459331859860",
    "currency": "USD",
    "amount": 50,
    "refundAmount": 3.00,
    "refundReason": "退款原因:价格偏贵,退部分",
    "metadata": "商户添加的信息,在响应信息中原样返回",
    "remark": "备注"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/pay-api/trade/refund' \
--header 'Content-Type: application/json' \
--data '{
    "tradeNo": "pay_202606261459331859860",
    "currency": "USD",
    "amount": 50,
    "refundAmount": 3.00,
    "refundReason": "退款原因:价格偏贵,退部分",
    "metadata": "商户添加的信息,在响应信息中原样返回",
    "remark": "备注"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "merNo": "2506190211",
        "tradeNo": "pay_202506251650192902779",
        "orderNo": "7482689494999362",
        "currency": "USD",
        "amount": 9.99,
        "paymentMethod": "TEST",
        "charge": "8319182531071878",
        "refundAmount": 9.99,
        "refundReason": "Customer requirements",
        "status": 0,
        "metadata": "test",
        "remark": null
    },
    "msg": "",
    "livemode": false
}
🔴500失败
修改于 2026-06-29 09:41:29
上一页
Google Pay SDK
下一页
检索退款接口
Built with