Disputes testing
Last updated: September 4, 2024
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.
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 > All Payments section.
- Select New payment.
- Make a payment by entering a valid test card number for the payment method you want to test for, with a corresponding amount and card expiry date (as set out in the scenario-specific tables).
- 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 will appear after a 1-minute delay.
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.