{"_id":"59a45d2cd12e81000f842f3a","category":{"_id":"59a45d2bd12e81000f842eee","version":"59a45d2bd12e81000f842ee2","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":11,"slug":"resources","title":"JSON Objects"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"59a45d2bd12e81000f842ee2","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-08-28T18:12:59.168Z","releaseDate":"2017-08-28T18:12:59.168Z","categories":["59a45d2bd12e81000f842ee3","59a45d2bd12e81000f842ee4","59a45d2bd12e81000f842ee5","59a45d2bd12e81000f842ee6","59a45d2bd12e81000f842ee7","59a45d2bd12e81000f842ee8","59a45d2bd12e81000f842ee9","59a45d2bd12e81000f842eea","59a45d2bd12e81000f842eeb","59a45d2bd12e81000f842eec","59a45d2bd12e81000f842eed","59a45d2bd12e81000f842eee","59a45d2bd12e81000f842eef","59a45d2bd12e81000f842ef0","59a45d2bd12e81000f842ef1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.22.1","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-15T19:23:06.210Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":52,"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. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n \"h-4\": \"Description\",\n \"10-2\": \"**Required**\",\n \"12-0\": \"`pfToken`\",\n \"12-1\": \"*string*\",\n \"12-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using [Hosted Payment Fields](/v4.0/docs/hosted-payment-fields)*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n \"12-3\": \"Hosted Payment Fields token\",\n \"11-0\": \"`transactionMetaData`\",\n \"11-1\": \"*object*\",\n \"11-2\": \"Optional\",\n \"11-3\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"1-0\": \"`amount`\",\n \"1-1\": \"*decimal*\",\n \"1-2\": \"**Required** in AUTH_ONLY, AUTH_CAPTURE, and REFUND\\n\\nNot relevant for CAPTURE and AUTH_REVERSAL\",\n \"1-3\": \"Amount to be charged in the transaction, including decimal points.\",\n \"3-0\": \"`recurringTransaction`\",\n \"3-1\": \"*string*\",\n \"3-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n \"3-3\": \"Enter ECOMMERCE for all transactions, unless you're managing your own subscriptions in which case you will utilize the RECURRING value. See the [Subscriptions Guide](/v2.1/docs/subscription-management#section-processing-merchant-managed-credit-card-subscription-payments) to learn when to send RECURRING.\",\n \"4-0\": \"`merchantTransactionId`\",\n \"4-1\": \"*string*\",\n \"4-2\": \"Optional\",\n \"4-3\": \"Merchant's unique ID for a new transaction. Length: 1..50\",\n \"5-0\": \"`softDescriptor`\",\n \"5-1\": \"*string*\",\n \"5-2\": \"Optional\",\n \"5-3\": \"Description of the transaction, which appears on the shopper's credit card statement.\",\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\": \"See [cardHolderInfo](doc:card-holder-info).\",\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. See [Currency codes](/v1.0/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\": \"See [creditCard](doc:credit-card).\",\n \"8-0\": \"`transactionFraudInfo`\",\n \"8-1\": \"*object*\",\n \"8-2\": \"Optional\",\n \"8-3\": \"See [transactionFraudInfo](doc:transaction-fraud-info).\",\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](/v4.0/docs/create-wallet) request.\",\n \"13-0\": \"`transactionId`\",\n \"13-1\": \"*integer*\",\n \"13-2\": \"**Required** in CAPTURE, AUTH_REVERSAL, and REFUND\\n\\nNot relevant for AUTH_ONLY and AUTH_CAPTURE\",\n \"13-3\": \"BlueSnap identifier for the transaction.\",\n \"14-0\": \"`wallet`\",\n \"14-1\": \"*object*\",\n \"14-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using Apple Pay*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n \"14-3\": \"See [wallet](doc:wallet).\",\n \"15-0\": \"`vendorInfo`\",\n \"15-1\": \"*object*\",\n \"15-2\": \"*Relevant for Marketplaces*\\nOptional\",\n \"15-3\": \"See [vendorInfo](doc:vendorinfo-1)\"\n },\n \"cols\": 4,\n \"rows\": 16\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 \"10-0\": \"`cardTransactionType`\",\n \"10-1\": \"*string*\",\n \"h-3\": \"Description\",\n \"10-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nSee Transaction Types\",\n \"12-0\": \"`transactionId`\",\n \"12-1\": \"*integer*\",\n \"12-3\": \"BlueSnap identifier for the transaction.\",\n \"h-4\": \"Description\",\n \"10-2\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n \"12-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 \"1-0\": \"`vaultedShopperId`\",\n \"1-1\": \"*integer*\",\n \"1-2\": \"ID of an existing vaulted shopper.\",\n \"2-0\": \"`recurringTransaction`\",\n \"2-1\": \"*string*\",\n \"2-2\": \"Enter ECOMMERCE for a one-time transaction or RECURRING for a recurring transaction.\",\n \"3-0\": \"`merchantTransactionId`\",\n \"3-1\": \"*string*\",\n \"3-2\": \"Merchant's unique ID for a new transaction. Length: 1..50\",\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 \"6-0\": \"`cardHolderInfo`\",\n \"6-1\": \"*object*\",\n \"6-2\": \"See [cardHolderInfo](doc:card-holder-info).\",\n \"7-0\": \"`currency`\",\n \"7-1\": \"*string*\",\n \"7-2\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/v1.0/docs/currency-codes).\",\n \"9-0\": \"`creditCard`\",\n \"9-1\": \"*object*\",\n \"9-2\": \"See [creditCard](doc:credit-card).\",\n \"11-0\": \"`transactionMetaData`\",\n \"11-1\": \"*object*\",\n \"11-2\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"8-0\": \"`fraudResultInfo`\",\n \"8-1\": \"*object*\",\n \"8-2\": \"See [fraudResultInfo](doc:fraud-result-info).\",\n \"13-2\": \"See [refunds](doc:refunds).\",\n \"13-1\": \"*object*\",\n \"13-0\": \"`refunds`\",\n \"14-0\": \"`wallet`\",\n \"14-1\": \"*object*\",\n \"14-2\": \"See [wallet](doc:wallet).\",\n \"15-0\": \"`vendorInfo`\",\n \"15-1\": \"*object*\",\n \"15-2\": \"See [vendorInfo](doc:vendorinfo-1)\"\n },\n \"cols\": 3,\n \"rows\": 16\n}\n[/block]","excerpt":"Contains the information required to process a credit card transaction","slug":"card-transaction","type":"basic","title":"cardTransaction"}cardTransaction
walletId
long
Required in AUTH_ONLY and AUTH_CAPTURE if using MasterPass or Visa Checkout
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
ID of the wallet, obtained via the Create Wallet request.
amount
decimal
Required in AUTH_ONLY, AUTH_CAPTURE, and REFUND
Not relevant for CAPTURE and AUTH_REVERSAL
Amount to be charged in the transaction, including decimal points.
vaultedShopperId
integer
Required in AUTH_ONLY and AUTH_CAPTURE if using a vaulted shopper
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
ID of an existing vaulted shopper.
recurringTransaction
string
Required in AUTH_ONLY and AUTH_CAPTURE
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Enter ECOMMERCE for all transactions, unless you're managing your own subscriptions in which case you will utilize the RECURRING value. See the Subscriptions Guide to learn when to send RECURRING.
merchantTransactionId
string
Optional
Merchant's unique ID for a new transaction. Length: 1..50
softDescriptor
string
Optional
Description of the transaction, which appears on the shopper's credit card statement.
cardHolderInfo
object
Required in AUTH_ONLY and AUTH_CAPTURE if sending card data (including encrypted data) or pfToken and shopper is new
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
See cardHolderInfo.
currency
string
Required in AUTH_ONLY and AUTH_CAPTURE
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Currency code (ISO 4217) of the amount to be charged. See Currency codes.
creditCard
object
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
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND.
See creditCard.
cardTransactionType
string
Required
Defines the type of transaction. Values can be:
AUTH_ONLY
AUTH_CAPTURE
CAPTURE
AUTH_REVERSAL
REFUND
pfToken
string
Required in AUTH_ONLY and AUTH_CAPTURE if using Hosted Payment Fields
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Hosted Payment Fields token
transactionId
integer
Required in CAPTURE, AUTH_REVERSAL, and REFUND
Not relevant for AUTH_ONLY and AUTH_CAPTURE
BlueSnap identifier for the transaction.
wallet
object
Required in AUTH_ONLY and AUTH_CAPTURE if using Apple Pay
Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
See wallet.
amount
decimal
Amount to be charged in the transaction, including decimal points.
vaultedShopperId
integer
ID of an existing vaulted shopper.
recurringTransaction
string
Enter ECOMMERCE for a one-time transaction or RECURRING for a recurring transaction.
merchantTransactionId
string
Merchant's unique ID for a new transaction. Length: 1..50
softDescriptor
string
Description of the transaction, which appears on the customer's credit card statement.
cardTransactionType
string
Defines the type of transaction. Values can be:
AUTH_ONLY
AUTH_CAPTURE
CAPTURE
AUTH_REVERSAL
REFUND
transactionId
integer
BlueSnap identifier for the transaction.