{"_id":"59df6a573b756800107b207d","category":{"_id":"59df6a523b756800107b202b","version":"59df6a523b756800107b201e","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":12,"slug":"resources","title":"Resources"},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"_id":"59df6a523b756800107b201e","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T13:12:50.128Z","releaseDate":"2017-10-12T13:12:50.128Z","categories":["59df6a523b756800107b201f","59df6a523b756800107b2020","59df6a523b756800107b2021","59df6a523b756800107b2022","59df6a523b756800107b2023","59df6a523b756800107b2024","59df6a523b756800107b2025","59df6a523b756800107b2026","59df6a523b756800107b2027","59df6a523b756800107b2028","59df6a523b756800107b2029","59df6a523b756800107b202a","59df6a523b756800107b202b","59df6a523b756800107b202c","59df6a523b756800107b202d","59df6a523b756800107b202e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","version_clean":"8976.0.0-XML","version":"8976-XML"},"__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":6,"body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"0-0\": \"`card-transaction-type`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n    \"2-0\": \"`merchant-transaction-id`\",\n    \"2-2\": \"Optional\",\n    \"2-3\": \"Merchant's unique ID for a new transaction. Between 1 - 50 characters.\",\n    \"2-1\": \"*string*\",\n    \"1-0\": \"`transaction-id`\",\n    \"1-1\": \"*string*\",\n    \"1-3\": \"BlueSnap identifier for the transaction.\",\n    \"2-4\": \"A container of card-transaction properties.\\nThis property may appear more than once within the given resource.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"**Required**\",\n    \"1-2\": \"**Required** in CAPTURE,  AUTH_REVERSAL, and REFUND\\n\\nNot relevant for AUTH_ONLY and AUTH_CAPTURE\",\n    \"3-0\": \"`recurring-transaction`\",\n    \"3-1\": \"*string*\",\n    \"4-0\": \"`soft-descriptor`\",\n    \"6-0\": \"`amount`\",\n    \"4-3\": \"Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.\",\n    \"4-1\": \"*string*\",\n    \"7-0\": \"`currency`\",\n    \"6-1\": \"*decimal*\",\n    \"8-0\": \"`vaulted-shopper-id`\",\n    \"7-1\": \"*string*\",\n    \"8-1\": \"*integer*\",\n    \"9-0\": \"`card-holder-info`\",\n    \"11-0\": \"`transaction-fraud-info`\",\n    \"12-0\": \"`credit-card`\",\n    \"14-0\": \"`transaction-meta-data`\",\n    \"6-3\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"3-3\": \"Enter **ECOMMERCE**. For recurring transactions, see the [Subscriptions Guide](doc:subscription-management).\",\n    \"3-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"4-2\": \"Optional\",\n    \"6-2\": \"**Required** in AUTH_ONLY, AUTH_CAPTURE, and REFUND\\n\\nNot relevant for CAPTURE and AUTH_REVERSAL\",\n    \"7-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"8-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using a vaulted shopper*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"9-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if sending card data (including encrypted data) or `pf-token` and shopper is new*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"9-3\": \"Container of [card-holder-info](doc:card-holder-info) properties.\",\n    \"7-3\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/v1.0/docs/currency-codes).\",\n    \"8-3\": \"ID of an existing vaulted shopper.\",\n    \"11-3\": \"Container of [transaction-fraud-info](doc:transaction-fraud-info) properties.\",\n    \"12-3\": \"Container of [credit-card](doc:credit-card) properties.\",\n    \"14-3\": \"Container of [transaction-meta-data](doc:transaction-meta-data) properties.\",\n    \"11-2\": \"Optional\",\n    \"12-2\": \"**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*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"14-2\": \"Optional\",\n    \"9-1\": \"*container*\",\n    \"11-1\": \"*container*\",\n    \"12-1\": \"*container*\",\n    \"14-1\": \"*container*\",\n    \"13-0\": \"`pf-token`\",\n    \"13-1\": \"*string*\",\n    \"13-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    \"13-3\": \"Hosted Payment Fields token\",\n    \"10-0\": \"`wallet-id`\",\n    \"10-1\": \"*long*\",\n    \"10-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using MasterPass or Visa Checkout*\\n\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"10-3\": \"ID of the wallet, obtained via the [Create Wallet](/v4.0/docs/create-wallet) request.\",\n    \"15-0\": \"`wallet`\",\n    \"15-1\": \"*container*\",\n    \"15-2\": \"**Required** in AUTH_ONLY and AUTH_CAPTURE *if using Apple Pay*\\n\\nNot relevant for CAPTURE, AUTH_REVERSAL, and REFUND\",\n    \"15-3\": \"See [wallet](doc:wallet).\",\n    \"5-0\": \"`descriptor-phone-number`\",\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  },\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    \"0-0\": \"`card-transaction-type`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nSee Transaction Types\",\n    \"2-0\": \"`merchant-transaction-id`\",\n    \"2-2\": \"Merchant's unique ID for a new transaction. Between 1 - 50 characters.\",\n    \"2-3\": \"Merchant's unique ID for a new transaction. Length: 1..50\",\n    \"2-1\": \"*string*\",\n    \"1-0\": \"`transaction-id`\",\n    \"1-1\": \"*string*\",\n    \"1-3\": \"BlueSnap identifier for the transaction.\",\n    \"2-4\": \"A container of card-transaction properties.\\nThis property may appear more than once within the given resource.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nREFUND\",\n    \"1-2\": \"BlueSnap identifier for the transaction.\",\n    \"3-0\": \"`recurring-transaction`\",\n    \"3-1\": \"*string*\",\n    \"4-0\": \"`soft-descriptor`\",\n    \"6-0\": \"`amount`\",\n    \"4-3\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n    \"4-1\": \"*string*\",\n    \"7-0\": \"`currency`\",\n    \"6-1\": \"*decimal*\",\n    \"8-0\": \"`vaulted-shopper-id`\",\n    \"7-1\": \"*string*\",\n    \"8-1\": \"*integer*\",\n    \"9-0\": \"`card-holder-info`\",\n    \"10-0\": \"`credit-card`\",\n    \"11-0\": \"`transaction-meta-data`\",\n    \"6-3\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"3-3\": \"Enter ECOMMERCE for a one-time transaction or RECURRING for a recurring transaction.\",\n    \"3-2\": \"Enter ECOMMERCE for a one-time transaction or RECURRING for a recurring transaction.\",\n    \"4-2\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n    \"6-2\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"7-2\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/v1.0/docs/currency-codes).\",\n    \"8-2\": \"ID of an existing vaulted shopper.\",\n    \"9-2\": \"Container of [card-holder-info](doc:card-holder-info) properties.\",\n    \"9-3\": \"Container of card-holder-info properties.\",\n    \"7-3\": \"Currency of the amount to be charged.\",\n    \"8-3\": \"ID of an existing vaulted shopper.\",\n    \"10-3\": \"Container of credit-card properties.\",\n    \"11-3\": \"Container of transaction-meta-data properties.\",\n    \"10-2\": \"Container of [credit-card](doc:credit-card) properties.\",\n    \"11-2\": \"Container of [transaction-meta-data](doc:transaction-meta-data) properties.\",\n    \"9-1\": \"container\",\n    \"10-1\": \"*container*\",\n    \"11-1\": \"*container*\",\n    \"12-0\": \"`processing-info`\",\n    \"12-1\": \"*container*\",\n    \"12-3\": \"A container of processing-info properties.\",\n    \"12-2\": \"Container of [processing-info](doc:processing-info) properties.\",\n    \"13-2\": \"Container of [fraud-result-info](doc:fraud-result-info) properties.\",\n    \"13-0\": \"`fraud-result-info`\",\n    \"13-1\": \"*container*\",\n    \"14-0\": \"`refunds`\",\n    \"14-1\": \"*container*\",\n    \"14-2\": \"Container of [refunds](doc:refunds) properties.\",\n    \"15-0\": \"`wallet`\",\n    \"15-1\": \"*container*\",\n    \"15-2\": \"Container of Apple Pay [wallet](doc:wallet) properties.\",\n    \"5-1\": \"*string*\",\n    \"5-0\": \"`descriptor-phone-number`\",\n    \"5-2\": \"Merchant's support phone number that will appear on the shopper's credit card statement.\"\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":"card-transaction"}

