商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4 (opens new window)
  • V4-English (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4 (opens new window)
  • V4-English (opens new window)
  • 接入指南

    • 起步
    • 名词约定
    • 对接流程(必读)
    • 沙箱环境测试资源
    • 对接验收
    • 签名规约
  • 接入方案

    • 收银台模式

      • 内嵌JS-SDK
      • 跳转接入
    • 端到端模式

      • 快速开始
      • 商户收银台规范
    • 交易状态

      • 交易状态
      • 风险订单REVIEW
      • 异步通知
    • 交易场景

      • 交易模式-DEBIT和AUTH
      • Tokenization
      • NetworkToken
      • 本地支付
      • 3D集成指南
      • recurring集成指南
      • 退款集成指南
      • dispute API集成指南
      • 一键支付集成指南
    • 开源建站工具插件支持

      • Magento235
      • Woocommerce
      • OpenCart
      • Prestashop
      • ZenCart
  • APIs

    • 交易下单

    • 交易查询

    • 快捷支付

    • 一键支付

    • 拒付管理

      • 拒付记录
        • 拒付类型
        • 拒付状态
        • 请求地址
        • 请求参数
        • 响应参数
          • data[i] :
      • 操作记录
      • 主动获取调单明细
      • 主动获取拒付明细
      • 查询拒付抗辩所需材料
      • 上传文件
      • 上传拒付材料
      • 删除拒付材料
      • 提交材料并进行抗辩
      • 放弃申诉
      • 异步通知
    • 风控管理

    • 物流信息

    • 交易账单

    • 币种汇率

    • 商户信息

    • KYB方案

  • 工具

  • 附录

  • v3

查询拒付记录

注意

API计划在未来的版本移除。

# 查询拒付记录

拒付是交易的撤销,通常是由持卡人(持卡人)对他们信用卡的交易产生争议时发起。

# 拒付类型

chargebackType desc
retrieval 调单
1st_chargeback 一拒
2nd_chargeback 二拒
chargeback_reversal 拒付撤销
pre_arbitration 预仲裁
arbitration 仲裁

# 拒付状态

1 为初始态;3、4、5 为中间态;6、7、8、9 为终态

序号 chargebackStatus desc 状态描述
1 PENDING 商户还未处理拒付/调单 初始态
3 PROCESSED 商户已提交材料 中间态
4 EXPIRED 商户逾期未处理 中间态
5 ACCEPTED 商户点击放弃申诉按钮或因 未对调单申诉而后续产生的拒付 中间态
6 REVOKED 收单渠道拒付文件,拒付撤销 终态
7 WON 收到渠道文件,申诉成功 终态
8 LOST 收到渠道文件,申诉失败 终态
9 REFUNDED 商户在拒付/调单录入时已全额退款 终态

# 请求地址


    POST https://sandbox-acquirer-payment.pingpongx.com/v2/chargeback
    
    1
    POST https://acquirer-payment.pingpongx.com/v2/chargeback
    
    1
    // Make sure to add code blocks to your code group

    # 请求参数



    参数必填属性说明:必填(M),可选(O),条件必填(C)。 POST JSON
    参数字段 参数类型 参数属性 参数说明
    accId String(64) M PingPong 商户店铺编号
    queryType String(64) M NEW/UPDATE【新增/修改】
    startDate String(64) M 拒付生成时间/更新时间纬度,查询开始时间, 格式 yyyy-mm-dd
    endDate String(64) M 拒付生成时间/更新时间纬度,查询截止时间, 格式 yyyy-mm-dd
    chargebackType String(64) O 拒付类型 详见拒付类型表
    chargebackStatus String(64) O 拒付状态 详见拒付状态表,默认为查询所有类型
    page Integer O 分⻚⻚码,默认 1
    pagesize Integer O 单⻚记录条数,默认 100,最大支持 1000
    signType String(32) M 签名类型,支持 MD5、SHA256,具体⻅本文"签名规约"一栏
    sign String(256) M 签名内容,具体⻅本文"签名规约"一栏

    # 响应参数

    参数字段 参数属性 参数说明
    clientId M PingPong 商户商户号
    totalSize M 总记录数
    data M [data]以下为单笔明细(多组)

    # data[i] :

    参数字段 参数说明
    accId PingPong 商户店铺编号
    chargebackId PingPong 拒付 ID,随拒付类型变更而变更
    chargebackType 拒付类型,枚举值,详见拒付类型表
    chargebackStatus 拒付状态,枚举值,详见拒付状态表
    chargebackAmount 拒付金额
    chargebackCurrency 拒付币种
    reasonType 拒付分类,枚举值
    reasonCode 拒付原因
    reasonDescription 拒付原因对应描述
    createDate 拒付创建时间
    updateDate 拒付更新时间
    appealDate 最晚处理时间
    cardNo 卡号,掩码,只展示前 6 后 4
    cardScheme 卡组织
    cardholderName 持卡人姓名
    transactionTime 原始交易时间
    transactionId 原始交易 PingPongCheckout 流水号
    merchantTransactionId 原始交易商户网站流水号
    amount 原始交易金额
    currency 原始交易币种
    registerUserEmail 持卡人邮箱
    shippingphoneNo 收货人联系电话
    shippingLastName 收货人姓
    shippingFirstName 收货人名
    storeUrl 店铺地址
    goodsName 商品名称
    上次更新: 2024/12/24, 10:42:12
    查询接口
    操作记录

    ← 查询接口 操作记录→

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