Wise disputes API
Raise and manage card transaction disputes, including submission via Dynamic Flow or direct API, file uploads, and dispute lifecycle tracking.For implementation details, see:- [Disputes via Dynamic Flow](/guides/product/issue-cards/card-disputes-dynamic-flow) — build a dispute UI using the Dynamic Flow framework- [Disputes via API](/guides/product/issue-cards/card-disputes-api) — submit disputes directly, with per-reason request body details- [Dispute management](/guides/product/issue-cards/card-disputes-management) — track and withdraw disputesDispute sub-statuses {% #dispute-sub-status .title-3 .m-t-5 %}The possible `subStatus` values are:- `SUBMITTED` — Initial status- `IN_REVIEW` — The dispute is under review or requires additional information- `REFUNDED` — The refund has been processed- `REJECTED` — The dispute is invalid- `WITHDRAWN` — The customer has withdrawn the dispute- `CONFIRMED` — The dispute has been reviewed but a refund is not applicable- `REFUND_IN_PROGRESS` — A refund is being processed- `ATTEMPTING_RECOVERY` — A chargeback request has been submitted- `RECOVERY_UNSUCCESSFUL` — The chargeback attempt was unsuccessful{% admonition type="warning" %}The status transition diagram may undergo modifications in the future and only covers regular pathways.{% /admonition %}{% img src="/images/diagrams/dispute-status-flow.png" alt="Dispute statuses transition diagram"/%}
Wise disputes API is one of 47 APIs that Wise publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include disputes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.
This API exposes 8 operations across 8 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0.
Requests are made against 2 base URLs: https://api.wise.com, https://api.wise-sandbox.com.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 4
Wise disputes API declares
4 security schemes
for authenticating requests.
It accepts HTTP bearer tokens (JWT) (UserToken).
It accepts HTTP bearer tokens (JWT) (PersonalToken).
It accepts HTTP bearer tokens (JWT) (ClientCredentialsToken).
It accepts HTTP basic authentication (BasicAuth).
UserToken— User Access Token for making API calls on behalf of a Wise user. Can be obtained via two OAuth 2.0 flows: - registrationcode grant: For partners creating users…PersonalToken— Personal API Token for individual personal or small business users. Generated from Wise.com Settings Connect and manage apps API tokens. Has limited API access…ClientCredentialsToken— Application-level token for partner operations that don't require a specific user context, such as bulk settlement and card spend controls. Obtained via POST /…BasicAuth— Basic Authentication using your Client ID and Client Secret as the username and password. Client credentials are provided by Wise when your partnership begins.…
Paths & Operations 8
Across 8 paths, the API surfaces 8 operations — 3 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Raise and manage card transaction disputes, including submission via Dynamic Flow or direct API, file uploads, and dispute lifecycle tracking. For implementation details, see: - […
Schemas 2
The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Dispute (11 properties), DisputeReason (6 properties). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Wise 12
Other APIs Wise publishes across the network.