card-transaction

Contains the information required to process a credit card transaction

Request

Property Name

Type

Required

Description

amount

decimal

Required 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.

card-holder-info

container

Required in AUTH_ONLY and AUTH_CAPTURE for LATAM local processing.

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

Container of card-holder-info properties.

card-transaction-type

string

Required

Defines the type of transaction. Values can be: AUTH_ONLY, AUTH_CAPTURE, CAPTURE, AUTH_REVERSAL, or REFUND

credit-card

container

Required in AUTH_ONLY and AUTH_CAPTURE if sending card data or if vaulted-shopper-id is sent and the vaulted shopper has more than one credit card.

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

Container of credit-card properties.

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.

descriptor-phone-number

string

Optional

Merchant's support phone number that will appear on the shopper's credit card statement. Maximum 20 characters.

level-3-data

container

Optional

Container of level-3-data properties.

merchant-transaction-id

string

Optional

Required in AUTH_REVERSAL and REFUND if not using transaction-id

Merchant's unique ID for a new transaction. Between 1 - 50 characters. Special characters are not recommended.

network-transaction-info

container

Optional

See network-transaction-info

pf-token

string

Required 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.

product-description

string

Optional

The product description that will appear in IPNs, emails, and the Control Panel.

soft-descriptor

string

Optional

Description of the transaction that appears on the shopper's credit card statement.

This property has the following restrictions:

  • ASCII characters only
  • Maximum 20 characters

store-card

boolean

Optional

Indicates 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.

tax-reference

string

Optional

Unique ID for the tax quote. Refer to the Taxes guide for further details.

three-d-secure

container

Optional

Container of three-d-secure properties.

transaction-fraud-info

container

Optional

Container of transaction-fraud-info properties.

transaction-id

string

Requiredin CAPTURE
Required in AUTH_REVERSAL and REFUND if not using merchant-transaction-id

Not relevant for AUTH_ONLY and AUTH_CAPTURE

BlueSnap identifier for the transaction.

transaction-initiator

string

Optional

Identifies who initiated the order.

Options are: MERCHANT (for MIT) or SHOPPER (for CIT)

transaction-meta-data

container

Optional

Container of transaction-meta-data properties.

transaction-order-source

string

Optional

Identifies the order type. The only option is MOTO (Mail Order Telephone Order). Any other option is ignored.

vaulted-shopper-id

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.

vendors-info

container

Relevant for Marketplaces

Optional

Container of vendors-info properties.

wallet

container

Required in AUTH_ONLY and AUTH_CAPTURE if using Apple Pay or Google Pay™

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

See wallet.

wallet-id

long

Required in AUTH_ONLY 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.

update-shopper-with-card-holder-info

string

Optional

If this property is included with the value true, the following details will be updated based on the data in the card-holder-info object:

  • Shopper details
  • Invoice contact information
  • Credit card information
  • Default value is false.

Response

Property Name

Type

Description

amount

decimal

Amount to be charged in the transaction, including decimal points.

card-holder-info

container

Container of card-holder-info properties.

card-transaction-type

string

Defines the type of transaction. Values can be: AUTH_ONLY, AUTH_CAPTURE, CAPTURE, AUTH_REVERSAL, or REFUND

chargebacks

container

Container of chargebacks properties.

credit-card

container

Container of credit-card properties.

currency

string

Currency code (ISO 4217) of the amount to be charged. See Currency codes.

descriptor-phone-number

string

Merchant's support phone number that will appear on the shopper's credit card statement.

fraud-result-info

container

Container of fraud-result-info properties.

level-3-data

container

Container of level-3-data properties.

merchant-transaction-id

string

Merchant's unique ID for a new transaction. Between 1 - 50 characters.

network-transaction-info

container

See network-transaction-info

open-to-capture

decimal

Remaining authorization amount available for capture.

original-transaction-id

string

Present 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.

processing-info

container

Container of processing-info properties.

refunds

container

Container of refunds properties.

soft-descriptor

string

Description of the transaction, which appears on the customer's credit card statement.

store-card

boolean

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.

tax-reference

string

Unique ID for the tax quote. Refer to the Taxes guide for further details.

three-d-secure

container

Container of three-d-secure properties.

transaction-approval-date

string

The date the transaction was approved.

transaction-approval-time

string

The time the transaction was approved. This is in Pacific time.

transaction-id

string

BlueSnap identifier for the transaction.

transaction-meta-data

container

Container of transaction-meta-data properties.

vaulted-shopper-id

integer

ID of an existing vaulted shopper.

vendors-info

container

Container of vendors-info properties.

wallet

container

Container of Apple Pay or Google Pay wallet properties.