Skip to content

Disputes testing

Last updated: April 29, 2022

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.


How to test a dispute

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.

Using the API

Request a payment with the test details we've provided.

Request examples

Choose the correct 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.

Using the Dashboard

  1. Sign in to your sandbox Dashboard account.
  2. Go to the Payments section.
  3. 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).
  4. When the payment has been captured, it will be visible in the Payments section.
  5. Go to the Disputes section to view the generated test dispute.

Information

Disputes will appear after a 1-minute delay.


Dispute test scenarios

Select the dispute scenarios we've provided to begin testing.

Dashboard vs API payment amount

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.