Disputes testing
Last updated: April 29, 2022
Checkout’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 Hub.
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.
Choose the correct amount
Your chosen currency will determine 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.
- Log into your sandbox Hub account.
- Go to the Payments section.
- 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 section.
- Go to the 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.
Hub vs API payment amount
The payment amount changes depending on whether you are using the Hub or the API to test. Select the appropriate tab to ensure your test is triggered.