card-transaction

Contains the information required to process a credit card transaction

Request

Property Name
Type
Required
Description

card-transaction-type

string

Required

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

transaction-id

string

Required in CAPTURE, AUTH_REVERSAL, and REFUND

Not relevant for AUTH_ONLY and AUTH_CAPTURE

BlueSnap identifier for the transaction.

merchant-transaction-id

string

Optional

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

recurring-transaction

string

Required in AUTH_ONLY and AUTH_CAPTURE

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

Enter ECOMMERCE. For recurring transactions, see the Subscriptions Guide.

soft-descriptor

string

Optional

Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.

descriptor-phone-number

string

Optional

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

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.

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.

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.

card-holder-info

container

Required in AUTH_ONLY and AUTH_CAPTURE if sending card data (including encrypted data) or pf-token and shopper is new

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

Container of card-holder-info properties.

wallet-id

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.

transaction-fraud-info

container

Optional

Container of transaction-fraud-info properties.

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.

pf-token

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

transaction-meta-data

container

Optional

Container of transaction-meta-data properties.

wallet

container

Required in AUTH_ONLY and AUTH_CAPTURE if using Apple Pay

Not relevant for CAPTURE, AUTH_REVERSAL, and REFUND

See wallet.

Response

Property Name
Type
Description

card-transaction-type

string

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

transaction-id

string

BlueSnap identifier for the transaction.

merchant-transaction-id

string

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

recurring-transaction

string

Enter ECOMMERCE for a one-time transaction or RECURRING for a recurring transaction.

soft-descriptor

string

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

descriptor-phone-number

string

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

amount

decimal

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

currency

string

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

vaulted-shopper-id

integer

ID of an existing vaulted shopper.

card-holder-info

container

Container of card-holder-info properties.

credit-card

container

Container of credit-card properties.

transaction-meta-data

container

Container of transaction-meta-data properties.

processing-info

container

Container of processing-info properties.

fraud-result-info

container

Container of fraud-result-info properties.

refunds

container

Container of refunds properties.

wallet

container

Container of Apple Pay wallet properties.