paycools-global-zh copy
Languages
Languages
  • English
  • 简体中文
Languages
Languages
  • English
  • 简体中文
  1. 5. 退款
  • 统一 API请求参数
  • 统一异步通知参数
  • API通用提示码
  • 1. 账号查询
    • 国家编码列表
    • 1.1 余额查询
      POST
    • 1.2 对账文件下载
      POST
  • 2. 收银台
    • 支付 ChannelCode列表
    • 2.1 收银台下单接口
      POST
    • 2.2 收银台查询接口
      POST
    • 2.3 获取收银台可用支付渠道接口
      POST
    • 2.4 收银台订单关闭接口
      POST
    • 2.5 收银台支付结果通知
      POST
  • 3. 收款
    • 支付 ChannelCode列表
    • 微信调起支付说明
    • 微信网页授权说明
    • 3.1 收款下单接口
      POST
    • 3.2 收款状态查询接口
      POST
    • 3.3 订单关闭接口
      POST
    • 3.4 收款结果通知
      POST
    • 3.5 交易撤销接口
      POST
  • 4. 代付
    • 代付渠道列表
    • 4.1 代付下单接口
      POST
    • 4.2 查询代付状态接口
      POST
    • 4.3 代付结果回调通知
      POST
  • 5. 退款
    • 退款支持列表
    • 退款状态枚举
    • 5.1 退款接口
      POST
    • 5.2 退款查询接口
      POST
    • 5.3 退款结果回调通知
      POST
  • 6. 授权代扣
    • 授权代扣渠道列表
    • 6.1 获取授权链接接口
    • 6.2 查询token状态接口
    • 6.3 取消token接口
    • 6.4 授权代扣结果回调通知
  • 7.分账
    • 分账相关枚举
    • 1. 关系证明文件上传
    • 2. 添加分账接收方
    • 3. 查询分账接收方
    • 4. 删除分账接收方
    • 5. 查询待分账金额
    • 6. 请求分账
    • 7. 查询分账结果
    • 8. 请求分账退回
    • 9. 查询分账退回
  1. 5. 退款

5.2 退款查询接口

POST
/open-api/refund/payments

请求参数

Body 参数application/json

示例
{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832320\",\"timestamp\":1722416882}"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/open-api/refund/payments' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832320\",\"timestamp\":1722416882}"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "code": 10000,
  "message": "Success",
  "data": [
    {
      "mchRefundOrderId": "refund7806664227088",
      "originalTransactionId": "CU51856318914782320",
      "refundTransactionId": "1818563941756964864",
      "refundAmount": 10000,
      "feeRefunded": 1000,
      "refundStatus": "FAILED",
      "refundCreateTime": "2024-07-31 16:26:46",
      "refundReturnTime": "2024-07-31 16:26:48",
      "failedCode": -10010,
      "failedMessage": "Channel Refund Failed"
    },
    {
      "mchRefundOrderId": "refund4884505715830",
      "originalTransactionId": "CU51856318914782320",
      "refundTransactionId": "1818566685947465728",
      "refundAmount": 10000,
      "feeRefunded": 1000,
      "refundStatus": "COMPLETE",
      "refundCreateTime": "2024-07-31 16:37:40",
      "refundReturnTime": "2024-07-31 17:07:40"
    }
  ]
}
修改于 2026-05-09 02:37:29
上一页
5.1 退款接口
下一页
5.3 退款结果回调通知
Built with