{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"cardTransaction","type":"basic","slug":"card-transaction","excerpt":"Contains the information required to process a credit card transaction","body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"10-0\": \"`cardTransactionType`\",\n    \"10-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"10-3\": \"Defines the type of transaction. \\nPossible values: \\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n    \"h-4\": \"Description\",\n    \"10-2\": \"**Required**\",\n    \"13-0\": \"`pfToken`\",\n    \"13-1\": \"*string*\",\n    \"13-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using [Hosted Payment Fields](/v8976-Tools/docs/hosted-payment-fields) or [Embedded Checkout](/v8976-Tools/docs/embedded-checkout)*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"13-3\": \"Hosted Payment Fields Fields or Embedded Checkout token.\",\n    \"12-0\": \"`transactionMetaData`\",\n    \"12-1\": \"*object*\",\n    \"12-2\": \"Optional\",\n    \"12-3\": \"Refer to the  [transactionMetaData](doc:transaction-meta-data) details.\",\n    \"1-0\": \"`amount`\",\n    \"1-1\": \"*decimal*\",\n    \"1-2\": \"**Required** in AUTH_ONLY, AUTH_CAPTURE, and REFUND\\n\\nOptional in CAPTURE\\n\\nNot relevant for AUTH_REVERSAL\",\n    \"1-3\": \"Amount to be charged in the transaction, including decimal points.\\n\\nThe maximum value can be up to `999,999.99` but you must confirm this with support or your implementation specialist.\",\n    \"3-0\": \"`merchantTransactionId`\",\n    \"3-1\": \"*string*\",\n    \"3-2\": \"Optional\",\n    \"3-3\": \"Merchant's unique ID for a new transaction. 1–50 characters.\",\n    \"4-0\": \"`softDescriptor`\",\n    \"4-1\": \"*string*\",\n    \"4-2\": \"Optional\",\n    \"4-3\": \"Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.\",\n    \"6-0\": \"`cardHolderInfo`\",\n    \"6-1\": \"*object*\",\n    \"6-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if sending card data (including encrypted data) or `pfToken` and shopper is new*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"6-3\": \"Refer to the [cardHolderInfo](doc:card-holder-info) details.\",\n    \"7-0\": \"`currency`\",\n    \"7-1\": \"*string*\",\n    \"7-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"7-3\": \"Currency code (ISO 4217) of the amount to be charged. Refer to [Currency codes](/docs/currency-codes).\",\n    \"9-0\": \"`creditCard`\",\n    \"9-1\": \"*object*\",\n    \"9-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if sending card data or if `vaultedShopperId` is sent and the vaulted shopper has more than one credit card*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND.\",\n    \"9-3\": \"Refer to the [creditCard](doc:credit-card) details.\",\n    \"8-0\": \"`transactionFraudInfo`\",\n    \"8-1\": \"*object*\",\n    \"8-2\": \"Optional\",\n    \"8-3\": \"Refer to the  [transactionFraudInfo](doc:transaction-fraud-info) details.\",\n    \"2-0\": \"`vaultedShopperId`\",\n    \"2-1\": \"*integer*\",\n    \"2-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using a vaulted shopper*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"2-3\": \"ID of an existing vaulted shopper.\",\n    \"0-0\": \"`walletId`\",\n    \"0-1\": \"*long*\",\n    \"0-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using MasterPass or Visa Checkout*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"0-3\": \"ID of the wallet, obtained via the [Create Wallet](/v8976-Tools/docs/create-wallet) request.\",\n    \"14-0\": \"`transactionId`\",\n    \"14-1\": \"*string*\",\n    \"14-2\": \"**Required** in CAPTURE,  AUTH_REVERSAL, and REFUND\\n\\nNot relevant for AUTH_ONLY and AUTH_CAPTURE\",\n    \"14-3\": \"BlueSnap identifier for the transaction.\",\n    \"15-0\": \"`wallet`\",\n    \"15-1\": \"*object*\",\n    \"15-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using [Apple Pay](doc:apple-pay-guide) or [Google Pay](doc:google-pay)*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"15-3\": \"Refer to the [wallet](doc:wallet) details.\",\n    \"16-0\": \"`vendorsInfo`\",\n    \"16-1\": \"*object*\",\n    \"16-2\": \"*Relevant for Marketplaces*\\nOptional\",\n    \"16-3\": \"Refer to the [vendorsInfo](doc:vendorsinfo) details.\",\n    \"5-0\": \"`descriptorPhoneNumber`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"Optional\",\n    \"5-3\": \"Merchant's support phone number that will appear on the shopper's credit card statement. Maximum 20 characters.\",\n    \"11-0\": \"`threeDSecure`\",\n    \"11-1\": \"*object*\",\n    \"11-2\": \"Optional\",\n    \"11-3\": \"Refer to the [threeDSecure](doc:threedsecure) details.\",\n    \"17-0\": \"`level3Data`\",\n    \"17-1\": \"*object*\",\n    \"17-2\": \"Optional\",\n    \"17-3\": \"Refer to the [level3Data](doc:level3data) details.\",\n    \"18-0\": \"`storeCard`\",\n    \"18-1\": \"*boolean*\",\n    \"18-2\": \"Optional\",\n    \"18-3\": \"Indicates whether or not to store the shopper's payment data.\\n\\nPossible values:\\n**true (default)\\nfalse**\\n\\n**Note:** Not applicable when performing an Auth Only with an amount equal to zero.\\n\\nRefer to the [Card on File Guide](doc:card-on-file-guide).\",\n    \"19-0\": \"`transactionOrderSource`\",\n    \"19-1\": \"*string*\",\n    \"19-2\": \"Optional\",\n    \"19-3\": \"Identifies the order type.<br />The only option is `MOTO` &nbsp;(**M**ail **O**rder **T**elephone **O**rder). <br />Any other option is ignored.\",\n    \"20-0\": \"`transactionInitiator`\",\n    \"20-1\": \"*string*\",\n    \"20-2\": \"Optional\",\n    \"20-3\": \"Identifies who initiated the order.  Options are:\\n`MERCHANT` (for MIT)\\n`SHOPPER` (for CIT)\\n\\nRefer to the [3-D Secure Guide](https://support.bluesnap.com/docs/3d-secure).\",\n    \"21-0\": \"`networkTransactionInfo`\",\n    \"21-1\": \"*container*\",\n    \"21-2\": \"Optional\",\n    \"21-3\": \"See [networkTransactionInfo](doc:network-transaction-info)\"\n  },\n  \"cols\": 4,\n  \"rows\": 22\n}\n[/block]\n###Response\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"13-0\": \"`cardTransactionType`\",\n    \"13-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"13-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nSee Transaction Types\",\n    \"16-0\": \"`transactionId`\",\n    \"16-1\": \"*string*\",\n    \"16-3\": \"BlueSnap identifier for the transaction.\",\n    \"h-4\": \"Description\",\n    \"13-2\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n    \"16-2\": \"BlueSnap identifier for the transaction.\",\n    \"0-0\": \"`amount`\",\n    \"0-1\": \"*decimal*\",\n    \"0-2\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"2-0\": \"`vaultedShopperId`\",\n    \"2-1\": \"*integer*\",\n    \"2-2\": \"ID of an existing vaulted shopper.\",\n    \"3-0\": \"`merchantTransactionId`\",\n    \"3-1\": \"*string*\",\n    \"3-2\": \"Merchant's unique ID for a new transaction.\",\n    \"4-0\": \"`processingInfo`\",\n    \"4-1\": \"*object*\",\n    \"4-2\": \"See [processingInfo](doc:processing-info).\",\n    \"5-0\": \"`softDescriptor`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n    \"7-0\": \"`cardHolderInfo`\",\n    \"7-1\": \"*object*\",\n    \"7-2\": \"See [cardHolderInfo](doc:card-holder-info).\",\n    \"8-0\": \"`currency`\",\n    \"8-1\": \"*string*\",\n    \"8-2\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n    \"12-0\": \"`creditCard`\",\n    \"12-1\": \"*object*\",\n    \"12-2\": \"See [creditCard](doc:credit-card).\",\n    \"15-0\": \"`transactionMetaData`\",\n    \"15-1\": \"*object*\",\n    \"15-2\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n    \"11-0\": \"`fraudResultInfo`\",\n    \"11-1\": \"*object*\",\n    \"11-2\": \"See [fraudResultInfo](doc:fraud-result-info).\",\n    \"18-2\": \"See [refunds](doc:refunds).\",\n    \"18-1\": \"*object*\",\n    \"18-0\": \"`refunds`\",\n    \"19-0\": \"`wallet`\",\n    \"19-1\": \"*object*\",\n    \"19-2\": \"See [wallet](doc:wallet).\",\n    \"6-0\": \"`descriptorPhoneNumber`\",\n    \"6-1\": \"*string*\",\n    \"6-2\": \"Merchant's support phone number that will appear on the shopper's credit card statement.\",\n    \"20-0\": \"`vendorsInfo`\",\n    \"20-1\": \"*object*\",\n    \"20-2\": \"See [vendorsInfo](doc:vendorsinfo).\",\n    \"17-0\": \"`chargebacks`\",\n    \"17-1\": \"*object*\",\n    \"17-2\": \"See [chargebacks](doc:chargebacks).\",\n    \"21-0\": \"`level3Data`\",\n    \"21-1\": \"*object*\",\n    \"21-2\": \"See [level3Data](doc:level3data).\",\n    \"14-0\": \"`threeDSecure`\",\n    \"14-1\": \"*object*\",\n    \"14-2\": \"See [threeDSecure](doc:threedsecure).\",\n    \"1-0\": \"`openToCapture`\",\n    \"1-1\": \"*decimal*\",\n    \"1-2\": \"Remaining authorization amount available for capture.\",\n    \"22-2\": \"Indicates if the shopper provided permissions to store their payment data.\\n\\nPossible values:\\n**true (default)\\nfalse**\\n\\n**Note:** Not applicable when performing an Auth Only with an amount equal to zero.\\n\\nSee [Card on File Guide](doc:card-on-file-guide).\",\n    \"22-0\": \"`storeCard`\",\n    \"22-1\": \"*boolean*\",\n    \"23-0\": \"`networkTransactionInfo`\",\n    \"23-1\": \"*container*\",\n    \"23-2\": \"See [networkTransactionInfo](doc:network-transaction-info)\",\n    \"9-0\": \"`transactionApprovalDate`\",\n    \"10-0\": \"`transactionApprovalTime`\",\n    \"9-1\": \"*string*\",\n    \"9-2\": \"The date the transaction was approved.\",\n    \"10-1\": \"*string*\",\n    \"10-2\": \"The time the transaction was approved.  This is in Pacific time.\"\n  },\n  \"cols\": 3,\n  \"rows\": 24\n}\n[/block]","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5e5d3aa2dc4d35003d784d90","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"Live","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5e5d3aa2dc4d35003d784cf0","5e5d3aa2dc4d35003d784cf1","5e5d3aa2dc4d35003d784cf2","5e5d3aa2dc4d35003d784cf3","5e5d3aa2dc4d35003d784cf4","5e5d3aa2dc4d35003d784cf5","5e5d3aa2dc4d35003d784cf6","5e5d3aa2dc4d35003d784cf7","5e5d3aa2dc4d35003d784cf8","5e5d3aa2dc4d35003d784cf9","5e5d3aa2dc4d35003d784cfa","5e5d3aa2dc4d35003d784cfb","5e5d3aa2dc4d35003d784cfc","5e5d3aa2dc4d35003d784cfd","5e5d3aa2dc4d35003d784cfe","5e5d57ed1362cf0064910881","5e7a7ac40efab8003ae688c3"],"_id":"5e5d3aa2dc4d35003d784d9d","project":"57336fd5a6a9c40e00e13a0b","__v":2,"forked_from":"5c6c23e4735b81006177d0a4","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON Objects","slug":"resources","order":13,"from_sync":false,"reference":false,"_id":"5e5d3aa2dc4d35003d784cfb","version":"5e5d3aa2dc4d35003d784d9d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2019-07-18T15:09:10.082Z","__v":0,"parentDoc":null}