MAmasspay
Tax

Submit W-9 tax form

This POST endpoint is used to submit a W-9 tax form for a specific user identified by their user_token. Basic information (name, address, phone) is retrieved from the user's existing profile.<br>The tax provider's W-9 API only accepts a US address: the user's stored state must be a US state and the postal code a 5 or 9 digit ZIP, otherwise the request is rejected with 400. For a U.S. person whose only address is outside the US (for example a U.S. citizen living abroad), collect the W-9 through the hosted tax interview link (GET /payout/{user_token}/tax), which accepts a foreign address and uploaded W-9 PDFs.

post/payout/{user_token}/tax/interview/w9

Request

Request body

tin_type'SSN' | 'EIN' | 'ITIN' required

Type of Taxpayer Identification Number

tinstring required

Taxpayer Identification Number (format: XXX-XX-XXXX for SSN/ITIN or XX-XXXXXXX for EIN)

federal_tax_classification'Individual' | 'Sole Proprietor' | 'Single Member LLC Not Elected' | 'Single Member LLC Elected' | 'C Corporation' | 'S Corporation' | 'Partnership' | 'Trust or Estate' | 'LLC C Corporation' | 'LLC S Corporation' | 'LLC Partnership' | 'Others' required

Federal tax classification of the person

business_namestring

Business name/disregarded entity name, if different from name on file

is_backup_withholdingboolean

Whether the person is subject to backup withholding

exempt_payee_code'1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13'

Exempt payee code 1-13 (if applicable); spelled-out numbers such as 'One' are translated

exempt_fatca_code'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M'

Exemption from FATCA reporting code (if applicable)

account_numbersstring

Account number(s) for reference

is_line_3bboolean

Check if partnership/trust/estate with foreign partners/owners/beneficiaries

other_descriptionstring

Description when 'Others' is selected as federal tax classification

Response

OK

submission_idstring uuid

Unique identifier for the submission

form_type'W9' | 'W8BEN' | 'W8BENE' | 'W8ECI' | 'W8IMY'

Type of form submitted

status'Submitted' | 'Pending' | 'Validated' | 'Error'

Current status of the submission

submitted_atstring date-time

Timestamp of submission

pdf_contentstring

Base64 encoded byte representing the content of the file

Changes

No recorded changes to this operation across all 2 revisions of this API.