MAmasspay
Tax

Submit W-8BEN tax form

This POST endpoint is used to submit a W-8BEN tax form (for foreign individuals) for a specific user identified by their user_token. Basic information (name, address, phone) is retrieved from the user's existing profile.

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

Request

Request body

citizen_of_countrystring required

Two-letter IRS country code of citizenship (e.g. UK, SP, GM); ISO codes that differ from the IRS code are not accepted by the tax provider

us_tin_type'SSN' | 'ITIN'

Type of US TIN (if applicable)

us_tinstring

US Taxpayer Identification Number (if applicable)

foreign_tinstring

Foreign Tax Identification Number

is_ftin_not_legally_requiredboolean

Check if FTIN is not legally required

reference_numberstring

Reference number for your records

signature_namestring required

Name of the person signing the form

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.