vaulted-shopper

Request

Property Name	Type	Required	Description
`first-name`	string	Required	Shopper's first name. Maximum 100 characters. For ACH/ECP, the limit is 25 characters.
`last-name`	string	Required	Shopper's last name. Maximum 100 characters. For ACH/ECP, the limit is 25 characters.
`merchant-shopper-id`	string	Optional	A merchant's ID for a specific shopper, up to 50 characters.
`country`	string	Optional	Shopper's country code. See Country codes
`state`	string	Optional	Shopper's state code. See State and province codes Supports US and Canada states only. For states in other countries, it is necessary to include the state within the `address` property.
`city`	string	Optional	Shopper's city. Between 2-42 characters.
`address`	string	Optional	Shopper's address line 1. Maximum 100 characters.
`address2`	string	Optional	Shopper's address line 2. Maximum 100 characters.
`email`	string	Optional	Shopper's email address.
`zip`	string	Optional	Shopper's ZIP code. Maximum 20 characters.
`phone`	string	Optional	Shopper's phone number. Between 2-36 characters. Accepts numbers, letters, and these characters: *+ . # / \ ( ) -**
`company-name`	string	Required for Corporate ECP accounts.	Shopper's company name. Maximum 100 characters.
`shopper-currency`	string	Optional	Shopper's currency. See Currency codes.
`personal-identification-number`	string	Required for local LatAm processing in Brazil	The shopper's local personal identification number. These are the ID types per country: Argentina - DNI (length 7-11 chars) Brazil - CPF/CNPJ (length 11-14 chras) Chile - RUN (length 8-9 chars) Mexico - CURP/RFC (length 10-18 chars)
`payment-sources`	container	Optional	Container of payment-sources properties.
`shipping-contact-info`	container	Optional	Container of shipping-contact-info properties.
`soft-descriptor`	string	Optional; Relevant if sending a credit card number	Description that may appear on the shopper's bank statement when BlueSnap validates the card. Maximum 20 characters.
`descriptor-phone-number`	string	Optional; Relevant if sending a credit card number	Merchant's support phone number that may appear on the shopper's bank statement when BlueSnap validates the card. Maximum 20 characters.
`wallet-id`	container	Optional	ID of the wallet, obtained via the Create Wallet request. Note: Applicable for Visa Checkout.
`transaction-fraud-info`	container	Optional	Container of transaction-fraud-info properties.
`transaction-order-source`	string	Optional	Identifies the order type. The only option is `MOTO` (Mail Order Telephone Order). Any other option is ignored.
`three-d-secure`	container	Optional	Container of three-d-secure properties.
`chosen-payment-method`	container	Optional; Only relevant for Update Vaulted Shopper requests	Container of chosen-payment-method properties.

Response

Property Name	Type	Description
`vaulted-shopper-id`	integer	ID of an existing vaulted shopper.
`first-name`	string	Shopper's first name. Maximum 100 characters.
`last-name`	string	Shopper's last name. Maximum 100 characters.
`merchant-shopper-id`	string	A merchant's ID for a specific shopper, up to 50 characters.
`country`	string	Shopper's country code. See Country codes
`state`	string	Shopper's state code. See State and province codes
`address`	string	Shopper's address line 1. Maximum 100 characters.
`address2`	string	Shopper's address line 2. Maximum 100 characters.
`email`	string	Shopper's email address.
`zip`	string	Shopper's ZIP code.
`phone`	string	Shopper's phone number. Between 2-36 characters.
`company-name`	string	Shopper's company name
`shopper-currency`	string	Shopper's currency. See Currency codes.
`personal-identification-number`	string	The shopper's local personal identification number. These are the ID types per country: Argentina - DNI (length 7-11 chars) Brazil - CPF/CNPJ (length 11-14 chras) Chile - RUN (length 8-9 chars) Mexico - CURP/RFC (length 10-18 chars)
`soft-descriptor`	string	Description that may appear on the shopper's bank statement when BlueSnap validates the card.
`descriptor-phone-number`	string	Merchant's support phone number that may appear on the shopper's bank statement when BlueSnap validates the card.
`payment-sources`	container	Container of payment-sources properties.
`last-payment-info`	container	Container of last-payment-info properties.
`shipping-contact-info`	container	Container of shipping-contact-info properties.
`fraud-result-info`	container	Container of fraud-result-info properties.
`three-d-secure`	container	Container of three-d-secure properties.
`chosen-payment-method`	container	Container of chosen-payment-method properties.
`date-created`	string	The date the vaulted shopper was created.
`time-created`	string	The time (PST) the vaulted shopper was created.