Improved

File upload responses

Enhanced the FileUploadResp response object to include a direct upload URL for pending file requests.

• Added new response field:

  • file_upload_link (string) — When the file upload request has not yet been completed, this field contains a URL where the user can upload the required files directly.

• This field is returned as part of file upload request responses, including:

  • GET /payout/file_uploads/{user_token}
  • GET /payout/file_uploads/{user_token}/{file_upload_token}

Response example

{
  "file_upload_token": "file_req_06944559-812c-4c41-a344-767591c57c5d",
  "files_types_accepted": ["Bank Statement", "Paper Check"],
  "time_of_request": "2025-05-26 07:22:56",
  "is_required": true,
  "ref_attributes": {
    "Account Number": "************4242"
  },
  "is_completed": false,
  "is_verified": false,
  "file_upload_link": "https://upload.masspay.io/file_req_06944559-812c-4c41-a344-767591c57c5d"
}

Backward compatibility

Existing clients that ignore unknown fields require no changes. Clients can now use file_upload_link to direct users to a hosted upload experience for incomplete document requests.