v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

disputes

Submit dispute

Submit a dispute for a card transaction.

The request body structure varies per dispute reason code. All reasons share a common structure with transaction, form, disclaimer, and files objects, but the fields within form and files differ per reason.

For per-reason request body details, see the disputes via API guide.

post/v3/spend/profiles/{profileId}/dispute-form/flows/{scheme}/{reason}

Path parameters

profileIdinteger required

Your profile ID.

scheme'MASTERCARD' | 'VISA' required

The network of the card that was used to make this transaction.

reasonstring required

Dispute reason code supplied by the dispute reasons endpoint.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

formobject

Form fields required to submit this dispute. The specific fields vary per reason code.

See the disputes via API guide for per-reason field details.

filesobject

Key-value pairs mapping file field names to file IDs obtained from the file upload endpoint. Available file fields vary per reason code.

Example request

{
  "transaction": {
    "transactionId": "12345",
    "email": "support@partner.com"
  },
  "disclaimer": {
    "allAnswered": true,
    "filesUploaded": true
  }
}

Response

Dynamic Flow JSON response. If using the Dynamic Flow framework, pass this to the framework. If using the API directly, the response can be ignored.

object required

Dynamic Flow JSON object.