{"_id":"5b197473be7bb50003d5dbbf","category":{"_id":"5b197473be7bb50003d5dba1","version":"5b197473be7bb50003d5dbd6","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-05-17T12:18:27.941Z","from_sync":false,"order":12,"slug":"wallets","title":"Wallets"},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"_id":"5b197473be7bb50003d5dbd6","project":"57336fd5a6a9c40e00e13a0b","__v":2,"forked_from":"5addf90f94fe9d0003cd9d29","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z","categories":["5b197473be7bb50003d5db9c","5b197473be7bb50003d5db9d","5b197473be7bb50003d5db9e","5b197473be7bb50003d5db9f","5b197473be7bb50003d5dba0","5b197473be7bb50003d5dba1","5b197473be7bb50003d5dba2","5b197473be7bb50003d5dba3","5b197473be7bb50003d5dba4","5b197473be7bb50003d5dba5","5b197473be7bb50003d5dba6","5b27bded4799c70003f36389","5b34c737e0dca2000311de6a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"8976.0.0-Tools","version":"8976-Tools"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-17T13:12:32.559Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"language":"text","code":""}]},"settings":"","examples":{"codes":[]},"method":"post","auth":"optional","params":[],"url":""},"isReference":true,"order":0,"body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/wallets</span>\n\n<hr>\n\n##Documentation\nThe Create Wallet request is where you provide the initial parameters required by the wallet processor to launch the wallet's payment page. The response includes the wallet token.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"This currently supports the Apple Pay on the web, MasterPass, and Visa Checkout wallets. For detailed setup instructions, see:\\n  * [Apple Pay in your website](/docs/apple-pay#section-implementing-apple-pay-in-your-website-or-ios-app)\\n  * [MasterPass Guide](/docs/masterpass)\\n  * [Visa Checkout Guide](/docs/visa-checkout)\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-pills nav-justified\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"pill\\\" href=\\\"#menujson\\\">JSON</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#menuxml\\\">XML</a></li>\\n</ul>\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"menujson\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n<br />\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-tabs\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"tab\\\" href=\\\"#Apple-Pay\\\">Apple Pay</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#MasterPass\\\">MasterPass</a></li>\\n   <li><a data-toggle=\\\"tab\\\" href=\\\"#Visa-Checkout\\\">Visa Checkout</a></li>\\n</ul>\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"Apple-Pay\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n##Apple Pay\n###JSON Request Content\nSend a **[wallet](doc:wallet-json)** object, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletType` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`validationUrl` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`domainName` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`displayName` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n\n###JSON Response Details \nIf successful, the response HTTP status code is 200 OK.\nThe response includes the [wallet](doc:wallet-json) object with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletType` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletToken` &nbsp;&nbsp;&nbsp; *string*\n\n<hr>\n\n##JSON Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n  \\\"walletType\\\": \\\"APPLE_PAY\\\", \\n  \\\"validationUrl\\\": \\\"https://apple-pay-gateway-cert.apple.com/paymentservices/startSession\\\", \\n  \\\"domainName\\\": \\\"merchant.com\\\"\\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"Apple Pay\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"walletType\\\": \\\"APPLE_PAY\\\",\\n    \\\"walletToken\\\":\\\"ImRhdGEiOiJuY1AvRitIUy8zeG5ISk1pSm9RbXhCMFd\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"200 OK - Apple Pay\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###Apple Pay Wallet\nFor Apple Pay, the request includes the `walletType`, `validationUrl`, and `domainName`. The response includes the `walletToken`. For more information, see [Apple Pay in your website](/docs/apple-pay#section-apple-pay-in-your-website). \n\n**Note**: Be sure that the `domainName` is the domain you registered during [domain verification](/docs/apple-pay#section-step-1-verify-your-domain).\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"MasterPass\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n##MasterPass\n###JSON Request Content \nSend a **[wallet](doc:wallet-json)** object, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletType` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`originUrl` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`returnUrl` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n###JSON Response Details \nThe response includes the [wallet](doc:wallet-json) object with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletType` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletToken` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`merchantCheckoutId` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`allowedCardTypes` &nbsp;&nbsp;&nbsp; *string*\n\n<hr>\n\n##JSON Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n    \\\"walletType\\\": \\\"MASTERPASS\\\",\\n    \\\"originUrl\\\": \\\"http://www.originURL.com\\\",\\n    \\\"returnUrl\\\": \\\"http://www.returnURL.com\\\"\\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"MasterPass - Payment API\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"allowedCardTypes\\\": \\\"master,amex,diners,discover,visa\\\",\\n    \\\"walletType\\\": \\\"MASTERPASS\\\",\\n    \\\"merchantCheckoutId\\\": \\\"a4a6w4vkqzjnzikhr6ihj1ikqnlqhu5ymb\\\",\\n    \\\"walletToken\\\": \\\"f9babd23df00acc9b049ac4694d2344f8f73f4e8\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"200 OK - MasterPass \"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###MasterPass Wallet\nFor MasterPass, the request includes the `originUrl` and the `returnUrl`. The response includes the token for the wallet, the merchant checkout ID for the session, and a list of the supported card types for the wallet.\nFor more information, see [Implementing MasterPass](/docs/masterpass#section-implementing-masterpass-via-the-api).\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"Visa-Checkout\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n##Visa Checkout\n###JSON Request Content\nSend a **[wallet](doc:wallet-json)** object, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletType` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`callId` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n###JSON Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response includes the [wallet](doc:wallet-json) object with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`walletId` &nbsp;&nbsp;&nbsp; *long*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`firstName` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`lastName` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`email` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`country` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`phone` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`creditCard` &nbsp;&nbsp;&nbsp; *object*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`billingContactInfo` &nbsp;&nbsp;&nbsp; *object*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`shippingContactInfo` &nbsp;&nbsp;&nbsp; *object*\n\n<hr>\n\n##JSON Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n    \\\"callId\\\": 5549711876630985101,\\n    \\\"walletType\\\": \\\"VISA_CHECKOUT\\\"\\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"Visa Checkout - Payment API\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"country\\\": \\\"us\\\",\\n    \\\"walletId\\\": 2203,\\n    \\\"firstName\\\": \\\"Ben\\\",\\n    \\\"lastName\\\": \\\"Li\\\",\\n    \\\"billingContactInfo\\\": {\\n        \\\"zip\\\": 12324,\\n        \\\"country\\\": \\\"us\\\",\\n        \\\"firstName\\\": \\\"Ben\\\",\\n        \\\"lastName\\\": \\\"Li\\\",\\n        \\\"city\\\": \\\"Santa Barbara\\\",\\n        \\\"address1\\\": \\\"BlueSnap Street\\\",\\n        \\\"state\\\": \\\"CA\\\"\\n    },\\n    \\\"phone\\\": 5032541004,\\n    \\\"shippingContactInfo\\\": {\\n        \\\"zip\\\": 12324,\\n        \\\"country\\\": \\\"us\\\",\\n        \\\"firstName\\\": \\\"Ben\\\",\\n        \\\"lastName\\\": \\\"Li\\\",\\n        \\\"city\\\": \\\"Santa Barbara\\\",\\n        \\\"phone\\\": 5032541004,\\n        \\\"address1\\\": \\\"BlueSnap Street\\\",\\n        \\\"state\\\": \\\"CA\\\"\\n    },\\n    \\\"creditCard\\\": {\\n        \\\"expirationYear\\\": 2020,\\n        \\\"cardLastFourDigits\\\": 4821,\\n        \\\"cardType\\\": \\\"VISA\\\",\\n      \\t\\\"cardSubType\\\": \\\"CREDIT\\\", \\n      \\t\\\"cardCategory\\\": \\\"CLASSIC\\\",\\n        \\\"expirationMonth\\\": 8\\n    },\\n    \\\"email\\\": \\\"ben.li&#x40;bluesnap.com\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"200 OK - Visa Checkout\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###Visa Checkout Wallet\nFor Visa Checkout, the request includes the `callId`. The response content includes the wallet ID and the checkout details.\nFor more information, see [Implementing Visa Checkout](/docs/visa-checkout#section-implementing-visa-checkout).\n[block:html]\n{\n  \"html\": \"</div>\\n</div>\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"menuxml\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n<br />\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-tabs\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"tab\\\" href=\\\"#Apple-Pay-XML\\\">Apple Pay</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#MasterPass-XML\\\">MasterPass</a></li>\\n   <li><a data-toggle=\\\"tab\\\" href=\\\"#Visa-Checkout-XML\\\">Visa Checkout</a></li>\\n</ul>\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"Apple-Pay-XML\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n##Apple Pay\n###XML Request Content\nSend a **[wallet](doc:wallet)** object, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-type` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`validation-url` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`domain-name` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`display-name` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n\n###XML Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response includes the [wallet](doc:wallet) object with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-type` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-token` &nbsp;&nbsp;&nbsp; *string*\n\n<hr>\n\n##XML Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>APPLE_PAY</wallet-type>\\n   <validation-url>https://apple-pay-gateway-cert.apple.com/paymentservices/startSession</validation-url>\\n   <display-name>My store</display-name>\\n</wallet>'\",\n      \"language\": \"curl\",\n      \"name\": \"Apple Pay\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n  <wallet-type>APPLE_PAY</wallet-type>\\n  <wallet-token>ImRhdGEiOiJuY1AvRitIUy8zeG5ISk1pSm9RbXhCMFd</wallet-token>\\n</wallet>\",\n      \"language\": \"xml\",\n      \"name\": \"200 OK - Apple Pay\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###Apple Pay Wallet\nFor Apple Pay, the request includes the `wallet-type`, `validation-url`, and `domain-name`. The response includes the `wallet-token`. For more information, see [Apple Pay in your website](/docs/apple-pay#section-apple-pay-in-your-website). \n\n**Note**: Be sure that the `domain-name` is the domain you registered during [domain verification](/docs/apple-pay#section-step-1-verify-your-domain).\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"MasterPass-XML\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n##MasterPass\n###XML Request Content\nSend a **[wallet](doc:wallet)** resource, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-type` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`store-id` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required** - Extended Payment API only</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`origin-url` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`return-url` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n###XML Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response includes the [wallet](doc:wallet) resource with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-type` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-token` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`merchant-checkout-id` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`allowed-card-types` &nbsp;&nbsp;&nbsp; *string*\n\n<hr>\n\n##XML Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>MASTERPASS</wallet-type>\\n   <origin-url>http://www.originURL.com</origin-url>\\n   <return-url>http://www.returnURL.com</return-url>\\n</wallet>'\",\n      \"language\": \"curl\",\n      \"name\": \"MasterPass - Payment API\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>MASTERPASS</wallet-type>\\n   <store-id>11580</store-id>\\n   <origin-url>http://www.originURL.com</origin-url>\\n   <return-url>http://www.returnURL.com</return-url>\\n</wallet>\",\n      \"language\": \"xml\",\n      \"name\": \"MasterPass with store-id - Extended Payment API\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=”1.0” encoding=”UTF-8” standalone=”yes”?>\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>MASTERPASS</wallet-type>\\n   <wallet-token>f9babd23df00acc9b049ac4694d2344f8f73f4e8</wallet-token>\\n   <merchant-checkout-id>a4a6w4vkqzjnzikhr6ihj1ikqnlqhu5ymb</merchant-checkout-id>\\n   <allowed-card-types>master,amex,diners,discover,visa</allowed-card-types>\\n</wallet>\",\n      \"language\": \"xml\",\n      \"name\": \"200 OK - MasterPass \"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###MasterPass Wallet\nFor MasterPass, the request includes the `origin-url` and the `return-url`. The response includes the token for the wallet, the merchant checkout ID for the session, and a list of the supported card types for the wallet.\nFor more information, see [Implementing MasterPass](/docs/masterpass#section-implementing-masterpass-via-the-api).\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"Visa-Checkout-XML\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n##Visa Checkout\n###XML Request Content\n`wallet` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>, contains the following properties (see [wallet](doc:wallet)):\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-type` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`store-id` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required** - Extended Payment API only</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`call-id` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n###XML Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response includes the [wallet](doc:wallet) resource with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-id` &nbsp;&nbsp;&nbsp; *long*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`first-name` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`last-name` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`email` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`country` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`phone` &nbsp;&nbsp;&nbsp; *string*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`credit-card` &nbsp;&nbsp;&nbsp; *container*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`billing-contact-info` &nbsp;&nbsp;&nbsp; *container*\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`shipping-contact-info` &nbsp;&nbsp;&nbsp; *container*\n\n<hr>\n\n##XML Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>VISA_CHECKOUT</wallet-type>\\n   <call-id>5549711876630985101</call-id>\\n</wallet>'\",\n      \"language\": \"curl\",\n      \"name\": \"Visa Checkout - Payment API\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/wallets \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n   <wallet-type>VISA_CHECKOUT</wallet-type>\\n   <store-id>16500</store-id>\\n   <call-id>5549711876630985101</call-id>\\n</wallet>'\",\n      \"language\": \"curl\",\n      \"name\": \"Visa Checkout with store-id - Extended Payment API\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<wallet xmlns=\\\"http://ws.plimus.com\\\">\\n    <wallet-id>2203</wallet-id>\\n    <first-name>Ben</first-name>\\n    <last-name>Li</last-name>\\n    <email>ben.li&#x40;bluesnap.com</email>\\n    <country>us</country>\\n    <phone>5032541004</phone>\\n    <credit-card>\\n        <card-last-four-digits>4821</card-last-four-digits>\\n        <card-type>VISA</card-type>\\n        <card-sub-type>CREDIT</card-sub-type>\\n      \\t<card-category>CLASSIC</card-category>\\n        <expiration-month>8</expiration-month>\\n        <expiration-year>2020</expiration-year>\\n    </credit-card>\\n    <billing-contact-info>\\n        <first-name>Ben</first-name>\\n        <last-name>Li</last-name>\\n        <address1>BlueSnap Street</address1>\\n        <city>Santa Barbara</city>\\n        <state>CA</state>\\n        <zip>12324</zip>\\n        <country>us</country>\\n    </billing-contact-info>\\n    <shipping-contact-info>\\n        <first-name>Ben</first-name>\\n        <last-name>Li</last-name>\\n        <address1>BlueSnap Street</address1>\\n        <city> Santa Barbara </city>\\n        <state>CA</state>\\n        <zip>12324</zip>\\n        <country>us</country>\\n        <phone>5032541004</phone>\\n    </shipping-contact-info>\\n</wallet>\",\n      \"language\": \"xml\",\n      \"name\": \"200 OK - Visa Checkout\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n###Visa Checkout Wallet\nFor Visa Checkout, the request includes the `call-id`. The response content includes the wallet ID and the checkout details.\nFor more information, see [Implementing Visa Checkout](/docs/visa-checkout#section-implementing-visa-checkout).\n[block:html]\n{\n  \"html\": \"</div>\\n</div>\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \" </div>\\n</div>\"\n}\n[/block]\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","excerpt":"","slug":"create-wallet","type":"endpoint","title":"Create Wallet"}

Definition

https://sandbox.bluesnap.com/services/2/wallets


Documentation

The Create Wallet request is where you provide the initial parameters required by the wallet processor to launch the wallet's payment page. The response includes the wallet token.

This currently supports the Apple Pay on the web, MasterPass, and Visa Checkout wallets. For detailed setup instructions, see: