{"_id":"59a45d2cd12e81000f842f5d","category":{"_id":"59a45d2bd12e81000f842eee","version":"59a45d2bd12e81000f842ee2","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":11,"slug":"resources","title":"JSON Objects"},"user":"560d5913af97231900938124","parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","version":{"_id":"59a45d2bd12e81000f842ee2","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-08-28T18:12:59.168Z","releaseDate":"2017-08-28T18:12:59.168Z","categories":["59a45d2bd12e81000f842ee3","59a45d2bd12e81000f842ee4","59a45d2bd12e81000f842ee5","59a45d2bd12e81000f842ee6","59a45d2bd12e81000f842ee7","59a45d2bd12e81000f842ee8","59a45d2bd12e81000f842ee9","59a45d2bd12e81000f842eea","59a45d2bd12e81000f842eeb","59a45d2bd12e81000f842eec","59a45d2bd12e81000f842eed","59a45d2bd12e81000f842eee","59a45d2bd12e81000f842eef","59a45d2bd12e81000f842ef0","59a45d2bd12e81000f842ef1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.22.1","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-02T17:06:21.435Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":87,"body":"###Request\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-2\": \"Required\",\n \"h-3\": \"Description\",\n \"0-0\": \"`name`\",\n \"1-0\": \"`firstName`\",\n \"2-0\": \"`lastName`\",\n \"4-0\": \"`phone`\",\n \"5-0\": \"`address`\",\n \"6-0\": \"`city`\",\n \"7-0\": \"`country`\",\n \"9-0\": \"`zip`\",\n \"0-1\": \"*string*\",\n \"1-1\": \"*string*\",\n \"2-1\": \"*string*\",\n \"4-1\": \"*string*\",\n \"5-1\": \"*string*\",\n \"6-1\": \"*string*\",\n \"7-1\": \"*string*\",\n \"9-1\": \"*string*\",\n \"0-2\": \"optional\",\n \"1-2\": \"optional\",\n \"2-2\": \"optional\",\n \"4-2\": \"optional\",\n \"5-2\": \"optional\",\n \"6-2\": \"optional\",\n \"9-2\": \"optional\",\n \"7-2\": \"**required**\",\n \"0-3\": \"Vendor / Business name\",\n \"1-3\": \"Vendor first name\",\n \"2-3\": \"Vendor last name\",\n \"4-3\": \"Vendor phone\",\n \"5-3\": \"Vendor address\",\n \"6-3\": \"Vendor city\",\n \"9-3\": \"Vendor zip/postal code\",\n \"7-3\": \"Vendor country; See [Country codes](/v1.0/docs/country-codes)\",\n \"15-0\": \"`vendorPrincipal`\",\n \"15-1\": \"*container*\",\n \"15-2\": \"optional\",\n \"15-3\": \"Vendor principal; See [vendorPrincipal](doc:vendorprincipal)\",\n \"3-0\": \"`email`\",\n \"3-1\": \"*string*\",\n \"3-2\": \"**required**\",\n \"3-3\": \"Vendor email\",\n \"16-0\": \"`payoutInfo`\",\n \"16-1\": \"*container*\",\n \"16-2\": \"optional\",\n \"16-3\": \"Payout info; See [payoutInfo](doc:payoutinfo).\",\n \"8-0\": \"`state`\",\n \"8-1\": \"*string*\",\n \"8-2\": \"optional\\n\\napplicable if country = US or CA\",\n \"8-3\": \"Vendor state/province\\n\\nSee [State and Province Codes](doc:state-and-province-codes)\",\n \"17-0\": \"`vendorAgreement`\",\n \"17-1\": \"*container*\",\n \"17-2\": \"optional\",\n \"17-3\": \"Vendor agreement; See [vendorAgreement](doc:vendoragreement)\",\n \"10-0\": \"`taxId`\",\n \"10-1\": \"*string*\",\n \"10-2\": \"optional; do not include if sending `vatId`.\",\n \"10-3\": \"The company’s business ID number. For example, EIN in the US, Business Number in Canada, Company Number in the UK, etc.\",\n \"11-0\": \"`vatId`\",\n \"11-1\": \"*string*\",\n \"11-2\": \"optional; do not include if sending `taxId`\",\n \"11-3\": \"The company’s VAT number.\",\n \"12-0\": \"`defaultPayoutCurrency`\",\n \"12-1\": \"*string*\",\n \"12-2\": \"optional\",\n \"12-3\": \"Vendor's default payout currency. If a sale occurs in a currency for which there is not an associated bank account, sale funds will be converted to this currency.\\n\\n Default value is **USD**. Allowable currency codes listed [here](/v1.0/docs/payout#section-vendor-payout-currencies). \\n\\n**Note**: Your vendor must have an associated bank account defined within `payoutInfo`.\",\n \"13-0\": \"`frequency`\",\n \"13-1\": \"*string*\",\n \"13-2\": \"optional\",\n \"13-3\": \"Vendor payout frequency. Default value is Marketplace Merchant's payout frequency. \\n\\nPossible values: \\nDAILY\\nWEEKLY\\nSEMIMONTHLY \\nMONTHLY\\n\\n**Note**: Your vendor's payout settings cannot result in quicker payout than your own.\",\n \"14-0\": \"`delay`\",\n \"14-1\": \"*integer*\",\n \"14-2\": \"optional\",\n \"14-3\": \"Vendor payout delay (in days). Default value is Marketplace Merchant's payout delay. \\n\\n**Note** Your vendor's payout settings cannot result in quicker payout than your own.\"\n },\n \"cols\": 4,\n \"rows\": 18\n}\n[/block]\n###Response\nResponse contains request properties plus these additions: \n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-2\": \"Description\",\n \"0-0\": \"`vendorId`\",\n \"0-1\": \"*integer*\",\n \"0-2\": \"ID assigned to vendor. To be used on all transactions involving this vendor\",\n \"1-0\": \"`verification`\",\n \"1-1\": \"*object*\",\n \"1-2\": \"Includes information about vendor payout and processing statuses. See [verification](doc:verification).\"\n },\n \"cols\": 3,\n \"rows\": 2\n}\n[/block]","excerpt":"","slug":"vendorinfo","type":"basic","title":"vendor"}vendor
name
string
optional
Vendor / Business name
firstName
string
optional
Vendor first name
lastName
string
optional
Vendor last name
email
string
required
Vendor email
phone
string
optional
Vendor phone
address
string
optional
Vendor address
city
string
optional
Vendor city
state
string
optional
applicable if country = US or CA
Vendor state/province
zip
string
optional
Vendor zip/postal code
taxId
string
optional; do not include if sending vatId.
The company’s business ID number. For example, EIN in the US, Business Number in Canada, Company Number in the UK, etc.
vatId
string
optional; do not include if sending taxId
The company’s VAT number.
defaultPayoutCurrency
string
optional
Vendor's default payout currency. If a sale occurs in a currency for which there is not an associated bank account, sale funds will be converted to this currency.
Default value is USD. Allowable currency codes listed here.
Note: Your vendor must have an associated bank account defined within payoutInfo.
frequency
string
optional
Vendor payout frequency. Default value is Marketplace Merchant's payout frequency.
Possible values:
DAILY
WEEKLY
SEMIMONTHLY
MONTHLY
Note: Your vendor's payout settings cannot result in quicker payout than your own.
delay
integer
optional
Vendor payout delay (in days). Default value is Marketplace Merchant's payout delay.
Note Your vendor's payout settings cannot result in quicker payout than your own.
vendorId
integer
ID assigned to vendor. To be used on all transactions involving this vendor
verification
object
Includes information about vendor payout and processing statuses. See verification.