{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/transactions","auth":"optional","examples":{"codes":[]},"method":"post","results":{"codes":[{"language":"text","code":""}]},"settings":"57ee593a21ceb20e0061959e","params":[]},"next":{"description":"","pages":[]},"title":"Auth Only","type":"endpoint","slug":"auth-only","excerpt":"","body":"Auth Only is a request to check whether a credit card is valid and has the funds to complete a specific transaction (i.e. purchase). It does not actually run the charge on the card, but does temporarily hold the funds aside. Note that each credit card company will only hold the authorization for a limited period (for example, 3-10 days, depending on the credit card scheme).\n[block:callout]\n{\n \"type\": \"success\",\n \"body\": \"If you wish to check the validity of a card without authorizing any charge amount, simply enter **0** as the value for the `amount` property in this request.\",\n \"title\": \"Zero value auth for card validity checks\"\n}\n[/block]\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\n\nSend a **[cardTransaction](doc:card-transaction)** object, with the following:\n `walletId` *long* <span style=\"color:#F37500\">**required** if using Masterpass or Visa Checkout </span>\n `wallet` *object* <span style=\"color:#F37500\">**required** if using Apple Pay or Google Pay™</span> (refer to [wallet](doc:wallet)) \n `amount` *decimal* <span style=\"color:#F37500\">**required**</span>\n `vaultedShopperId` *integer* <span style=\"color:#F37500\">**required** if using a vaulted shopper</span>\n `merchantTransactionId` *string* optional\n `softDescriptor` *string* optional\n `descriptorPhoneNumber` *string* optional\n `vendorsInfo` *container* optional applicable if using marketplace vendor(s) (refer to [vendorsInfo](doc:vendorsinfo))\n `cardHolderInfo` *object* <span style=\"color:#F37500\">**required** for [LatAm local processing](/docs/latam-local-processing)</span> (refer to [cardHolderInfo](doc:card-holder-info))\n `currency` *string* <span style=\"color:#F37500\">**required**</span>\n `transactionFraudInfo` *object* optional (refer to [transactionFraudInfo](doc:transaction-fraud-info))\n `creditCard` *object* <span style=\"color:#F37500\">**required** if sending card data or if vaulted shopper has multiple cards; do **not** include if sending `pfToken` or `wallet`</span> (refer to [creditCard](doc:credit-card))\n `cardTransactionType` *string* <span style=\"color:#F37500\">**required**</span>, value must be **AUTH_ONLY**\n `threeDSecure` *object* optional (refer to [threeDSecure](doc:threedsecure))\n `transactionMetaData` *object* optional (refer to [transactionMetaData](doc:transaction-meta-data))\n `pfToken` *string* <span style=\"color:#F37500\">**required** if using [Hosted Payment Fields](/v8976-Tools/docs/hosted-payment-fields), [Embedded Checkout](/v8976-Tools/docs/embedded-checkout), or [Secured Payment Collector](doc:secured-payment-collector) </span></span>\n `level3Data` *object* optional (refer to [level3Data](doc:level3data))\n `storeCard` *boolean* optional (refer to [cardTransaction](doc:card-transaction))\n\n###Response Details\n\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the request properties plus these additions:\n\n `vaultedShopperId`\n `processingInfo`\n `fraudResultInfo` if [fraud prevention](/docs/fraud-prevention) is enabled\n `threeDSecure` if sending 3D Secure authentication data\n `transactionId`\n `vendorsInfo` if using marketplace vendor(s)\n `level3Data` if sending Level 2/3 data\n `storeCard` if sending store card data\n<hr>\n\n##Examples\n\n###Request Examples \n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"transactionFraudInfo\\\": {\\n \\\"shopperIpAddress\\\": \\\"123.12.134.1\\\",\\n \\\"fraudSessionId\\\": 1234,\\n \\\"company\\\": \\\"BBBBB\\\",\\n \\\"shippingContactInfo\\\": {\\n \\\"zip\\\": 12345,\\n \\\"country\\\": \\\"US\\\",\\n \\\"firstName\\\": \\\"YY\\\",\\n \\\"lastName\\\": \\\"LL\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address2\\\": \\\"Address2\\\",\\n \\\"address1\\\": \\\"Address1\\\",\\n \\\"state\\\": \\\"AL\\\"\\n }\\n },\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Auth Only Request: basic with fraud info\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"transactionFraudInfo\\\": {\\n \\\"enterpriseSiteId\\\": \\\"DEFAULT\\\",\\n \\\"shopperIpAddress\\\": \\\"123.12.134.1\\\",\\n \\\"fraudSessionId\\\": 1234,\\n \\\"enterpriseUdfs\\\": {\\\"udf\\\": [\\n {\\n \\\"udfValue\\\": \\\"aaa\\\",\\n \\\"udfName\\\": \\\"ENT_UDF1\\\"\\n },\\n {\\n \\\"udfValue\\\": \\\"bbb\\\",\\n \\\"udfName\\\": \\\"ENT_UDF2\\\"\\n }\\n ]},\\n \\\"company\\\": \\\"BBBBB\\\",\\n \\\"shippingContactInfo\\\": {\\n \\\"zip\\\": 12345,\\n \\\"country\\\": \\\"US\\\",\\n \\\"firstName\\\": \\\"YY\\\",\\n \\\"lastName\\\": \\\"LL\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address2\\\": \\\"Address2\\\",\\n \\\"address1\\\": \\\"Address1\\\",\\n \\\"state\\\": \\\"AL\\\"\\n }\\n },\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with fraud info\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 20781033,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with vaulted shopper who has one card\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardType\\\": \\\"VISA\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with vaulted shopper and credit card specified\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionMetaData\\\": {\\\"metaData\\\": [\\n {\\n \\\"metaValue\\\": 20,\\n \\\"metaKey\\\": \\\"stateTaxAmount\\\",\\n \\\"metaDescription\\\": \\\"State Tax Amount\\\"\\n },\\n {\\n \\\"metaValue\\\": 20,\\n \\\"metaKey\\\": \\\"cityTaxAmount\\\",\\n \\\"metaDescription\\\": \\\"City Tax Amount\\\"\\n },\\n {\\n \\\"metaValue\\\": 10,\\n \\\"metaKey\\\": \\\"shippingAmount\\\",\\n \\\"metaDescription\\\": \\\"Shipping Amount\\\"\\n }\\n ]}\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with metadata\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"merchantTransactionId\\\": \\\"cc-412\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"Jane\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with Merchant Transaction ID\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"walletId\\\": 21,\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with wallet ID\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"encryptedCardNumber\\\": \\\"$bsjs_1_0_3$B23uuxq8drUwOYZm3wZi+Qm69V5GPEt8PEio+Edwcm8akczQSK7odgLQH/Au+VqOCsGspW1Q9mPyQIzGLSZLVToAQVfq5C1ld+2ogIIsDL32Hd6IojboLyVlYT1FvPQoDyz19K6N0CUHh5uk0kCLuHSUyjvoJH38ojHZifbJSm/7S5vAtiuC3BJt2z8k9nauQaAXkbyoAYwrS1yDpqOt2k2lGhKcmdQ4ImDR0RL8m8xig6sFrki9oqo3Mju/M5r7wXXVTf7TMtWiQbzdfREOxKUnviXJZpncdHqVjj5GvPYun2qgopKVKr8F5+yd19TVW2gvA1kXBkXonFL9159Gxg==$zckJgo2i8jXDiAHwVVHBKypXFnWqF2e+6luBkmtQQRKniDXyXaalRVKLtYscBaGd$W7Ojqk1Q2iOJVeGL39RAsZTtfup3f1deSzvxrvC9rXA=\\\",\\n \\\"encryptedSecurityCode\\\": \\\"$bsjs_1_0_3$MB1nBpok/YkuWPG1/7e6dyFFhDPHB8p8E9Yo+0YHHV+xkHuzFKr02wAnE8PJ8QCzWH+2ctXy5FN6wLKjwFrfTOgy0BJ9k9+NDEe8mhsu66wMlyc3lnwrbvMRCWN1O+5gUNCFExj7B0mDtf4gtxecXs74KZ5l5dbpGWdKUk5i7OewWyTqsONbn9taLfVBOwuIOy2Jgi4fx+yB8Q05KdZeHSNSBJh8H/47AUNAn5dM+d9iO6yGQB3obzEzzR3UtHlkGR52ZsgbbFh0JMm9lBM2ClgYM8jvmQjS9HX2ojt1fkbhuPEb1IY/M498a+1wDPpI4aMfDxO1lSpJneRSpY5k4g==$XaKq1NbPcS0iHy9N9jHekEIByHYS4G3wJXlC9EQjAGM=$BJn6X6mBYGUo8Eoq4RQz69gsi4Azl8jT973mNpG9Yuo=\\\",\\n \\\"expirationMonth\\\": \\\"07\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with encrypted credit card\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"pfToken\\\": \\\"abcde12345**********\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with Hosted Payment Fields token\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{ \\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"vendorsInfo\\\": {\\n \\t\\\"vendorInfo\\\": [\\n {\\\"vendorId\\\": \\\"514147\\\"}\\n ]\\n },\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"transactionFraudInfo\\\": {\\n \\\"shopperIpAddress\\\": \\\"123.12.134.1\\\",\\n \\\"fraudSessionId\\\": 1234,\\n \\\"company\\\": \\\"BBBBB\\\",\\n \\\"shippingContactInfo\\\": {\\n \\\"zip\\\": 12345,\\n \\\"country\\\": \\\"US\\\",\\n \\\"firstName\\\": \\\"YY\\\",\\n \\\"lastName\\\": \\\"LL\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address2\\\": \\\"Address2\\\",\\n \\\"address1\\\": \\\"Address1\\\",\\n \\\"state\\\": \\\"AL\\\"\\n }\\n },\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"basic with vendors info\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"amount\\\": 11.00,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"wallet\\\": {\\n \\\"walletType\\\": \\\"APPLE_PAY\\\",\\n \\\"encodedPaymentToken\\\": \\\"ImRhdGEiOiJuY1AvRitIUy8zeG5bXhCMFd\\\"\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with Apple Pay\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\", \\n \\t\\\"securityCode\\\": \\\"837\\\" \\t\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with vaulted shopper & CVV\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"amount\\\": \\\"11.00\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"vaultedShopperId\\\": \\\"20769005\\\",\\n \\\"creditCard\\\": {\\n \\\"cardNumber\\\": \\\"4012000033330026\\\",\\n \\\"securityCode\\\": \\\"111\\\",\\n \\\"expirationMonth\\\": \\\"07\\\",\\n \\\"expirationYear\\\": \\\"2023\\\"\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with vaulted shopper & new card\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"transactionFraudInfo\\\": {\\n \\\"shopperIpAddress\\\": \\\"123.12.134.1\\\",\\n \\\"fraudSessionId\\\": 1234,\\n \\\"company\\\": \\\"BBBBB\\\",\\n \\\"shippingContactInfo\\\": {\\n \\\"zip\\\": 12345,\\n \\\"country\\\": \\\"US\\\",\\n \\\"firstName\\\": \\\"YY\\\",\\n \\\"lastName\\\": \\\"LL\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address2\\\": \\\"Address2\\\",\\n \\\"address1\\\": \\\"Address1\\\",\\n \\\"state\\\": \\\"AL\\\"\\n }\\n },\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"storeCard\\\": true\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with store card approval\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"amount\\\": 11.00,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"wallet\\\": {\\n \\\"walletType\\\": \\\"GOOGLE_PAY\\\",\\n \\\"encodedPaymentToken\\\": \\\"ImRhdGEiOiJuY1AvRitIUy8zeG5bXhCMFd\\\"\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with Google Pay\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"pfToken\\\": \\\"abcde12345**********\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with Embedded Checkout token\"\n }\n ],\n \"sidebar\": true\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fraudResultInfo\\\": {\\\"deviceDataCollector\\\": \\\"Y\\\"},\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38488222\\n}\",\n \"language\": \"json\",\n \"name\": \"200 OK - basic: with fraud info\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 19549066,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38488224\\n}\",\n \"language\": \"json\",\n \"name\": \"vaulted shopper (whether credit card was specified or not)\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"avsResponseCode\\\": \\\"G\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionMetaData\\\": {\\\"metaData\\\": [\\n {\\n \\\"metaValue\\\": 20,\\n \\\"metaKey\\\": \\\"stateTaxAmount\\\",\\n \\\"metaDescription\\\": \\\"State Tax Amount\\\"\\n },\\n {\\n \\\"metaValue\\\": 20,\\n \\\"metaKey\\\": \\\"cityTaxAmount\\\",\\n \\\"metaDescription\\\": \\\"City Tax Amount\\\"\\n },\\n {\\n \\\"metaValue\\\": 10,\\n \\\"metaKey\\\": \\\"shippingAmount\\\",\\n \\\"metaDescription\\\": \\\"Shipping Amount\\\"\\n }\\n ]},\\n \\\"transactionId\\\": 38497126\\n}\",\n \"language\": \"json\",\n \"name\": \"with metadata\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"merchantTransactionId\\\": \\\"cc-412\\\",\\n \\\"transactionId\\\": \\\"1035748005\\\",\\n \\\"softDescriptor\\\": \\\"BLS*default_descriptor\\\",\\n \\\"amount\\\": 11,\\n \\\"usdAmount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"Jane\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"vaultedShopperId\\\": 28911419,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardCategory\\\": \\\"PLATINUM\\\",\\n \\\"binCategory\\\": \\\"CONSUMER\\\",\\n \\\"cardRegulated\\\": \\\"N\\\",\\n \\\"issuingBank\\\": \\\"ALLIED IRISH BANKS PLC\\\",\\n \\\"issuingCountryCode\\\": \\\"ie\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"authorizationCode\\\": \\\"123456\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n },\\n \\\"fraudResultInfo\\\": {}\\n}\",\n \"language\": \"json\",\n \"name\": \"with Merchant Transaction ID\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 123,\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"NC\\\"\\n },\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 1011702615\\n}\",\n \"language\": \"json\",\n \"name\": \"with wallet ID\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"ND\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 1111,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38504158\\n}\",\n \"language\": \"json\",\n \"name\": \"with encrypted credit card\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38486450\\n}\",\n \"language\": \"json\",\n \"name\": \"with Hosted Payment Fields\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"vendorInfo\\\": {\\n \\\"vendorId\\\": 514147,\\n \\\"commissionPercent\\\": 20\\n },\\n \\\"vendorsInfo\\\": {\\n \\\"vendorInfo\\\": [\\n {\\n \\\"vendorId\\\": 514147,\\n \\\"commissionPercent\\\": 20\\n }\\n ]\\n },\\n \\\"transactionId\\\": \\\"1015593705\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"vaultedShopperId\\\": 22324271,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardCategory\\\": \\\"GOLD\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with basic with vendors info\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38486450,\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11.00,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"wallet\\\": {\\n \\\"billingContactInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"address1\\\": \\\"South St\\\",\\n \\\"city\\\": \\\"Waltham\\\",\\n \\\"state\\\": \\\"MA\\\",\\n \\\"zip\\\": \\\"02453\\\"\\n },\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with Apple Pay\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": \\\"1012751945\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with vaulted shopper & CVV\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": \\\"1014303431\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"0026\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"ND\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with vaulted shopper & new card \"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": \\\"1016888481\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"vaultedShopperId\\\": 22730353,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardCategory\\\": \\\"GOLD\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeZip\\\": \\\"U\\\",\\n \\\"avsResponseCodeAddress\\\": \\\"U\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with store card approval\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": \\\"1012751937\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\t\\\"zip\\\": \\\"12345\\\"\\n },\\n \\\"vaultedShopperId\\\": 21289371,\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"9299\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with Google Pay\"\n },\n {\n \"code\": \"{\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": \\\"1012751937\\\",\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"amount\\\": 11,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\", \\n \\t\\\"zip\\\": \\\"12345\\\",\\n \\\"country\\\": \\\"us\\\"\\n },\\n \\\"vaultedShopperId\\\": 21289371,\\n \\\"wallet\\\": {\\n \\\"walletType\\\": \\\"GOOGLE_PAY\\\",\\n \\\"billingContactInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\\"zip\\\": \\\"123456\\\",\\n \\\"country\\\": \\\"us\\\"\\n },\\n \\\"tokenizedCard\\\": {\\n \\\"cardLastFourDigits\\\": \\\"1111\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"dpanExpirationMonth\\\": \\\"9\\\",\\n \\\"dpanExpirationYear\\\": \\\"2025\\\",\\n \\\"dpanLastFourDigits\\\": \\\"2222\\\"\\n }\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"success\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"with Google Pay with tokenized card\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38486450\\n}\",\n \"language\": \"json\",\n \"name\": \"with Embedded Checkout\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"vaultedShopperId\\\": 1234,\\n \\\"processingInfo\\\": {\\n \\\"avsResponseCodeAddress\\\": \\\"M\\\",\\n \\\"processingStatus\\\": \\\"success\\\",\\n \\\"cvvResponseCode\\\": \\\"MA\\\",\\n \\\"authorizationCode\\\": \\\"654321\\\",\\n \\\"avsResponseCodeName\\\": \\\"U\\\",\\n \\\"avsResponseCodeZip\\\": \\\"M\\\"\\n },\\n \\\"softDescriptor\\\": \\\"BLS*DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fraudResultInfo\\\": {\\\"deviceDataCollector\\\": \\\"Y\\\"},\\n \\\"creditCard\\\": {\\n \\\"cardLastFourDigits\\\": 9299,\\n \\\"cardSubType\\\": \\\"CREDIT\\\",\\n \\\"cardType\\\": \\\"VISA\\\",\\n \\t\\\"cardCategory\\\": \\\"CLASSIC\\\"\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\",\\n \\\"transactionId\\\": 38488222\\n}\",\n \"language\": \"json\",\n \"name\": \"with Authorization Code\"\n }\n ],\n \"sidebar\": true\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Example Descriptions\n###Basic Auth Only with fraud info\nThis example shows a basic Auth Only request, containing the minimum required fields for a one-time payment using a credit card. It includes the required fraud info in the`transactionFraudInfo` property within the [cardTransaction](doc:card-transaction) object. Refer to [transactionFraudInfo](doc:transaction-fraud-info).\n\nAn additional example with fraud info is above. Complete fraud info is supported only for merchants who have signed up for the Complete-level fraud service from BlueSnap. Refer to [Fraud prevention](/docs/fraud-prevention).\n\n###Auth Only with vaulted shopper\nTo perform an Auth Only request with an existing vaulted shopper, you'll need to include the `vaultedShopperId` property within the [cardTransaction](doc:card-transaction) object. When specifying a credit card for a vaulted shopper, you must include the `cardLastFourDigits` and `cardType` properties within the [creditCard](doc:credit-card) object.\n\nAbove are two vaulted shopper examples. The first is with a vaulted shopper who only has one credit card, so there is no need to specify which credit card to charge. The second is with a vaulted shopper who has multiple cards, so the request must indicate which card to charge.\n\n###Auth Only with metadata\nTo send metadata for the transaction, you'll need to include the `transactionMetaData` property within the [cardTransaction](doc:card-transaction) object. You can include up to 20 metadata key-value pairs in each `transactionMetaData` property. Refer to [transactionMetaData](doc:transaction-meta-data). \n\nAbove is an example of a request with metadata, including state tax, city tax, and the shipping amount.\n\n###Auth Only with Merchant Transaction ID\nYou may wish to assign your own ID to each transaction, for example in order to track the transactions in your own internal systems. To do this, you'll need to include the `merchantTransactionId` property within the [cardTransaction](doc:card-transaction) object.\n\nAbove is an example of a request that includes a Merchant Transaction ID (MTI), along with the minimum required fields for a one-time payment using a credit card. \n\n###Auth Only with wallet ID\nIf the shopper is paying via Masterpass or Visa Checkout, you can include the `walletId` in the request. For details, refer to :\n * [Masterpass Guide](/docs/masterpass)\n * [Visa Checkout Guide](/docs/visa-checkout)\n\nAbove is an example of a request with a Masterpass wallet.\n[block:callout]\n{\n \"type\": \"info\",\n \"body\": \"When you include the wallet ID in the request, a vaulted shopper will be automatically created and the vaulted shopper ID will be returned to you in the response.\\n\\nIf you prefer to save the wallet information in an existing shopper, it is recommended to instead send a [Create Vaulted Shopper](doc:create-vaulted-shopper) request with the wallet ID and then use that vaulted shopper in your Auth Only request.\",\n \"title\": \"Note:\"\n}\n[/block]\n###Auth Only with encrypted credit card\nYour [PCI compliance](/docs/pci-compliance) requirements and API permission level may require that you send credit card data in encrypted format only. To do this, you'll need to include the `encryptedCardNumber` and `encryptedSecurityCode` properties within the [cardTransaction](doc:card-transaction) object.\n\nAbove is an example of a request with an encrypted credit card number.\n\n###Auth Only with Hosted Payment Fields token\nIf you are using BlueSnap's [Hosted Payment Fields](/v8976-Tools/docs/hosted-payment-fields), you can process the shopper's payment using the information from the Hosted Payment Fields by including the token within the `pfToken` property in your request.\n\nAbove is an example of a request with the Hosted Payment Fields token.\n\nNote that the response will look like a regular response for a credit card, with the card's last four digits and card type.\n\n###Auth Only with Vendors Info\nThis example shows an Auth Only request with a marketplace vendor. If you are a Marketplace Merchant and you would like to link one or more vendors to the transaction in the authorization step, include `vendorsInfo` in the body. For more details, refer to the [Marketplace Guide](/docs/processing-transactions). \n\n###Auth Only with Apple Pay\nThis example shows an Auth Only request with Apple Pay. In the request, include `walletType` = APPLE_PAY and `encodedPaymentToken` inside `wallet`. Instructions on how to extract the `encodedPaymentToken` can be found in the [Apple Pay Guide](/docs/apple-pay#section-implementing-apple-pay-in-your-website-or-ios-app). \n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Note:\",\n \"body\": \"To test Apple Pay, follow the steps in the [Apple Pay Guide](/docs/apple-pay#section-implementing-apple-pay-in-your-website-or-ios-app). The API Explorer does not support Apple Pay testing.\"\n}\n[/block]\n###Auth Only with vaulted shopper & CVV\nYou may wish to collect CVV on your checkout form from all your shoppers – even from returning shoppers. One reason you might choose to do this is that transactions with CVV generally result in higher success rates. \n\nAbove is an example of sending CVV in a transaction request involving a returning shopper. \nInclude `vaultedShopperId` and CVV in the request as in the example. \n\n###Auth Only with vaulted shopper & new card \nThis example shows an Auth Only request with a vaulted shopper and a new card. If you include `vaultedShopperId` and a new card in the request, the shopper's card will be charged and the card details will be added to the shopper. \n\n###Auth Only with store card approval\nThis example shows an Auth Only request with the `storeCard` value set. You will want to use this value to define if the shopper has approved storing their credit card information for future use. The default value is set to true. If set to false, the credit card data will not be stored.\n\n###Auth Only with Google Pay\nThis example shows an Auth Only request with Google Pay. In the request, include `walletType` = GOOGLE_PAY and `encodedPaymentToken` inside `wallet`. Instructions on how to extract the `encodedPaymentToken` can be found in the [Google Pay Guide](/docs/google-pay).\n\n###Auth Only with Embedded Checkout token\nIf you are using BlueSnap's [Embedded Checkout](/v8976-Tools/docs/embedded-checkout), you can process the shopper's payment using the information from the Embedded Payment Form by including the token within the `pfToken` property in your request.\n\nAbove is an example of a request with the Embedded Checkout token.\n\nNote that the response will look like a regular response for a credit card, with the card's last four digits and card type.\n\n\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n<hr>\n\n##API Explorer\nTo test out a call, enter the request content below and then click **Try it!** \n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Tip:\",\n \"body\": \"Use the JSON code below as a starting point. You can enter different parameters and test credit card numbers to see how your test scenario would work. *The request headers, including authorization, are already built in for you in this test area, so you should not include them here.*\"\n}\n[/block]\n\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"amount\\\": 11,\\n \\\"softDescriptor\\\": \\\"DescTest\\\",\\n \\\"cardHolderInfo\\\": {\\n \\\"firstName\\\": \\\"test first name\\\",\\n \\\"lastName\\\": \\\"test last name\\\",\\n \\t\\\"zip\\\": \\\"123456\\\"\\n },\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"creditCard\\\": {\\n \\\"expirationYear\\\": 2023,\\n \\\"securityCode\\\": 837,\\n \\\"expirationMonth\\\": \\\"02\\\",\\n \\\"cardNumber\\\": 4263982640269299\\n },\\n \\\"cardTransactionType\\\": \\\"AUTH_ONLY\\\"\\n}\",\n \"language\": \"json\"\n }\n ]\n}\n[/block]","updates":[],"order":1,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ff39c12e2e8fa00503ad59f","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Card/Wallet Transactions","slug":"payment-transaction-service","order":1,"from_sync":false,"reference":true,"_id":"5ff39c12e2e8fa00503ad52e","version":"5ff39c12e2e8fa00503ad5e4","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T15:28:41.796Z","__v":0},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.36.1 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ff39c12e2e8fa00503ad52d","5ff39c12e2e8fa00503ad52e","5ff39c12e2e8fa00503ad52f","5ff39c12e2e8fa00503ad530","5ff39c12e2e8fa00503ad531","5ff39c12e2e8fa00503ad532","5ff39c12e2e8fa00503ad533","5ff39c12e2e8fa00503ad534","5ff39c12e2e8fa00503ad535","5ff39c12e2e8fa00503ad536","5ff39c12e2e8fa00503ad537","5ff39c12e2e8fa00503ad538","5ff39c12e2e8fa00503ad539","5ff39c12e2e8fa00503ad53a","5ff39c12e2e8fa00503ad53b","5ff39c12e2e8fa00503ad53c","5ff39c12e2e8fa00503ad53d","5ff39c12e2e8fa00503ad53e","5ff39c12e2e8fa00503ad53f"],"_id":"5ff39c12e2e8fa00503ad5e4","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5fc6c6094cb8fa066b0d2ea3","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-01-19T00:49:48.003Z","githubsync":"","__v":0}
postAuth Only
Definition
Documentation
Auth Only is a request to check whether a credit card is valid and has the funds to complete a specific transaction (i.e. purchase). It does not actually run the charge on the card, but does temporarily hold the funds aside. Note that each credit card company will only hold the authorization for a limited period (for example, 3-10 days, depending on the credit card scheme).
Zero value auth for card validity checks
If you wish to check the validity of a card without authorizing any charge amount, simply enter 0 as the value for the amount
property in this request.
Request Content
Send a cardTransaction object, with the following:
walletId
long required if using Masterpass or Visa Checkout
wallet
object required if using Apple Pay or Google Pay™ (refer to wallet)
amount
decimal required
vaultedShopperId
integer required if using a vaulted shopper
merchantTransactionId
string optional
softDescriptor
string optional
descriptorPhoneNumber
string optional
vendorsInfo
container optional applicable if using marketplace vendor(s) (refer to vendorsInfo)
cardHolderInfo
object required for LatAm local processing (refer to cardHolderInfo)
currency
string required
transactionFraudInfo
object optional (refer to transactionFraudInfo)
creditCard
object required if sending card data or if vaulted shopper has multiple cards; do not include if sending pfToken
or wallet
(refer to creditCard)
cardTransactionType
string required, value must be AUTH_ONLY
threeDSecure
object optional (refer to threeDSecure)
transactionMetaData
object optional (refer to transactionMetaData)
pfToken
string required if using Hosted Payment Fields, Embedded Checkout, or Secured Payment Collector
level3Data
object optional (refer to level3Data)
storeCard
boolean optional (refer to cardTransaction)
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
vaultedShopperId
processingInfo
fraudResultInfo
if fraud prevention is enabled
threeDSecure
if sending 3D Secure authentication data
transactionId
vendorsInfo
if using marketplace vendor(s)
level3Data
if sending Level 2/3 data
storeCard
if sending store card data
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"transactionFraudInfo": {
"shopperIpAddress": "123.12.134.1",
"fraudSessionId": 1234,
"company": "BBBBB",
"shippingContactInfo": {
"zip": 12345,
"country": "US",
"firstName": "YY",
"lastName": "LL",
"city": "Juneau",
"address2": "Address2",
"address1": "Address1",
"state": "AL"
}
},
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"transactionFraudInfo": {
"enterpriseSiteId": "DEFAULT",
"shopperIpAddress": "123.12.134.1",
"fraudSessionId": 1234,
"enterpriseUdfs": {"udf": [
{
"udfValue": "aaa",
"udfName": "ENT_UDF1"
},
{
"udfValue": "bbb",
"udfName": "ENT_UDF2"
}
]},
"company": "BBBBB",
"shippingContactInfo": {
"zip": 12345,
"country": "US",
"firstName": "YY",
"lastName": "LL",
"city": "Juneau",
"address2": "Address2",
"address1": "Address1",
"state": "AL"
}
},
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"vaultedShopperId": 20781033,
"softDescriptor": "DescTest",
"currency": "USD",
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"vaultedShopperId": 20769005,
"softDescriptor": "DescTest",
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardType": "VISA"
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY",
"transactionMetaData": {"metaData": [
{
"metaValue": 20,
"metaKey": "stateTaxAmount",
"metaDescription": "State Tax Amount"
},
{
"metaValue": 20,
"metaKey": "cityTaxAmount",
"metaDescription": "City Tax Amount"
},
{
"metaValue": 10,
"metaKey": "shippingAmount",
"metaDescription": "Shipping Amount"
}
]}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"currency": "USD",
"merchantTransactionId": "cc-412",
"cardHolderInfo": {
"firstName": "Jane",
"lastName": "Smith",
"zip": "123456"
},
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"walletId": 21,
"amount": 11,
"currency": "USD",
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"expirationYear": 2023,
"encryptedCardNumber": "$bsjs_1_0_3$B23uuxq8drUwOYZm3wZi+Qm69V5GPEt8PEio+Edwcm8akczQSK7odgLQH/Au+VqOCsGspW1Q9mPyQIzGLSZLVToAQVfq5C1ld+2ogIIsDL32Hd6IojboLyVlYT1FvPQoDyz19K6N0CUHh5uk0kCLuHSUyjvoJH38ojHZifbJSm/7S5vAtiuC3BJt2z8k9nauQaAXkbyoAYwrS1yDpqOt2k2lGhKcmdQ4ImDR0RL8m8xig6sFrki9oqo3Mju/M5r7wXXVTf7TMtWiQbzdfREOxKUnviXJZpncdHqVjj5GvPYun2qgopKVKr8F5+yd19TVW2gvA1kXBkXonFL9159Gxg==$zckJgo2i8jXDiAHwVVHBKypXFnWqF2e+6luBkmtQQRKniDXyXaalRVKLtYscBaGd$W7Ojqk1Q2iOJVeGL39RAsZTtfup3f1deSzvxrvC9rXA=",
"encryptedSecurityCode": "$bsjs_1_0_3$MB1nBpok/YkuWPG1/7e6dyFFhDPHB8p8E9Yo+0YHHV+xkHuzFKr02wAnE8PJ8QCzWH+2ctXy5FN6wLKjwFrfTOgy0BJ9k9+NDEe8mhsu66wMlyc3lnwrbvMRCWN1O+5gUNCFExj7B0mDtf4gtxecXs74KZ5l5dbpGWdKUk5i7OewWyTqsONbn9taLfVBOwuIOy2Jgi4fx+yB8Q05KdZeHSNSBJh8H/47AUNAn5dM+d9iO6yGQB3obzEzzR3UtHlkGR52ZsgbbFh0JMm9lBM2ClgYM8jvmQjS9HX2ojt1fkbhuPEb1IY/M498a+1wDPpI4aMfDxO1lSpJneRSpY5k4g==$XaKq1NbPcS0iHy9N9jHekEIByHYS4G3wJXlC9EQjAGM=$BJn6X6mBYGUo8Eoq4RQz69gsi4Azl8jT973mNpG9Yuo=",
"expirationMonth": "07"
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"cardTransactionType": "AUTH_ONLY",
"pfToken": "abcde12345**********"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"vendorsInfo": {
"vendorInfo": [
{"vendorId": "514147"}
]
},
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"transactionFraudInfo": {
"shopperIpAddress": "123.12.134.1",
"fraudSessionId": 1234,
"company": "BBBBB",
"shippingContactInfo": {
"zip": 12345,
"country": "US",
"firstName": "YY",
"lastName": "LL",
"city": "Juneau",
"address2": "Address2",
"address1": "Address1",
"state": "AL"
}
},
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"cardTransactionType": "AUTH_ONLY",
"softDescriptor": "DescTest",
"amount": 11.00,
"currency": "USD",
"wallet": {
"walletType": "APPLE_PAY",
"encodedPaymentToken": "ImRhdGEiOiJuY1AvRitIUy8zeG5bXhCMFd"
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"vaultedShopperId": 20769005,
"softDescriptor": "DescTest",
"currency": "USD",
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"securityCode": "837"
},
"cardTransactionType": "AUTH_ONLY"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"cardTransactionType": "AUTH_ONLY",
"softDescriptor": "DescTest",
"amount": "11.00",
"currency": "USD",
"vaultedShopperId": "20769005",
"creditCard": {
"cardNumber": "4012000033330026",
"securityCode": "111",
"expirationMonth": "07",
"expirationYear": "2023"
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"transactionFraudInfo": {
"shopperIpAddress": "123.12.134.1",
"fraudSessionId": 1234,
"company": "BBBBB",
"shippingContactInfo": {
"zip": 12345,
"country": "US",
"firstName": "YY",
"lastName": "LL",
"city": "Juneau",
"address2": "Address2",
"address1": "Address1",
"state": "AL"
}
},
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY",
"storeCard": true
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"cardTransactionType": "AUTH_ONLY",
"softDescriptor": "DescTest",
"amount": 11.00,
"currency": "USD",
"wallet": {
"walletType": "GOOGLE_PAY",
"encodedPaymentToken": "ImRhdGEiOiJuY1AvRitIUy8zeG5bXhCMFd"
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 11,
"softDescriptor": "DescTest",
"currency": "USD",
"cardTransactionType": "AUTH_ONLY",
"pfToken": "abcde12345**********"
}'
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "M",
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "M"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"fraudResultInfo": {"deviceDataCollector": "Y"},
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38488222
}
{
"amount": 11,
"vaultedShopperId": 19549066,
"processingInfo": {
"avsResponseCodeAddress": "M",
"processingStatus": "success",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "M"
},
"softDescriptor": "BLS*DescTest",
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38488224
}
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "U",
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "U"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"avsResponseCode": "G",
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionMetaData": {"metaData": [
{
"metaValue": 20,
"metaKey": "stateTaxAmount",
"metaDescription": "State Tax Amount"
},
{
"metaValue": 20,
"metaKey": "cityTaxAmount",
"metaDescription": "City Tax Amount"
},
{
"metaValue": 10,
"metaKey": "shippingAmount",
"metaDescription": "Shipping Amount"
}
]},
"transactionId": 38497126
}
{
"cardTransactionType": "AUTH_ONLY",
"merchantTransactionId": "cc-412",
"transactionId": "1035748005",
"softDescriptor": "BLS*default_descriptor",
"amount": 11,
"usdAmount": 11,
"currency": "USD",
"cardHolderInfo": {
"firstName": "Jane",
"lastName": "Smith",
"zip": "123456"
},
"vaultedShopperId": 28911419,
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "PLATINUM",
"binCategory": "CONSUMER",
"cardRegulated": "N",
"issuingBank": "ALLIED IRISH BANKS PLC",
"issuingCountryCode": "ie"
},
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "MA",
"authorizationCode": "123456",
"avsResponseCodeZip": "U",
"avsResponseCodeAddress": "U",
"avsResponseCodeName": "U"
},
"fraudResultInfo": {}
}
{
"amount": 11,
"vaultedShopperId": 123,
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "NC"
},
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name"
},
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 1011702615
}
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "U",
"processingStatus": "success",
"cvvResponseCode": "ND",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "U"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 1111,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38504158
}
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "M",
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "M"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38486450
}
{
"cardTransactionType": "AUTH_ONLY",
"vendorInfo": {
"vendorId": 514147,
"commissionPercent": 20
},
"vendorsInfo": {
"vendorInfo": [
{
"vendorId": 514147,
"commissionPercent": 20
}
]
},
"transactionId": "1015593705",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"vaultedShopperId": 22324271,
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "GOLD"
},
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeZip": "U",
"avsResponseCodeAddress": "U",
"avsResponseCodeName": "U"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38486450,
"softDescriptor": "BLS*DescTest",
"amount": 11.00,
"currency": "USD",
"vaultedShopperId": 1234,
"wallet": {
"billingContactInfo": {
"firstName": "John",
"lastName": "Doe",
"address1": "South St",
"city": "Waltham",
"state": "MA",
"zip": "02453"
},
},
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeZip": "M",
"avsResponseCodeAddress": "M",
"avsResponseCodeName": "U"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": "1012751945",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"vaultedShopperId": 20769005,
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "CLASSIC"
},
"processingInfo": {
"processingStatus": "success",
"avsResponseCodeZip": "U",
"avsResponseCodeAddress": "U",
"avsResponseCodeName": "U"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": "1014303431",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"vaultedShopperId": 20769005,
"creditCard": {
"cardLastFourDigits": "0026",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "CLASSIC"
},
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "ND",
"avsResponseCodeZip": "U",
"avsResponseCodeAddress": "U",
"avsResponseCodeName": "U"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": "1016888481",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"vaultedShopperId": 22730353,
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "GOLD"
},
"processingInfo": {
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeZip": "U",
"avsResponseCodeAddress": "U",
"avsResponseCodeName": "U"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": "1012751937",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "12345"
},
"vaultedShopperId": 21289371,
"creditCard": {
"cardLastFourDigits": "9299",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "CLASSIC"
},
"processingInfo": {
"processingStatus": "success"
}
}
{
"cardTransactionType": "AUTH_ONLY",
"transactionId": "1012751937",
"softDescriptor": "BLS*DescTest",
"amount": 11,
"currency": "USD",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "12345",
"country": "us"
},
"vaultedShopperId": 21289371,
"wallet": {
"walletType": "GOOGLE_PAY",
"billingContactInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456",
"country": "us"
},
"tokenizedCard": {
"cardLastFourDigits": "1111",
"cardType": "VISA",
"cardSubType": "CREDIT",
"dpanExpirationMonth": "9",
"dpanExpirationYear": "2025",
"dpanLastFourDigits": "2222"
}
},
"processingInfo": {
"processingStatus": "success"
}
}
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "M",
"processingStatus": "success",
"cvvResponseCode": "MA",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "M"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38486450
}
{
"amount": 11,
"vaultedShopperId": 1234,
"processingInfo": {
"avsResponseCodeAddress": "M",
"processingStatus": "success",
"cvvResponseCode": "MA",
"authorizationCode": "654321",
"avsResponseCodeName": "U",
"avsResponseCodeZip": "M"
},
"softDescriptor": "BLS*DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"fraudResultInfo": {"deviceDataCollector": "Y"},
"creditCard": {
"cardLastFourDigits": 9299,
"cardSubType": "CREDIT",
"cardType": "VISA",
"cardCategory": "CLASSIC"
},
"cardTransactionType": "AUTH_ONLY",
"transactionId": 38488222
}
Example Descriptions
Basic Auth Only with fraud info
This example shows a basic Auth Only request, containing the minimum required fields for a one-time payment using a credit card. It includes the required fraud info in thetransactionFraudInfo
property within the cardTransaction object. Refer to transactionFraudInfo.
An additional example with fraud info is above. Complete fraud info is supported only for merchants who have signed up for the Complete-level fraud service from BlueSnap. Refer to Fraud prevention.
Auth Only with vaulted shopper
To perform an Auth Only request with an existing vaulted shopper, you'll need to include the vaultedShopperId
property within the cardTransaction object. When specifying a credit card for a vaulted shopper, you must include the cardLastFourDigits
and cardType
properties within the creditCard object.
Above are two vaulted shopper examples. The first is with a vaulted shopper who only has one credit card, so there is no need to specify which credit card to charge. The second is with a vaulted shopper who has multiple cards, so the request must indicate which card to charge.
Auth Only with metadata
To send metadata for the transaction, you'll need to include the transactionMetaData
property within the cardTransaction object. You can include up to 20 metadata key-value pairs in each transactionMetaData
property. Refer to transactionMetaData.
Above is an example of a request with metadata, including state tax, city tax, and the shipping amount.
Auth Only with Merchant Transaction ID
You may wish to assign your own ID to each transaction, for example in order to track the transactions in your own internal systems. To do this, you'll need to include the merchantTransactionId
property within the cardTransaction object.
Above is an example of a request that includes a Merchant Transaction ID (MTI), along with the minimum required fields for a one-time payment using a credit card.
Auth Only with wallet ID
If the shopper is paying via Masterpass or Visa Checkout, you can include the walletId
in the request. For details, refer to :
Above is an example of a request with a Masterpass wallet.
Note:
When you include the wallet ID in the request, a vaulted shopper will be automatically created and the vaulted shopper ID will be returned to you in the response.
If you prefer to save the wallet information in an existing shopper, it is recommended to instead send a Create Vaulted Shopper request with the wallet ID and then use that vaulted shopper in your Auth Only request.
Auth Only with encrypted credit card
Your PCI compliance requirements and API permission level may require that you send credit card data in encrypted format only. To do this, you'll need to include the encryptedCardNumber
and encryptedSecurityCode
properties within the cardTransaction object.
Above is an example of a request with an encrypted credit card number.
Auth Only with Hosted Payment Fields token
If you are using BlueSnap's Hosted Payment Fields, you can process the shopper's payment using the information from the Hosted Payment Fields by including the token within the pfToken
property in your request.
Above is an example of a request with the Hosted Payment Fields token.
Note that the response will look like a regular response for a credit card, with the card's last four digits and card type.
Auth Only with Vendors Info
This example shows an Auth Only request with a marketplace vendor. If you are a Marketplace Merchant and you would like to link one or more vendors to the transaction in the authorization step, include vendorsInfo
in the body. For more details, refer to the Marketplace Guide.
Auth Only with Apple Pay
This example shows an Auth Only request with Apple Pay. In the request, include walletType
= APPLE_PAY and encodedPaymentToken
inside wallet
. Instructions on how to extract the encodedPaymentToken
can be found in the Apple Pay Guide.
Note:
To test Apple Pay, follow the steps in the Apple Pay Guide. The API Explorer does not support Apple Pay testing.
Auth Only with vaulted shopper & CVV
You may wish to collect CVV on your checkout form from all your shoppers – even from returning shoppers. One reason you might choose to do this is that transactions with CVV generally result in higher success rates.
Above is an example of sending CVV in a transaction request involving a returning shopper.
Include vaultedShopperId
and CVV in the request as in the example.
Auth Only with vaulted shopper & new card
This example shows an Auth Only request with a vaulted shopper and a new card. If you include vaultedShopperId
and a new card in the request, the shopper's card will be charged and the card details will be added to the shopper.
Auth Only with store card approval
This example shows an Auth Only request with the storeCard
value set. You will want to use this value to define if the shopper has approved storing their credit card information for future use. The default value is set to true. If set to false, the credit card data will not be stored.
Auth Only with Google Pay
This example shows an Auth Only request with Google Pay. In the request, include walletType
= GOOGLE_PAY and encodedPaymentToken
inside wallet
. Instructions on how to extract the encodedPaymentToken
can be found in the Google Pay Guide.
Auth Only with Embedded Checkout token
If you are using BlueSnap's Embedded Checkout, you can process the shopper's payment using the information from the Embedded Payment Form by including the token within the pfToken
property in your request.
Above is an example of a request with the Embedded Checkout token.
Note that the response will look like a regular response for a credit card, with the card's last four digits and card type.
API Explorer
To test out a call, enter the request content below and then click Try it!
Tip:
Use the JSON code below as a starting point. You can enter different parameters and test credit card numbers to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.
{
"amount": 11,
"softDescriptor": "DescTest",
"cardHolderInfo": {
"firstName": "test first name",
"lastName": "test last name",
"zip": "123456"
},
"currency": "USD",
"creditCard": {
"expirationYear": 2023,
"securityCode": 837,
"expirationMonth": "02",
"cardNumber": 4263982640269299
},
"cardTransactionType": "AUTH_ONLY"
}