Tax Answer

The Tax Answer is used to submit tax-related information including FATCA (Foreign Account Tax Compliance Act) and CRS (Common Reporting Standard) details for individual customers.

Fields

Base Fields

Field	Type	Required	Description
fieldTypeId	string	Yes	Must be set to "TaxControl" (from FieldTypeEnum)

FATCA-Related Fields

Field	Type	Required	Description
selectedFATCAOptionsIds	array	Conditional	List of selected FATCA option IDs from FATCAOptionEnum
isUSPersonStatusAccepted	boolean	Conditional	Whether the US person status is accepted
w9DocumentId	string	Conditional	ID of the uploaded W-9 form (required for US persons)
w8DocumentId	string	Conditional	ID of the uploaded W-8 form (required for non-US persons)
explanationNonUSPerson	string	Conditional	Explanation for non-US person status

FATCA Option Values

The selectedFATCAOptionsIds should contain one or more of the following values:

Value	Description
CitizenUnitedStates	You are a U.S. Citizen, U.S. Resident or U.S. Green Card Holder
BornUnitedStates	You were born in the U.S.
PhoneUnitedStates	You have a U.S. telephone number
AddressUnitedStates	You have a U.S. address (including U.S. P.O. box)
HoldMail	You have an "in care of" or "hold mail" address which is your sole address
FundsUnitedStates	You have a U.S. source of funds or income
PaymentInstructionsUnitedStates	You have repeating payment instructions to pay amounts to a U.S. address, or an account maintained in the U.S.
HaveGrantedUnitedStates	You have granted a power of attorney or signatory authority to a person with a U.S. address
AnotherInformationUnitedStates	You are aware of any other information that may indicate U.S. links
NoneOfTheAbove	None of the above

CRS-Related Fields

Field	Type	Required	Description
isResidentOutsideUAEForTax	boolean	Yes	Whether the person is a tax resident outside the UAE
crsDocumentId	string	Conditional	ID of the uploaded CRS document
taxIdentificationInfos	array	Conditional	List of tax identification information for different jurisdictions

Tax Identification Information Fields

Field	Type	Required	Description
countryId	string	Yes	Country of tax residence
taxIdentificationNumber	string	Conditional	Tax identification number (TIN)
doesDoesNotHaveTIN	boolean	Conditional	Whether the person has a TIN
tinAvailabilityInfo	object	Conditional	Details about TIN availability

TIN Availability Information Fields

Field	Type	Required	Description
choiceId	string	Yes	ID of the selected reason for TIN unavailability from TINAvailabilityChoice
otherText	string	Conditional	Additional explanation if "Other" is selected

TIN Availability Choice Values

The choiceId should be one of the following values:

Value	Description
NotRequiredInResidence	TIN is not required in country of residence
ResidenceDoesNotIssue	Country of residence does not issue TINs
Other	Other reason (explanation required in otherText field)

Example Usage

{
  "fieldId": "f6g7h8i9-0j1k-2l3m-4n5o-6p7q8r9s0t1u",
  "answer": {
    "fieldTypeId": "TaxControl",
    "selectedFATCAOptionsIds": ["PhoneUnitedStates", "AddressUnitedStates"],
    "isUSPersonStatusAccepted": false,
    "w8DocumentId": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
    "explanationNonUSPerson": "No substantial presence in the US",
    "isResidentOutsideUAEForTax": true,
    "crsDocumentId": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
    "taxIdentificationInfos": [
      {
        "countryId": "GB",
        "taxIdentificationNumber": "GB123456789",
        "doesDoesNotHaveTIN": false
      },
      {
        "countryId": "FR",
        "doesDoesNotHaveTIN": true,
        "tinAvailabilityInfo": {
          "choiceId": "ResidenceDoesNotIssue",
          "otherText": null
        }
      }
    ]
  }
}

Example for US Person

{
  "fieldId": "f6g7h8i9-0j1k-2l3m-4n5o-6p7q8r9s0t1u",
  "answer": {
    "fieldTypeId": "TaxControl",
    "selectedFATCAOptionsIds": ["CitizenUnitedStates"],
    "isUSPersonStatusAccepted": true,
    "w9DocumentId": "c3d4e5f6-7g8h-9i0j-1k2l-3m4n5o6p7q8",
    "isResidentOutsideUAEForTax": false
  }
}

Notes

• FATCA requirements differ depending on whether the individual is considered a US person or not.
• For US persons, a W-9 form document is typically required.
• For non-US persons, a W-8 form document is typically required.
• If the individual is a tax resident outside the UAE, CRS information must be provided.
• For each country of tax residence, either a tax identification number (TIN) must be provided or a reason for not having one.
• All document IDs must reference documents previously uploaded using the Document Upload API.