{"_id":"564ab75f33fb500d00567ddd","githubsync":"","parentDoc":null,"project":"55dd0853d2d97337001800e2","category":{"_id":"55df7dcd437b3f0d004ba204","pages":["55df7ef3a50de10d00062f70","55e0f40126f51b0d009b171c","55e0f57c7d91840d00824934","55e0f605c13a5a0d00880e6b","55e100eed052580d0038c993","55e1013d26f51b0d009b1759","55e101637d91840d0082493c","55e5f5af9416190d00dc3a59","55e6203dd101191900f30d11","55ea2468ba33bc3500b28cd9","55f85c32a3271b0d00498d51","55f8b70fc449610d002daf9f","56092bafa7cc2f0d00d975b2","56092bd58aedf50d0004cff1","563923d13539050d000820f0","563e732531f7580d00511edf","564a83ec4721851900a67614","564ab6274cd0521700523f17","564ab687c58bef0d0062070a","564ab6ee9f35450d00fc767a","564ab75f33fb500d00567ddd","564ab7c34cd0521700523f19","564ab82233fb500d00567ddf","564b5f0755cfbe0d00de3ba5","564b5f7e55cfbe0d00de3ba7","565cf59677f0090d00581807","565e4266f76b8d0d00554185","565f4119de5dc50d00acfe30","5665c0b8d7490819006a4fd6"],"project":"55dd0853d2d97337001800e2","version":"55de36ec9067202b00de0015","__v":29,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-08-27T21:14:53.972Z","from_sync":false,"order":2,"slug":"customers","title":"Customers"},"version":{"_id":"55de36ec9067202b00de0015","__v":33,"project":"55dd0853d2d97337001800e2","createdAt":"2015-08-26T22:00:12.384Z","releaseDate":"2015-08-26T22:00:12.383Z","categories":["55de36ed9067202b00de0016","55de36ed9067202b00de0017","55de36ed9067202b00de0018","55df7dcd437b3f0d004ba204","55e4e014177b6e0d00333141","55e4e01fe252ac0d00303a99","55e4e05240cda60d003bad67","55e4e070177b6e0d00333142","55e4e0753325e60d007fbee6","55e4e0803325e60d007fbee7","55e4e086177b6e0d00333143","55e4e0a1177b6e0d00333144","55e4e0aa3325e60d007fbee8","55e4e0b140cda60d003bad6b","55e4e0bae252ac0d00303a9d","55e4e0c5177b6e0d00333145","55e4e0ee3325e60d007fbeea","55e4e0fae252ac0d00303a9e","55e4e100177b6e0d00333147","55f85c8ba3271b0d00498d55","56092e1ac5cff70d007d0131","564b64a3ee12850d0095866e","564b64b5791099170071e9ea","565cd0bfd18ae50d007183d8","565f5f5d6bafd40d0030a063","565f790d6bafd40d0030a09f","56611c464851190d003f9f5d","56637d5b7988ab0d00d0522e","56637d687988ab0d00d0522f","567835df6928b40d009dd650","56e59c043c29b117008dae5b","5704013559c5190e000ab646","572be252de40590e00026934","58af1bf6ebd7370f0078ba09","5cdad81d912ece0039e9a939"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3.0"},"user":"55f84b9660cc850d008a7afc","__v":49,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-17T05:13:03.593Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":2,"body":"[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Legal entity and merchant\",\n  \"body\": \"A **legal entity** is an association, corporation, partnership, proprietorship, trust, or individual that has the legal capacity to enter into agreements or contracts, assume obligations, incur and pay debts, sue and be sued in its own right, and to be held responsible for its actions. The legal entity will contain legal name and tax identification number information.\\n\\nA **merchant** refers to the actual business that this legal entity owns. This may contain 'doing business as' or DBA information.\\n\\nFor most small or medium sized businesses there may not be much of a distinction between the legal entity and the merchant. The distinction could be a situation such as when there is a legal entity that operates several different businesses that in this case would be referred to as merchants. Nevertheless both the legal entity and merchant information needs to be provided for verification purposes.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Legal entity ownership\",\n  \"body\": \"**Primary Owner**\\nThe \\\"personalContact\\\", \\\"personalAddress\\\", \\\"personalTaxId\\\", and \\\"stakePercent\\\" directly on the legal entity should be that of the primary owner. In a large or public company, the primary owner is a person with fiduciary responsibility for the company's finances. If only one owner is submitted, they are considered to own 100% stake. It is the responsibility of the platform to ensure the stake ownership information is accurate as required by law.\\n\\n**Additional Owners**\\nAnyone else with a minimum of 25% ownership of the legal entity must be included under \\\"additionalOwners\\\".\\n\\nTotal ownership across the primary owner and any additional owners can not exceed 100%.\"\n}\n[/block]\n## Request\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"entityType\",\n  \"body\": \"**ISP:** INDIVIDUAL_SOLE_PROPRIETORSHIP\\nIf the entityType is ISP, then the \\\"personalTaxId\\\" parameter should also be sent.\\nThe \\\"stakePercent\\\" parameter should be \\\"100\\\", and no additional owners are allowed.\\n\\n**LLC:** LIMITED_LIABILITY_COMPANY\\nIf the entityType is LLC, then the \\\"businessTaxId\\\" parameter should also be sent.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"personalTaxId\",\n  \"body\": \"You can send us the **last4PersonalTaxId** if you don't have the full **personalTaxId**. We will attempt to underwrite the customer but we may respond back that the full personalTaxId is required. If you provide us a full personalTaxId, we will automatically replace the last4PersonalTaxId with the last four of the full personalTaxId that was provided.\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Specification\",\n    \"0-0\": \"entityType\",\n    \"1-0\": \"businessName\",\n    \"2-0\": \"businessTaxId\",\n    \"3-0\": \"businessSalesVolume\",\n    \"4-0\": \"businessAcceptedCards\",\n    \"5-0\": \"yearsInBusiness\",\n    \"6-0\": \"personalTaxId\",\n    \"7-0\": \"last4PersonalTaxId\",\n    \"8-0\": \"businessAddress\",\n    \"9-0\": \"personalAddress\",\n    \"10-0\": \"personalContact\",\n    \"0-1\": \"**Type**: String\\n**Values**: \\\"LLC\\\", \\\"ISP\\\"\\n**Description**: ISP = INDIVIDUAL_SOLE_PROPRIETORSHIP and LLC = LIMITED_LIABILITY_COMPANY\",\n    \"1-1\": \"**Type**: String\\n**Length**: 0-256\\n**Description**: This name is strictly for legal verification purposes. This name will not show up on the dashboard. Under certain conditions this may be the same as merchant name.\",\n    \"2-1\": \"**Type**: String\\n**Length**: 9-10\\n**Description**: The tax id for the business\",\n    \"6-1\": \"**Type**: String\\n**Length**: 9-10\\n**Description**: The tax id for the individual owner of the business\",\n    \"3-1\": \"**Type**: String\\n**Length**: 0-32\\n**Description**: The annual sales volume.\",\n    \"4-1\": \"**Type**: Boolean\\n**Default**: true\\n**Description**: Whether business accepted card payments in the past or is currently accepting card payments\",\n    \"5-1\": \"**Type**: String\\n**Description**: The number of years in business.\",\n    \"7-1\": \"**Type**: String\\n**Length**: 4\\n**Description**: The last 4 digits of the tax id for the individual owner.\",\n    \"8-1\": \"**Type**: JSON Object\\n**Format**: [Address](doc:address) \\n**Description**: The address of the legal entity.\",\n    \"9-1\": \"**Type**: JSON Object\\n**Format**: [Address](doc:address) \\n**Description**: The address of the primary contact for the legal entity.\",\n    \"10-1\": \"**Type**: JSON Object\\n**Format**: [Contact](doc:contact)\\n**Description**: The contact details of the primary contact for the legal entity.\",\n    \"11-0\": \"stakePercent\",\n    \"11-1\": \"**Type**: Integer String\\n**Length**: 2-3\\n**Description**: The primary owner's stake in the entity.\",\n    \"12-0\": \"additionalOwners\",\n    \"12-1\": \"**Type**: Array of JSON Objects\\n**Format**: [AdditionalOwner](doc:additional-owner)\\n**Description**: Additional owners of the entity.\"\n  },\n  \"cols\": 2,\n  \"rows\": 13\n}\n[/block]\n## Response\n\nAll of the request parameters, except for **businessTaxId** and **personalTaxId**, will be returned in the response. In addition, the following parameters will also be returned in the response.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"last4BusinessTaxId\",\n    \"0-1\": \"The last 4 digits of the businessTaxId.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n\\t\\\"customer\\\": {\\n    \\\"legalEntity\\\": {\\n      \\\"entityType\\\": \\\"LLC\\\",\\n    \\t\\\"businessName\\\": \\\"Justina Paine\\\",\\n    \\t\\\"businessTaxId\\\": \\\"123124131\\\",\\n   \\t  \\\"businessSalesVolume\\\": \\\"2000\\\",\\n  \\t  \\\"businessAcceptedCards\\\": true,\\n      \\\"yearsInBusiness\\\": \\\"10\\\",\\n    \\t\\\"personalTaxId\\\": \\\"123124508\\\",\\n      \\\"last4PersonalTaxId\\\": \\\"4508\\\",\\n    \\t\\\"businessAddress\\\": {..},\\n      \\\"personalAddress\\\": {..},\\n    \\t\\\"personalContact\\\": {..},\\n      \\\"stakePercent\\\": \\\"75\\\",\\n      \\\"additionalOwners\\\": [\\n        {..}\\n      ]\\n    }\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Request\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n\\t\\\"customer\\\": {\\n    \\\"legalEntity\\\": {\\n      \\\"entityType\\\": \\\"LLC\\\",\\n    \\t\\\"businessName\\\": \\\"Justina Paine\\\",\\n    \\t\\\"last4BusinessTaxId\\\": \\\"4131\\\",\\n   \\t  \\\"businessSalesVolume\\\": \\\"2000\\\",\\n  \\t  \\\"businessAcceptedCards\\\": true,\\n      \\\"yearsInBusiness\\\": \\\"10\\\",\\n    \\t\\\"last4PersonalTaxId\\\": \\\"4508\\\",\\n    \\t\\\"businessAddress\\\": {..},\\n      \\\"personalAddress\\\": {..},\\n    \\t\\\"personalContact\\\": {..},\\n      \\\"stakePercent\\\": \\\"75\\\",\\n      \\\"additionalOwners\\\": [\\n        {..}\\n      ]\\n    }\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Response\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"The legal entity object","slug":"customer-legal-entity","type":"basic","title":"Customer.legalEntity"}

Customer.legalEntity

The legal entity object

[block:callout] { "type": "success", "title": "Legal entity and merchant", "body": "A **legal entity** is an association, corporation, partnership, proprietorship, trust, or individual that has the legal capacity to enter into agreements or contracts, assume obligations, incur and pay debts, sue and be sued in its own right, and to be held responsible for its actions. The legal entity will contain legal name and tax identification number information.\n\nA **merchant** refers to the actual business that this legal entity owns. This may contain 'doing business as' or DBA information.\n\nFor most small or medium sized businesses there may not be much of a distinction between the legal entity and the merchant. The distinction could be a situation such as when there is a legal entity that operates several different businesses that in this case would be referred to as merchants. Nevertheless both the legal entity and merchant information needs to be provided for verification purposes." } [/block] [block:callout] { "type": "success", "title": "Legal entity ownership", "body": "**Primary Owner**\nThe \"personalContact\", \"personalAddress\", \"personalTaxId\", and \"stakePercent\" directly on the legal entity should be that of the primary owner. In a large or public company, the primary owner is a person with fiduciary responsibility for the company's finances. If only one owner is submitted, they are considered to own 100% stake. It is the responsibility of the platform to ensure the stake ownership information is accurate as required by law.\n\n**Additional Owners**\nAnyone else with a minimum of 25% ownership of the legal entity must be included under \"additionalOwners\".\n\nTotal ownership across the primary owner and any additional owners can not exceed 100%." } [/block] ## Request [block:callout] { "type": "info", "title": "entityType", "body": "**ISP:** INDIVIDUAL_SOLE_PROPRIETORSHIP\nIf the entityType is ISP, then the \"personalTaxId\" parameter should also be sent.\nThe \"stakePercent\" parameter should be \"100\", and no additional owners are allowed.\n\n**LLC:** LIMITED_LIABILITY_COMPANY\nIf the entityType is LLC, then the \"businessTaxId\" parameter should also be sent." } [/block] [block:callout] { "type": "info", "title": "personalTaxId", "body": "You can send us the **last4PersonalTaxId** if you don't have the full **personalTaxId**. We will attempt to underwrite the customer but we may respond back that the full personalTaxId is required. If you provide us a full personalTaxId, we will automatically replace the last4PersonalTaxId with the last four of the full personalTaxId that was provided." } [/block] [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Specification", "0-0": "entityType", "1-0": "businessName", "2-0": "businessTaxId", "3-0": "businessSalesVolume", "4-0": "businessAcceptedCards", "5-0": "yearsInBusiness", "6-0": "personalTaxId", "7-0": "last4PersonalTaxId", "8-0": "businessAddress", "9-0": "personalAddress", "10-0": "personalContact", "0-1": "**Type**: String\n**Values**: \"LLC\", \"ISP\"\n**Description**: ISP = INDIVIDUAL_SOLE_PROPRIETORSHIP and LLC = LIMITED_LIABILITY_COMPANY", "1-1": "**Type**: String\n**Length**: 0-256\n**Description**: This name is strictly for legal verification purposes. This name will not show up on the dashboard. Under certain conditions this may be the same as merchant name.", "2-1": "**Type**: String\n**Length**: 9-10\n**Description**: The tax id for the business", "6-1": "**Type**: String\n**Length**: 9-10\n**Description**: The tax id for the individual owner of the business", "3-1": "**Type**: String\n**Length**: 0-32\n**Description**: The annual sales volume.", "4-1": "**Type**: Boolean\n**Default**: true\n**Description**: Whether business accepted card payments in the past or is currently accepting card payments", "5-1": "**Type**: String\n**Description**: The number of years in business.", "7-1": "**Type**: String\n**Length**: 4\n**Description**: The last 4 digits of the tax id for the individual owner.", "8-1": "**Type**: JSON Object\n**Format**: [Address](doc:address) \n**Description**: The address of the legal entity.", "9-1": "**Type**: JSON Object\n**Format**: [Address](doc:address) \n**Description**: The address of the primary contact for the legal entity.", "10-1": "**Type**: JSON Object\n**Format**: [Contact](doc:contact)\n**Description**: The contact details of the primary contact for the legal entity.", "11-0": "stakePercent", "11-1": "**Type**: Integer String\n**Length**: 2-3\n**Description**: The primary owner's stake in the entity.", "12-0": "additionalOwners", "12-1": "**Type**: Array of JSON Objects\n**Format**: [AdditionalOwner](doc:additional-owner)\n**Description**: Additional owners of the entity." }, "cols": 2, "rows": 13 } [/block] ## Response All of the request parameters, except for **businessTaxId** and **personalTaxId**, will be returned in the response. In addition, the following parameters will also be returned in the response. [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Description", "0-0": "last4BusinessTaxId", "0-1": "The last 4 digits of the businessTaxId." }, "cols": 2, "rows": 1 } [/block] [block:code] { "codes": [ { "code": "{\n\t\"customer\": {\n \"legalEntity\": {\n \"entityType\": \"LLC\",\n \t\"businessName\": \"Justina Paine\",\n \t\"businessTaxId\": \"123124131\",\n \t \"businessSalesVolume\": \"2000\",\n \t \"businessAcceptedCards\": true,\n \"yearsInBusiness\": \"10\",\n \t\"personalTaxId\": \"123124508\",\n \"last4PersonalTaxId\": \"4508\",\n \t\"businessAddress\": {..},\n \"personalAddress\": {..},\n \t\"personalContact\": {..},\n \"stakePercent\": \"75\",\n \"additionalOwners\": [\n {..}\n ]\n }\n }\n}", "language": "json", "name": "Request" } ], "sidebar": true } [/block] [block:code] { "codes": [ { "code": "{\n\t\"customer\": {\n \"legalEntity\": {\n \"entityType\": \"LLC\",\n \t\"businessName\": \"Justina Paine\",\n \t\"last4BusinessTaxId\": \"4131\",\n \t \"businessSalesVolume\": \"2000\",\n \t \"businessAcceptedCards\": true,\n \"yearsInBusiness\": \"10\",\n \t\"last4PersonalTaxId\": \"4508\",\n \t\"businessAddress\": {..},\n \"personalAddress\": {..},\n \t\"personalContact\": {..},\n \"stakePercent\": \"75\",\n \"additionalOwners\": [\n {..}\n ]\n }\n }\n}", "language": "json", "name": "Response" } ], "sidebar": true } [/block]