API Reference

Submit W-8BEN tax form

post
https://{environment}.masspay.io/{VERSION}/payout//tax/interview/w8ben

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
string
required
length between 2 and 2

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

string
enum

Type of US TIN (if applicable)

Allowed:
string

US Taxpayer Identification Number (if applicable)

string
length ≤ 25

Foreign Tax Identification Number

boolean
Defaults to false

Check if FTIN is not legally required

string
length ≤ 50

Reference number for your records

tax_treaty_benefits
object
string
required
length ≤ 65

Name of the person signing the form

Responses

404

Not Found

Updated 16 days ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 16 days ago

Did this page help you?