{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"vaultedShopper","type":"basic","slug":"vaulted-shopper","excerpt":"Contains information about the vaulted shopper","body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"0-0\": \"`firstName`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Shopper's first name.\\nMaximum 100 characters.\\nFor ACH/ECP, the limit is 25 characters.\",\n    \"1-0\": \"`lastName`\",\n    \"1-1\": \"*string*\",\n    \"1-3\": \"Shopper's last name.\\nMaximum 100 characters.\\nFor ACH/ECP, the limit is 25 characters.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"**Required**\",\n    \"1-2\": \"**Required**\",\n    \"3-0\": \"`country`\",\n    \"3-1\": \"*string*\",\n    \"4-0\": \"`state`\",\n    \"6-0\": \"`address`\",\n    \"4-3\": \"Shopper's state code.\\nSee [State and province codes](/docs/state-and-province-codes)\\nSupports US and Canada states only. For states in other countries, it is necessary to include the state within the `address` property.\",\n    \"4-1\": \"*string*\",\n    \"6-1\": \"*string*\",\n    \"9-0\": \"`zip`\",\n    \"9-1\": \"*string*\",\n    \"10-0\": \"`phone`\",\n    \"6-3\": \"Shopper's address line 1.\\nMaximum 100 characters.\",\n    \"3-3\": \"Shopper's country code.\\nSee [Country codes](/docs/country-codes)\",\n    \"3-2\": \"Optional\",\n    \"4-2\": \"Optional\",\n    \"6-2\": \"Optional\",\n    \"9-2\": \"Optional\",\n    \"10-2\": \"Optional\",\n    \"10-3\": \"Shopper's phone number.\\nBetween 2-36 characters.\\nAccepts numbers, letters, and these characters: ** + . * # / \\\\ ( ) - **\",\n    \"9-3\": \"Shopper's ZIP code. Maximum 20 characters.\",\n    \"10-1\": \"*string*\",\n    \"12-0\": \"`shopperCurrency`\",\n    \"14-0\": \"`paymentSources`\",\n    \"19-0\": \"`transactionFraudInfo`\",\n    \"12-1\": \"*string*\",\n    \"14-1\": \"*object* \",\n    \"19-1\": \"*object*\",\n    \"12-2\": \"Optional\",\n    \"14-2\": \"Optional\",\n    \"19-2\": \"Optional\",\n    \"12-3\": \"Shopper's currency. See [Currency codes](/docs/currency-codes).\",\n    \"14-3\": \"See [paymentSources](doc:payment-sources).\",\n    \"19-3\": \"See [transactionFraudInfo](doc:transaction-fraud-info).\",\n    \"15-0\": \"`shippingContactInfo`\",\n    \"15-1\": \"*object*\",\n    \"15-2\": \"Optional\",\n    \"15-3\": \"See [shippingContactInfo](doc:shipping-contact-info).\",\n    \"18-3\": \"ID of the wallet, obtained via the [Create Wallet](/v8976-Tools/docs/create-wallet) request.\\n\\n**Note**: Applicable for MasterPass and Visa Checkout.\",\n    \"18-2\": \"Optional\",\n    \"18-1\": \"*object*\",\n    \"18-0\": \"`walletId`\",\n    \"7-0\": \"`address2`\",\n    \"7-1\": \"*string*\",\n    \"7-2\": \"Optional\",\n    \"7-3\": \"Shopper's address line 2.\\nMaximum 100 characters.\",\n    \"13-0\": \"`personalIdentificationNumber`\",\n    \"13-1\": \"*string*\",\n    \"13-3\": \"The shopper's local personal identification number. These are the ID types per country:\\n\\n  * Argentina - DNI (length 7-11 chars)\\n  * Brazil - CPF/CNPJ (length 11-14 chras)\\n  * Chile - RUN (length 8-9 chars)\\n  * Mexico - CURP/RFC (length 10-18 chars)\",\n    \"13-2\": \"**Required** for [local LatAm processing](/docs/latam-local-processing) in Brazil\",\n    \"5-0\": \"`city`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"Optional\",\n    \"5-3\": \"Shopper's city.\\nBetween 2-42 characters.\",\n    \"2-0\": \"`merchantShopperId`\",\n    \"2-1\": \"*string*\",\n    \"2-2\": \"Optional\",\n    \"2-3\": \"A merchant's ID for a specific shopper, up to 50 characters.\",\n    \"11-0\": \"`companyName`\",\n    \"11-1\": \"*string*\",\n    \"11-2\": \"**Required** for Corporate ECP accounts.\",\n    \"11-3\": \"Shopper's company name. Maximum 100 characters.\",\n    \"16-0\": \"`softDescriptor`\",\n    \"16-1\": \"*string*\",\n    \"16-2\": \"Optional; Relevant if sending a credit card number\",\n    \"16-3\": \"Description that may appear on the shopper's bank statement when BlueSnap validates the card. Maximum 20 characters.\",\n    \"17-0\": \"`descriptorPhoneNumber`\",\n    \"17-1\": \"*string*\",\n    \"17-2\": \"Optional; Relevant if sending a credit card number\",\n    \"17-3\": \"Merchant's support phone number that may appear on the shopper's bank statement when BlueSnap validates the card. Maximum 20 characters.\",\n    \"8-0\": \"`email`\",\n    \"8-1\": \"*string*\",\n    \"8-2\": \"Optional\",\n    \"8-3\": \"Shopper's email address.\",\n    \"20-0\": \"`transactionOrderSource`\",\n    \"20-1\": \"*string*\",\n    \"20-2\": \"Optional\",\n    \"20-3\": \"Identifies the order type.<br />The only option is `MOTO` &nbsp;(**M**ail **O**rder **T**elephone **O**rder). <br />Any other option is ignored.\",\n    \"21-0\": \"`threeDSecure`\",\n    \"21-1\": \"*object*\",\n    \"21-2\": \"Optional\",\n    \"21-3\": \"See [threeDSecure](https://developers.bluesnap.com/v8976-JSON/docs/threedsecure).\",\n    \"22-0\": \"`chosenPaymentMethod`\",\n    \"22-1\": \"*object*\",\n    \"22-2\": \"Optional; Only relevant for Update Vaulted Shopper requests\",\n    \"22-3\": \"See [chosenPaymentMethod](doc:chosenpaymentmethod).\"\n  },\n  \"cols\": 4,\n  \"rows\": 23\n}\n[/block]\n###Response\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"1-0\": \"`firstName`\",\n    \"1-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"1-3\": \"Cardholder's first name.\",\n    \"2-0\": \"`lastName`\",\n    \"2-1\": \"*string*\",\n    \"2-3\": \"Cardholder's last name.\",\n    \"h-4\": \"Description\",\n    \"1-2\": \"Shopper's first name.\\nMaximum 100 characters.\",\n    \"2-2\": \"Shopper's last name.\\nMaximum 100 characters.\",\n    \"3-0\": \"`country`\",\n    \"3-1\": \"*string*\",\n    \"4-0\": \"`state`\",\n    \"5-0\": \"`address`\",\n    \"4-3\": \"Cardholder's state code.\\n\\nADD LINK TO LIST OF STATE CODES\",\n    \"4-1\": \"*string*\",\n    \"5-1\": \"*string*\",\n    \"8-0\": \"`zip`\",\n    \"8-1\": \"*string*\",\n    \"9-0\": \"`phone`\",\n    \"5-3\": \"Cardholder's address.\",\n    \"3-3\": \"Cardholder's country code.\\n\\nADD LINK TO LIST OF COUNTRY CODES\",\n    \"3-2\": \"Shopper's country code.\\nSee [Country codes](/docs/country-codes)\",\n    \"4-2\": \"Shopper's state code.\\nSee [State and province codes](/docs/state-and-province-codes)\",\n    \"5-2\": \"Shopper's address line 1.\\nMaximum 100 characters.\",\n    \"8-2\": \"Shopper's ZIP code.\",\n    \"9-2\": \"Shopper's phone number.\\nBetween 2-36 characters.\",\n    \"9-3\": \"Cardholder's phone number.\",\n    \"8-3\": \"Cardholder's ZIP code.\",\n    \"9-1\": \"*string*\",\n    \"11-2\": \"Shopper's currency. See [Currency codes](/docs/currency-codes).\",\n    \"15-2\": \"See [paymentSources](doc:payment-sources).\",\n    \"18-2\": \"See [transactionFraudInfo](doc:transaction-fraud-info).\",\n    \"18-1\": \"*object*\",\n    \"15-1\": \"*object*\",\n    \"11-1\": \"*string*\",\n    \"11-0\": \"`shopperCurrency`\",\n    \"15-0\": \"`paymentSources`\",\n    \"18-0\": \"`transactionFraudInfo`\",\n    \"17-2\": \"See [shippingContactInfo](doc:shipping-contact-info).\",\n    \"17-1\": \"*object*\",\n    \"17-0\": \"`shippingContactInfo`\",\n    \"19-2\": \"See [fraudResultInfo](doc:fraud-result-info).\",\n    \"19-1\": \"*object*\",\n    \"19-0\": \"`fraudResultInfo`\",\n    \"16-2\": \"See [lastPaymentInfo](doc:last-payment-info).\",\n    \"16-1\": \"*object*\",\n    \"16-0\": \"`lastPaymentInfo`\",\n    \"6-0\": \"`address2`\",\n    \"6-1\": \"*string*\",\n    \"6-2\": \"Shopper's address line 2.\\nMaximum 100 characters.\",\n    \"0-1\": \"*integer*\",\n    \"0-0\": \"`vaultedShopperId`\",\n    \"0-2\": \"ID of an existing vaulted shopper.\",\n    \"12-2\": \"The shopper's local personal identification number. These are the ID types per country:\\n\\n  * Argentina - DNI (length 7-11 chars)\\n  * Brazil - CPF/CNPJ (length 11-14 chras)\\n  * Chile - RUN (length 8-9 chars)\\n  * Mexico - CURP/RFC (length 10-18 chars)\",\n    \"12-0\": \"`personalIdentificationNumber`\",\n    \"12-1\": \"*string*\",\n    \"10-0\": \"`companyName`\",\n    \"10-1\": \"*string*\",\n    \"10-2\": \"Shopper's company name\",\n    \"13-0\": \"`softDescriptor`\",\n    \"13-1\": \"*string*\",\n    \"13-2\": \"Description that may appear on the shopper's bank statement when BlueSnap validates the card.\",\n    \"14-0\": \"`descriptorPhoneNumber`\",\n    \"14-1\": \"*string*\",\n    \"14-2\": \"Merchant's support phone number that may appear on the shopper's bank statement when BlueSnap validates the card.\",\n    \"7-0\": \"`email`\",\n    \"7-1\": \"*string*\",\n    \"7-2\": \"Shopper's email address.\",\n    \"20-0\": \"`threeDSecure`\",\n    \"20-1\": \"*object*\",\n    \"20-2\": \"See [threeDSecure](https://developers.bluesnap.com/v8976-JSON/docs/threedsecure).\",\n    \"21-0\": \"`chosenPaymentMethod`\",\n    \"21-1\": \"*object*\",\n    \"21-2\": \"See [chosenPaymentMethod](doc:chosenpaymentmethod).\"\n  },\n  \"cols\": 3,\n  \"rows\": 22\n}\n[/block]","updates":[],"order":50,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5f43d7db37d54d01d8ef0864","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.35 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5f43d7db37d54d01d8ef07cb","5f43d7db37d54d01d8ef07cc","5f43d7db37d54d01d8ef07cd","5f43d7db37d54d01d8ef07ce","5f43d7db37d54d01d8ef07cf","5f43d7db37d54d01d8ef07d0","5f43d7db37d54d01d8ef07d1","5f43d7db37d54d01d8ef07d2","5f43d7db37d54d01d8ef07d3","5f43d7db37d54d01d8ef07d4","5f43d7db37d54d01d8ef07d5","5f43d7db37d54d01d8ef07d6","5f43d7db37d54d01d8ef07d7","5f43d7db37d54d01d8ef07d8","5f43d7db37d54d01d8ef07d9","5f43d7db37d54d01d8ef07da","5f43d7db37d54d01d8ef07db","5f45521ec5bfe9005a858533"],"_id":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5ed0377101fdb400214dedaa","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON Objects","slug":"resources","order":14,"from_sync":false,"reference":false,"_id":"5f43d7db37d54d01d8ef07d6","version":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2019-07-18T15:40:02.590Z","__v":0,"parentDoc":null}