cardTransaction

Contains the information required to process a credit card transaction

Request

Property NameTypeRequiredDescription
amountdecimalRequired in AUTH_ONLY, AUTH_CAPTURE, and REFUND

Optional in CAPTURE

Not relevant for AUTH_REVERSAL
Amount to be charged in the transaction, including decimal points. This should be the sum of the subtotal, tax (if applicable), and surcharge amount (if surcharging is enabled).The maximum value can be up to 9999999999.99, but please work with Merchant Support or your Implementation Specialist if you plan to send transactions over $50,000.
cardHolderInfoobjectRequired in AUTH_ONLY and AUTH_CAPTURE for LATAM local processing

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Refer to the cardHolderInfo details.
cardTransactionTypestringRequiredDefines the type of transaction.

Possible values:
AUTH_ONLY
AUTH_CAPTURE
CAPTURE
AUTH_REVERSAL
REFUND
creditCardobjectRequired 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.
Refer to the creditCard details.
currencystringRequired in AUTH_ONLY and AUTH_CAPTURE

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Currency code (ISO 4217) of the amount to be charged. Refer to Currency codes.
descriptorPhoneNumberstringOptionalMerchant's support phone number that will appear on the shopper's credit card statement. Maximum 20 characters.
level3DataobjectOptionalRefer to the level3Data details.
merchantTransactionIdstringOptional

Required in AUTH_REVERSAL and REFUND if not using transactionId
Merchant's unique ID for a new transaction. 1–50 characters. Special characters are not recommended.
networkTransactionInfocontainerOptionalSee networkTransactionInfo
pfTokenstringRequired in AUTH_ONLY and AUTH_CAPTURE_if using Hosted Payment Fields or Secured Payment Collector

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Hosted Payment Fields or Secured Payment Collector token.
productDescriptionstringOptionalThe product description that will appear in IPNs, emails, and the Control Panel.Maximum 200 characters
shippingContactInfoobjectOptional in AUTH_CAPTURE and AUTH_ONLY

Not relevant for CAPTURE, AUTH_REVERSAL, or REFUND.
Details for the shipping contact. Refer to shippingContactInfo.
softDescriptorstringOptionalDescription of the transaction that appears on the shopper's credit card statement.This property has the following restrictions:
  • ASCII characters only
  • Maximum 20 characters
storeCardbooleanOptionalIndicates whether or not to store the shopper's payment data.

Possible values:
true (default)
false


Note: Not applicable when performing an Auth Only with an amount equal to zero.

Refer to the Card on File Guide.
surchargeInfoobjectRequired if surcharging is enabledIf surcharging is enabled, you must provide this with all auth and/or capture requests even if the transaction was not eligible for surcharge.

Refer to the surchargeInfo details.
taxReferencestringOptionalUnique ID for the tax quote. Refer to the Taxes guide for further details.
threeDSecureobjectOptionalRefer to the threeDSecure details.
transactionFraudInfoobjectOptionalRefer to the transactionFraudInfo details.
transactionIdstringRequired in CAPTURE

Required in AUTH_REVERSAL and REFUND if not using merchantTransactionId

Not relevant for AUTH_ONLY and AUTH_CAPTURE
BlueSnap identifier for the transaction.
transactionInitiatorstringOptionalIdentifies who initiated the order. Options are:
MERCHANT (for MIT)
SHOPPER (for CIT)

Refer to the 3-D Secure Guide.
transactionMetaDataobjectOptionalRefer to the transactionMetaData details.
transactionOrderSourcestringOptionalIdentifies the order type. The only option is MOTO  (Mail Order Telephone Order). Any other option is ignored.
updateShopperWithCardholderInfostringOptionalIf this property is included with the value true, the following details will be updated based on the data in the cardHolderInfo object:
  • Shopper details
  • Invoice contact information
  • Credit card information
  • Default value is false.
vaultedShopperIdintegerRequired 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.
vendorsInfoobjectOptional

Relevant for Marketplaces
Refer to the vendorsInfo details.
walletobjectRequired in AUTH_ONLY and AUTH_CAPTURE if using Apple Pay or Google Pay

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Refer to the wallet details.
walletIdlongOptionalID of the wallet, obtained via the Create Wallet request.

Response

Property NameTypeDescription
amountdecimalAmount to be charged in the transaction, including decimal points.
cardHolderInfoobjectSee cardHolderInfo.
cardTransactionTypestringDefines the type of transaction. Values can be:
AUTH_ONLY
AUTH_CAPTURE
CAPTURE
AUTH_REVERSAL
REFUND
chargebacksobjectSee chargebacks.
creditCardobjectSee creditCard.
currencystringCurrency code (ISO 4217) of the amount to be charged. See Currency codes.
descriptorPhoneNumberstringMerchant's support phone number that will appear on the shopper's credit card statement.
fraudResultInfoobjectSee fraudResultInfo.
level3DataobjectSee level3Data.
merchantTransactionIdstringMerchant's unique ID for a new transaction.
networkTransactionInfocontainerSee networkTransactionInfo
openToCapturedecimalRemaining authorization amount available for capture.
originalTransactionIdstringPresent in the Retrieve Card Transaction response if the transaction was retrieved by the refund transaction ID. The value is the transaction ID of the original transaction.
processingInfoobjectSee processingInfo.
refundsobjectSee refunds.
shippingContactInfoobjectSee shippingContactInfo.
softDescriptorstringDescription of the transaction, which appears on the customer's credit card statement.
storeCardboolean

Indicates if the shopper provided permissions to store their payment data.

Possible values:

true (default)
false

Note: Not applicable when performing an Auth Only with an amount equal to zero.

See Card on File Guide.

taxReferencestringUnique ID for the tax quote. Refer to the Taxes guide for further details.
threeDSecureobjectSee threeDSecure.
transactionApprovalDatestringThe date the transaction was approved.
transactionApprovalTimestringThe time the transaction was approved. This is in Pacific time.
transactionIdstringBlueSnap identifier for the transaction.
transactionMetaDataobjectSee transactionMetaData.
vaultedShopperIdintegerID of an existing vaulted shopper.
vendorsInfoobjectSee vendorsInfo.
walletobjectSee wallet.