1. Dispute Management
TrustPay
en
  • en
  • zh
  • Integration Guide
  • Signature Calculation
  • Payment Gateway
    • Risk Control – Merchant Integration
    • Enums
    • Payment Callback Specification
    • C21 Suport Regions
      • TrustPay Supported Billing Countries and US/Canada Regions
    • Whitelist Management
      • Add Card Whitelists
      • Query Card Whitelists
      • Query Card Whitelists Task
    • Card Direct Payin
      POST
    • Cashier Payin
      POST
    • Order Refund
      POST
    • Payment Callback
      POST
    • Balance
      POST
    • Order Query
      POST
    • Fee Query
      POST
    • Refund Query
      POST
  • Dispute Management
    • Dispute Enums
    • Dispute Alert
    • Dispute Alert Callback
    • Dispute Prevention (RDR)
    • Dispute Management(Chargeback)
    • Chargeback Callback
  • Credit Card Issuer
    • Available Card
      POST
    • Open Card
      POST
    • Open/Recharge Card Callback
      POST
    • Get Card Detail
      POST
    • Card Recharge
      POST
    • Order List
      POST
    • Card List
      POST
    • Transaction List
      POST
    • Fee Query
      POST
  • Physical Card Issuer
    • Create Cardholder
    • List Cardholders
    • Assign Physical Cards
    • List Assigned Physical Cards
    • Query Card Balance
    • Query Card Transactions
    • Query Account
    • Card Charge
  • Schemas
    • VCardDetail
    • VOrderDetail
  1. Dispute Management

Dispute Prevention (RDR)

Automatically prevent disputes and lower your dispute rate.

Purpose#

RDR (Rapid Dispute Resolution) automatically resolves eligible cardholder complaints before they become formal disputes.
In TrustPay, an RDR record represents a result already completed by the card network or service provider. It is not a task asking the merchant to refund the transaction again.

Current RDR Result#

RDR cases are presented as:
FieldValueMeaning
prevention_statuspreventedThe case was prevented from becoming a formal dispute
refund_statusrefundedThe provider completed the automatic refund
action_requiredfalseNo merchant response is required

Information Available to the Merchant#

The Dispute Prevention page may show:
provider case ID and CAID;
related merchant and platform order numbers;
original transaction amount and prevented amount;
masked card number and ARN;
reason code, issuer, and merchant descriptor;
occurrence, resolution, and received times;
alert fee and fee status.
The prevented amount uses the provider resolution amount when available. Otherwise, TrustPay falls back to the related paid amount or original transaction amount for display.

Funds and Refund Boundaries#

For an RDR case:
the card network or service provider completed the automatic refund;
TrustPay does not call the normal refund API again;
TrustPay does not create another formal refund for the same RDR event;
TrustPay does not deduct merchant funds a second time for the same provider result;
the merchant must not refund the same case again.
RDR does not create a formal pending, won, or lost Dispute and does not enter the evidence or response workflow.

Fee and Callback#

RDR uses the Dispute Alert billing and callback mechanism:
callback type = 7;
warning_type = rdr;
merchant idempotency key alert_id;
callback sent after successful alert-fee billing.
See Dispute Alert Callback for the complete payload.

If a Formal Dispute Arrives Later#

RDR and a formal dispute are independent records. If the same order later receives a formal dispute:
the RDR record remains as the prevention result;
TrustPay creates a separate formal Dispute;
the merchant handles the new case in Dispute Management;
the RDR alert fee and formal dispute processing fee are separate and may both occur;
the RDR record is not converted into the formal Dispute.

Merchant Checklist#

1.
Treat the case as already refunded and prevented.
2.
Review the prevented amount, CAID, and alert fee.
3.
Do not submit another refund.
4.
If a formal Dispute later appears, handle it as a separate new case.

Related Documents#

Dispute Alert
Dispute Alert Callback
Dispute Enums
Dispute Management
Modified at 2026-07-30 04:22:00
Previous
Dispute Alert Callback
Next
Dispute Management(Chargeback)
Built with