Disputes API - test values 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.