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.

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 AUTHONLY 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 AUTHONLY 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.
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.
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 informationDefault value is false.
vaultedShopperIdintegerRequired in AUTHONLY and AUTH_CAPTURE _if using a vaulted shopper

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
ID of an existing vaulted shopper.
vendorsInfoobjectRelevant for Marketplaces
Optional
Refer to the vendorsInfo details.
walletobjectRequired in AUTHONLY and AUTH_CAPTURE _if using Apple Pay or Google Pay

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
Refer to the wallet details.
walletIdlongRequired in AUTHONLY and AUTH_CAPTURE _if using Visa Checkout

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND
ID 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.
softDescriptorstringDescription of the transaction, which appears on the customer's credit card statement.
storeCardbooleanIndicates 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.