Create Wallet Dispute Message

Posts a message to the holder on a dispute, with optional files as evidence.

Use it to ask the holder a question (together with Request Wallet Dispute Information) or to explain your decision. You
can post in any status. Your message never changes the dispute's status; a holder's reply to a needs-more-info dispute
moves it back to under-review. Every message fires the
wallet-dispute-message-added webhook.

Requires the Wallet Management permission (see Invite Wallet Holder).

To attach files:

  1. Declare each file in attachments with its mimeType, fileName and size.
  2. The response returns one upload per file. Send each file with an HTTP PUT to its uploadUrl within one hour, with the
    uploadHeaders and a Content-Type header set to the file's mimeType. The file must be exactly size bytes.
  3. The file appears on the thread once its upload completes.

Errors

  • 400 VALIDATION_ERROR: a field is invalid. Detail codes: REQUIRED (body is missing), DISPUTE_MESSAGE_EMPTY (body
    is blank), a length error (body is over 2000 characters), DISPUTE_EVIDENCE_INVALID (attachments is not an array,
    or a file has no fileName or no valid size), DISPUTE_EVIDENCE_TOO_MANY (more than 5 files),
    DISPUTE_EVIDENCE_MIME_INVALID (unsupported file type), DISPUTE_EVIDENCE_TOO_LARGE (a file over 6 MB), or a field that
    is not part of the request
  • 404 NOT_FOUND: the dispute does not exist, or is not on one of your wallets
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The dispute ID, starting with DS-, as returned by Search Wallet Disputes or the wallet dispute webhooks.

Body Params
string
required
length ≤ 2000

The message text. The holder reads it. Cannot be blank.

attachments
array of objects
length ≤ 5

Files to attach as evidence, at most 5. Declare each file here, then upload it to the uploadUrl returned for it.

attachments
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json