Disputes testing
Last updated: May 21, 2025
Checkout.com’s testing environment lets you simulate disputes (also called chargebacks). You can test how a dispute goes through a production lifecycle using the Disputes API or the Dashboard.
To test a dispute, generate a payment request with specific information from the test scenarios. Without this, the test dispute won't be created.
The test payment should be authorized and then captured within 5 minutes. By default, payments should be auto-captured, but if this fails, you have the option to manually capture a payment.
Request a payment with the test details we've provided.
Information
Your chosen currency determines the value you need to provide in the amount
field. You cannot test disputes with currencies whose value is the same as the full charge amount.
1{2"source": {3"type": "card",4"number": "4242424242424242",5"expiry_month": 1,6"expiry_year": 2099,7"name": "John Smith",8"cvv": "100"9},10"amount": 1040,11"currency": "GBP",12"reference": "Testing disputes for Visa"13}
Once you've created a payment request with the API, wait a few minutes before using the Disputes API to retrieve a list of disputes.
- Sign in to your Test Dashboard.
- Go to the Payments > Processing > Virtual terminal section.
- If prompted, select a processing channel.
- Make a payment by entering a valid test card number, with a corresponding amount and card expiry date as shown in the Test disputes section).
- Select Confirm payment.
- When the payment has been captured, it will be visible in the Payments > Processing > All Payments section.
- Go to the Payments > Processing > Disputes section to view the generated test dispute.
Information
Disputes appear after one minute.
Select the dispute scenarios we've provided to begin testing.
Note
The payment amount changes depending on whether you are using the Dashboard or the API to test. Select the appropriate tab to ensure your test is triggered.