Skip to content
Last updated

Raise dispute via API

Using dynamic flow is the preferred way of implementing dispute submission. Alternatively you can submit disputes directly using our APIs.

To submit a dispute via API:

  1. Pick a dispute reason from the list below. Do not use the get reasons API for the moment with this approach.
  2. Upload any supporting files (receipts, screenshots, etc.) using the file upload endpoint.
  3. Submit the dispute with the reason code, transaction details, and any uploaded file IDs.

Upload a file

Upload a file for use in a dispute submission. Use the fileId in the response when submitting the dispute.

A dispute referencing the returned fileId must be submitted no later than two hours after the file upload, otherwise the file will expire and must be re-uploaded.
curl -i -X POST \
  https://api.wise.com/v4/spend/profiles/14547572/dispute-form/file \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F receipt=string

For request/response details, see the API reference.

Submit dispute

Submit the dispute. The request body varies depending on the dispute reason — see request body by dispute reason below.

curl -i -X POST \
  https://api.wise.com/v3/spend/profiles/14547572/dispute-form/flows/VISA/WRONG_AMOUNT \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": {
      "transactionId": "12345",
      "email": "support@partner.com"
    },
    "form": {
      "charged": {
        "value": 50,
        "currency": "EUR"
      },
      "expected": {
        "value": 5,
        "currency": "EUR"
      },
      "agreedDetails": {
        "agreed": true,
        "agreedReason": "some reason"
      },
      "goods": "something",
      "details": "wrong amount dispute"
    },
    "disclaimer": {
      "allAnswered": true,
      "filesUploaded": true
    }
  }'

For request/response details, see the API reference.

Request body by dispute reason

Information required for a dispute submission is different per dispute reason. Please use the dropdown to select a dispute reason and see the required fields.

View request for dispute reason: