Home🔒 DocumentationAPI Reference🔒 Changelog
FIX APIAPI Status

Tax ID Number

This document has two types:

  1. IDENTIFICATION_INFO: Details corresponding to the User
  2. JOINT_IDENTIFICATION_INFO: Details corresponding to the Joint account holder linked to this User

When creating Joint accounts on the platform, both of these documents should be provided on the User object.

📘

Collect Tax ID numbers only

Ask your customer for the ID number they use for tax reporting purposes in their jurisdiction. If an individual has multiple national ID numbers, the one they use for tax purposes should be collected.

Attribute

Type

Description

Required

type

string

Type of user document. Default to "IDENTIFICATION_INFO"

✅

data

object

Document object that contains all data for the "IDENTIFICATION_INFO" user document

✅

data.value

string

National Identification Number (e.g. SSN, National ID, etc)

Please exclude all -'s from the request

✅

data.type

string

Type of National Identification Number. Options:

  • "SSN" – Social Security Number
  • "TIN" – Tax Identification Number
  • "other"

✅

data.citizenship

string

Country of citizenship. Follows the ISO 3166-1 alpha-3 standard. Use List All Countries

✅

data.usTaxPayer

boolean

Customer Tax Country, if true W9 is created, if false W-8BEN is created

✅ (must be asked, but can be false)

{
  "type": "IDENTIFICATION_INFO",
  "data": {
    "value": "111223333",
    "type": "SSN",
    "citizenship": "USA",
    "usTaxPayer" : true
  }
}