指南
状态页面Dashboard预约演示
开始键入搜索...

扣款管理

Yuno 为处理争议提供统一、自动化的解决方案，让您可以从一个控制面板管理所有供应商的扣款。我们的平台可帮助您实现工作流程自动化、收回收入并为审计做好准备，而无需来回奔波。

什么是退款？

扣款是客户通过其发卡银行提出的索赔，原因是他们发现交易存在问题，如未经授权的付款、金额不正确或商户争议。

在 Yuno，扣款和争议在技术上是一样的，都是有争议的交易。
概念上的区别在于商家的回应：当商家提供文件对扣款提出异议时，它就变成了主动争议。但是，交易保持不变，只是其状态根据所采取的行动而变化。

拒付处理流程

  1. 创建扣款

    • 客户向发卡银行索赔
    • 银行通知付款提供商
    • 医疗服务提供者向 Yuno 通报索赔情况
    • 尤诺记录扣款，其初始交易状态为 CREATED

  2. 商户通知

    • Yuno 通知商家扣款情况并更新付款状态

  3. 商户行动

    • 商家可以
      • 提交证据：提供交易有效性的证明文件，将扣款转为主动争议
      • 接受扣款:承认索赔而不提出异议，损失资金 (LOST)

  4. 证据审查

    • 如果提交了证据，发证银行将审查文件并发布最终决定（......）。PENDING_REVIEW)

  5. 扣款/争议解决

    • 争议获胜 (WON):客户的要求被拒绝，交易仍然有效
    • 争议损失 (LOST):接受客户的索赔，向客户退款

拒付状态

Yuno 中的退款状态代表了流程的各个阶段：

国家说明
CREATED收到扣款；如果供应商支持，商家可以采取行动或提交证据。
PENDING_REVIEW已提交证据，发证银行正在审查。
WON争议的解决对商人有利。
LOST索赔被受理，客户获得了退款。

Payment 状态付款替代状态交易类型交易状态说明
SUCCEEDED批准扣款获胜退款争议获胜
IN_DISPUTE收到扣款创建收到扣款或查询。必须提供决定或文件才能提出争议。
PENDING扣款待审提供方审查中的争议
CHARGEBACK丢失扣款丢失过期/关闭/审核丢失

预先争议（偏转）

部分网络和支付机构提供早期解决计划，可在正式发起争议前化解纠纷。例如Visa快速争议解决（RDR）、万事达卡的Ethoca生态系统以及美国运通加速争议解决（ADR）计划。

当医疗服务提供者/网络明确报告争议前偏离时，Yuno.Net 服务提供者/网络就会报告争议前偏离：

  • 创建一个 CHARGEBACK 与 status = PREVENTED 这样您就可以审核是否防止了扣款
  • 将付款设置为 status = CHARGEBACK 和 sub_status = LOST 以反映财务结果
  • 只发出收费网络钩子的 CHARGEBACK / PREVENTED 交易（没有单独的退款 webhook）
  • 强制执行幂等性，避免重复事务和通知

其他详细信息：

  • 无需证据：争议前抗辩无需提交证据
  • 争议 ID 映射：争议 ID 等于退款交易 ID
  • 可选字段：扣款网络钩子可包括 provider_dispute_id 和 is_pre_dispute 表示争议前起源案件

PREVENTED 仅用于 CHARGEBACK 是该事务的终端状态。

争议前示例

{
  "transaction": {
    "id": "tx_cb_001",
    "type": "CHARGEBACK",
    "status": "PREVENTED",
    "category": "CARD",
    "amount": 19700,
    "provider_id": "STRIPE",
    "provider_dispute_id": "du_1S2umUCXdfp1jQhWSW3lALH2"
  },
  "payment": {
    "id": "pay_123",
    "status": "CHARGEBACK",
    "sub_status": "LOST",
    "amount": { "currency": "USD", "value": 19700, "refunded": 0, "captured": 19700 }
  }
}

使用 Yuno 管理退款的主要优势

Yuno 通过几个关键优势简化和优化您的扣款管理：

在一个综合工作流程中处理所有争议

将所有支付提供商的退款数据整合到一个控制面板中。无论是维萨卡、万事达卡还是本地收单机构，您都可以集中跟踪、响应和管理争议，而无需进行 API 缝合。

简化退单响应

利用正确的证明文件自动回复扣款，确保快速高效地解决每一个争议。

确保合规

每一次扣款、每一次回复、每一次更新都记录在案并可访问。通过内置的审计跟踪和可导出记录，合规性和内部审查变得更快、更简单。

了解原因代码

了解每笔扣款背后的原因代码至关重要，因为它解释了客户发起争议的原因。熟悉这些代码可以让您更有效地调整应对措施，并为每个案例收集必要的信息。在 扣款原因代码部分在此，您可以找到收单银行提供的所有可能代码的综合列表。在每笔扣款交易中，您都可以在 response_code field.

证据管理

要对扣款提出异议，商家必须提交支持其理由的证据。在争议解决服务中，证据指的是任何能证明你在异议或索赔中的立场的信息或文件。提供令人信服的证据是取得有利结果的关键。此类证据的例子包括

  • 交货证明：确认产品已发货并由客户收到的文件，如跟踪号码或交货确认书
  • 客户通信：电子邮件、短信或任何能证明与客户达成的协议或澄清的交流记录
  • 退款和退货政策：客户在购买时同意的政策副本，概述退货或退款的条件
  • 真实性证明：验证交易合法性的文件，如签名收据或认证记录

提交的证据必须清晰、相关，并与当前问题直接相关。此外，专业、简洁地组织和提交证据将有助于参与解决争议的各方对证据进行评估。

📘

证据要求

上传的文件必须符合以下标准：

  • 格式：文件必须是 PDF 格式，编码为 base64
  • 文件大小：文件大小不得超过 1 MB
  • 语言：争议应以英语或该国当地语言书写

提交证据的示例请求

POST https://api-sandbox.y.uno/v1/payments/:payment_id/transactions/:transaction_id/dispute

Headers:
  X-Idempotency-Key: <unique-key>
  X-Public-Api-Key: <api-key>
  X-Private-Secret-Key: <secret-key>

Body:
{
  "account_id":"<Your Yuno account_id>",
  "evidence": [
    {
      "file_name": "signed_receipt.pdf",
      "content_type": "application/pdf",
      "content_category": "RECEIPT",
      "content": "JVBERi0xLjMKJcTl8uXrp/Og0MT..."
    }
  ]
}

该endpoint 一个标准支付响应结构，其中包含更新后的支付信息，包括拒付/争议状态。

更新争议证据

若需向现有争议添加补充证据，可使用争议 endpoint。该功能允许您在初始争议提交后提供补充文件。

⚠️

重要注意事项

  • 状态不变：添加额外证据不会改变拒付状态。无论是否更新信息，状态均保持不变。
  • 供应商支持：并非所有供应商都支持更新争议状态。若供应商不支持更新操作，您将收到受控错误响应，且拒付状态将保持不变。
  • 检索争议信息：您可通过调用"按ID检索付款"endpoint获取当前拒付/争议的状态及相关信息，该接口包含带有拒付信息的交易明细。

有关更多信息，请参阅争议API和更新争议API的参考部分。

约 1 个月前已更新