Dispute Management

Sandbox Testing

Triggering a Dispute

  1. To create a mock dispute in a sandbox account:
  2. Create a payment for $8888.88 using the Stax.js pay() method or the Charge a Payment Method API.
    Navigate to Stax Pay → Reports → Deposit Report.
  3. Click on Simulate Settlements.
  4. Verify the dispute appears via:
    1. List Disputes API.
    2. Stax Pay Sandbox Dashboard → Reports → Chargeback Manager.

Simulating Different Dispute Statuses

In sandbox accounts, disputes default to the PENDING status (unless they are of type INQUIRY). You can simulate different dispute statuses by passing the sandbox-only &status= query parameter when submitting evidence. Use one of the following enum values as the parameter:

  • PENDING
  • WON
  • LOST
  • EVIDENCE_UPLOADED
  • UPLOAD_FAILED

Example: Append ?status=WON to simulate a successful resolution.

Dispute Statuses

StatusDescription
INQUIRYThe issuer requests evidence to resolve the dispute before engaging in the chargeback process.
OPENThe dispute requires action from the merchant.
PENDINGA response is pending from either party, with no resolution yet.
ACCEPTEDThe dispute has been accepted by a user of either Stax Pay or Stax Connect, leading the dispute to expire.
PREARBITRATIONThe dispute has been reopened for pre-arbitration. Contact support if arbitration is required.
WONSufficient evidence has been provided, and the dispute was resolved in favor of the merchant.
LOSTInsufficient evidence was provided, resulting in a resolution favoring the customer.
EVIDENCE_UPLOADEDSupporting documents have been successfully uploaded.
UPLOAD_FAILEDAn attempt to upload documents failed.