商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • 概述

    • 起步
    • 对接流程
    • 联调资源
  • 服务

    • Checkout

      • 概览
      • Hosted
      • Non-Hosted
      • APIs

        • 下单(Hosted模式)
        • 下单并支付(Non-Hosted模式)
        • 交易查询
        • 申请退款
        • 退款查询
          • 请求地址
          • 请求参数
          • 响应参数
        • 预授权确认
        • 预授权确认查询
        • 预授权取消
        • 预授权取消查询
        • 异步通知
        • 上传物流信息
        • SFTP对账单下载
    • 订阅

      • 概览
      • 接入流程
    • 线下付款码支付

      • 接入流程
    • Tokenization

      • 概览
      • 接入流程
      • APIs

    • 风险管理

      • 概览
      • Dynamic 3D Secure
      • Disputes
      • APIs

    • 一键支付

      • 概览
      • 接入流程
      • APIs

    • ApplePay

    • GooglePay

    • KYB

    • 支付链

    • 建站工具

    • 工具

  • 附录

  • v4

退款查询

# 退款查询

注意

请在退款同步返回之后调用查询接口,否则可能会发生查询异常的情况

# 请求地址


    https://sandbox-acquirer-payment.pingpongx.com/v4/refund/query
    
    1
    https://acquirer-payment.pingpongx.com/v4/refund/query
    
    1
    // Make sure to add code blocks to your code group

    # 请求参数

    # 公共请求参数



    暂无数据

    # 业务参数

    参数字段 参数类型 参数属性 参数说明
    refundId String(64) C PingPong 退款流水号,与 merchantRefundId 至少上送一项
    merchantRefundId String(64) C 商户网站退款流水号,与 refundId 至少 上送一项
    merchantTransactionId String(64) M 商户网站的原交易流水号



    # 响应参数

    # 公共响应参数



    暂无数据

    # 返回参数

    参数字段 参数类型 参数说明
    transactionId String(64) PingPong 原交易流水号
    merchantTransactionId String(64) 商户网站的原交易流水号
    currency String(3) 币种
    amount String(14) 退款金额
    refundTime String(32) 退款发起时间,时间戳
    resultCode String(6) 状态结果码
    resultDescription String(500) 状态结果描述
    refundEndingTime String(32) 退款到达终态时间,时间戳
    status String(32) 交易状态:状态幂等 , SUCCESS-成功 FAILED-失败 PROCESSING-处理中
    remark String 商户扩展字段

    # 响应报文示例



      {
        "accId": "2023060217493010231446",
        "bizContent": "{\"amount\":\"200.000000\",\"cardInfo\":{\"firstName\":\"zhang\",\"lastName\":\"san\",\"lastFourDigits\":\"8Q==\",\"ipCountry\":\"CN\",\"firstSixDigits\":\"AQICAH\"},\"threeDSecure\":\"\",\"resultCode\":\"000000\",\"transactionTime\":\"1687334372000\",\"transactionId\":\"2023062150000329\",\"merchantTransactionId\":\"PMT-1OL5AJOJA91687334040656\",\"currency\":\"USD\",\"resultDescription\":\"Transaction succeeded\",\"captureDelayHours\":0,\"status\":\"SUCCESS\"}",
        "clientId": "2023060217493010231",
        "code": "001000",
        "description": "Successful request",
        "sign": "D7F4C867DDB7F3BDC56F598B5467F2D4792E6FCE459EA119BA3FF2FCEF97DB79",
        "signType": "SHA256"
      }
      
      1
      2
      3
      4
      5
      6
      7
      8
      9
      // Make sure to add code blocks to your code group
      上次更新: 2024/01/31, 16:04:21

      ← 申请退款 预授权确认→

      杭州乒乓智能技术有限公司 | Copyright © 2015-2024 checkout.pingpongx.com.All Rights Reserved.
      • 跟随系统
      • 浅色模式
      • 深色模式
      • 阅读模式