Dispute API test reasons for simulations

Developers and QA engineers can use these predefined test values to simulate negative Disputes API responses in a sandbox while they develop and test their integration.

Prerequisites

• Access to the Disputes API sandbox.
• Valid API credentials and authentication set up.
• An HTTP client (for example, cURL, Postman, or your application).

For more information, see Set up accounts and environment.

Simulate negative responses

1. Pick the Disputes API operation and the error you want to test.
2. Find the matching test value in the tables below and send a request that uses it in the path or query parameter.
3. Confirm that the response and your integration's behavior match the simulated error described in the table.

List disputes

Use the query parameter in the request URL to simulate the negative responses.

Endpoint: GET /v1/customer/disputes?disputed_transaction_id={TRANSACTION-ID}

Show dispute details

Use the test values as path parameters to simulate the negative responses.

Endpoint: GET /v1/customer/disputes/{ID}

Send message to other party

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/send-message

Make offer to resolve dispute

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/make-offer

Accept claim

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/accept-claim

Provide evidence

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/provide-evidence

Escalate dispute to claim

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/escalate

Appeal dispute

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/appeal

Acknowledge returned item

Use the test values as path parameters to simulate the negative responses.

Endpoint: POST /v1/customer/disputes/{ID}/acknowledge-return-item

Additional information

• Use these test values in automated tests to regularly validate error handling.
• For full request and response formats, see the Disputes API integration guide.
• For happy‑path flows and additional examples, see the Disputes API reference.