Add a Comment to UW Task Ticket

Adds a text comment to a specific underwriting task (UW ticket) associated with a merchant. Comments are the primary communication mechanism between ISOs, merchants, and the underwriting team within a UW task. They can be used to ask questions, provide status updates, or log decisions related to the task.

Endpoint

POST /api/v1/uwTasks/ticket/addComment

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint when you need to communicate with the underwriting team about a specific task, or when the UW team needs to leave instructions for the ISO regarding required documentation. This is particularly useful after uploading new documents to explain what was provided, or to respond to an underwriter's request for clarification. Comments are timestamped and attributed to the authenticated user.

Request Body

{
  "id": 48201,
  "ticketId": 1073,
  "text": "We have uploaded the requested bank statements covering the past 3 months. Please let us know if additional documentation is needed."
}

Response

200 OK

{
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 88437
}

Error Codes

Common Mistakes

• Omitting the text field or sending an empty string — all three fields are required.
• Using the wrong ticketId; UW tickets are distinct from general support tickets. Retrieve valid ticket IDs from GET /api/v1/uwTasks/getByMerchantId.
• Comments do not automatically notify the UW team that documents have been uploaded; for that, also call POST /api/v1/uwTasks/setStatusInReview.

Related Endpoints

• GET /api/v1/uwTasks/ticket/getCommentsByTicketId — retrieve all comments on a ticket
• GET /api/v1/uwTasks/getByMerchantId — get the list of UW task tickets for a merchant
• POST /api/v1/uwTasks/ticket/addAttachment — attach a document to the same ticket

Example

curl -X POST https://hq.staging.netevia.dev/api/v1/uwTasks/ticket/addComment \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 48201,
    "ticketId": 1073,
    "text": "We have uploaded the requested bank statements covering the past 3 months."
  }'