{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"alt-transaction","type":"basic","slug":"alt-transaction","excerpt":"Contains the details required to process a transaction with an alternative payment method","body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"0-0\": \"`merchant-transaction-id`\",\n    \"0-2\": \"Optional\",\n    \"0-3\": \"Merchant's unique ID for a new transaction. Between 1 - 50 characters. Special characters are not recommended.\",\n    \"0-1\": \"*string*\",\n    \"0-4\": \"A container of card-transaction properties.\\nThis property may appear more than once within the given resource.\",\n    \"h-4\": \"Description\",\n    \"1-0\": \"`soft-descriptor`\",\n    \"2-0\": \"`amount`\",\n    \"1-3\": \"Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.\",\n    \"1-1\": \"*string*\",\n    \"3-0\": \"`currency`\",\n    \"2-1\": \"*decimal*\",\n    \"7-0\": \"`vaulted-shopper-id`\",\n    \"3-1\": \"*string*\",\n    \"7-1\": \"*integer*\",\n    \"18-0\": \"`transaction-fraud-info`\",\n    \"2-3\": \"Amount to be charged in the transaction, including decimal points.\\n\\n**Note:** The [maximum limit](https://support.bluesnap.com/docs/sepa-direct-debit#transaction-amount-requirements) for SEPA Direct Debit transactions is 24,999 EUR.\",\n    \"1-2\": \"Optional\",\n    \"2-2\": \"**Required**\",\n    \"3-2\": \"**Required**\",\n    \"7-2\": \"Optional\",\n    \"3-3\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n    \"7-3\": \"ID of an existing vaulted shopper.\\nFor [create-lbt-transaction](https://developers.bluesnap.com/v8976-XML/docs/create-lbt-transaction), either the `payer-info` or the `vaulted-shopper-id` is required.\",\n    \"18-3\": \"Container of [transaction-fraud-info](doc:transaction-fraud-info) properties.\",\n    \"18-2\": \"Optional\",\n    \"18-1\": \"container\",\n    \"6-0\": \"`payer-info`\",\n    \"6-1\": \"container\",\n    \"6-2\": \"Optional\",\n    \"6-3\": \"Container of [payer-info](doc:payer-info) properties.\\nFor [create-lbt-transaction](https://developers.bluesnap.com/v8976-XML/docs/create-lbt-transaction), either the `payer-info` or the `vaulted-shopper-id` is required.\",\n    \"8-0\": \"`paypal-transaction`\",\n    \"8-1\": \"container\",\n    \"8-3\": \"Container of [paypal-transaction](doc:paypal-transaction) properties.\",\n    \"8-2\": \"**Required** for PayPal transactions.\",\n    \"17-0\": \"`transaction-meta-data`\",\n    \"17-1\": \"container\",\n    \"17-2\": \"Optional\",\n    \"17-3\": \"Container of [transaction-meta-data](doc:transaction-meta-data) properties.\",\n    \"16-0\": \"`transaction-description`\",\n    \"16-1\": \"*string*\",\n    \"16-2\": \"Optional\\n\\nApplicable to PayPal transactions.\",\n    \"16-3\": \"**PayPal transactions**\\nBy default, the PayPal page will show the statement descriptor as the description of the product being purchased. If you prefer to show a different description, you can send it in this element. \\n\\nCan be up to 500 characters.\",\n    \"10-0\": \"`ecp-transaction`\",\n    \"10-1\": \"container\",\n    \"10-2\": \"**Required** for ACH (ECP) transactions if `pfToken` is not included.\",\n    \"10-3\": \"Container of [ecp-transaction](doc:ecp-transaction) properties.\",\n    \"15-3\": \"Value must be **true**.\\n\\nPass this parameter to indicate that you have obtained the shopper's permission to debit their account.\\n\\nFor ACH transactions, you must obtain permission from the shopper to debit their account, for example by showing a checkbox with the following wording on your checkout page. *\\\"I authorize this Electronic Check (ACH) transaction and agree to this debit of my account.\\\"*\\n\\nFor SEPA Direct Debit transactions, you must obtain the shopper's acceptance of the [SEPA Direct Debit Mandate](/docs/sepa-direct-debit#section-step-1-collect-a-mandate-acceptance-from-your-shopper).\",\n    \"15-2\": \"**Required** for ACH (ECP) and SEPA Direct Debit transactions.\",\n    \"15-1\": \"*boolean*\",\n    \"15-0\": \"`authorized-by-shopper`\",\n    \"11-0\": \"`sepa-direct-debit-transaction`\",\n    \"11-1\": \"container\",\n    \"11-2\": \"**Required** for SEPA Direct Debit transactions\",\n    \"11-3\": \"Container of [sepa-direct-debit-transaction](doc:sepa-direct-debit-transaction) properties.\",\n    \"12-0\": \"`local-bank-transfer-transaction`\",\n    \"12-1\": \"container\",\n    \"12-2\": \"**Required** for LBT transactions\",\n    \"12-3\": \"Container of [local-bank-transfer-transaction](https://developers.bluesnap.com/v8976-XML/docs/local-bank-transfer-transaction) properties.\",\n    \"5-0\": \"`vendors-info`\",\n    \"5-1\": \"container\",\n    \"5-2\": \"**Required** for Marketplace vendors\",\n    \"5-3\": \"Container of [vendors-info](/v8976-XML/docs/vendors-info) properties.\",\n    \"13-0\": \"`ideal-transaction`\",\n    \"13-1\": \"container\",\n    \"13-2\": \"**Required** for iDEAL transactions\",\n    \"13-3\": \"Container of [ideal-transaction](doc:ideal-transaction) properties.\",\n    \"9-0\": \"`pf-token`\",\n    \"9-1\": \"string\",\n    \"9-2\": \"**Required** for ACH (ECP) transactions if you're using the [Secured Payment Collector](doc:secured-payment-collector).\",\n    \"9-3\": \"[Secured Payment Collector](doc:secured-payment-collector) token.\",\n    \"14-0\": \"`sofort-transaction`\",\n    \"14-1\": \"container\",\n    \"14-2\": \"**Required** for Sofort transactions\",\n    \"14-3\": \"Container of [sofort-transaction](doc:sofort-transaction) properties.\",\n    \"4-3\": \"Unique ID for the tax quote. Refer to the [Taxes guide](https://developers.bluesnap.com/v8976-Basics/docs/taxes) for further details.\",\n    \"4-0\": \"`tax-reference`\",\n    \"4-1\": \"*string*\",\n    \"4-2\": \"Optional\"\n  },\n  \"cols\": 4,\n  \"rows\": 19\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\": \"`merchant-transaction-id`\",\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\": \"`transaction-id`\",\n    \"2-1\": \"*string*\",\n    \"2-3\": \"BlueSnap identifier for the transaction.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"Merchant's unique ID for a new transaction. Between 1 - 50 characters.\",\n    \"2-2\": \"BlueSnap identifier for the transaction.\",\n    \"3-0\": \"`soft-descriptor`\",\n    \"4-0\": \"`amount`\",\n    \"3-3\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n    \"3-1\": \"*string*\",\n    \"5-0\": \"`currency`\",\n    \"4-1\": \"*decimal*\",\n    \"11-0\": \"`vaulted-shopper-id`\",\n    \"5-1\": \"*string*\",\n    \"11-1\": \"*integer*\",\n    \"12-0\": \"`paypal-transaction`\",\n    \"18-0\": \"`transaction-meta-data`\",\n    \"4-3\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"3-2\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n    \"4-2\": \"Amount to be charged in the transaction, including decimal points.\",\n    \"5-2\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n    \"11-2\": \"ID of an existing vaulted shopper.\",\n    \"12-2\": \"Container of [paypal-transaction](doc:paypal-transaction) properties. \\nRelevant only for PayPal transactions.\",\n    \"12-3\": \"Container of card-holder-info properties.\",\n    \"5-3\": \"Currency of the amount to be charged.\",\n    \"11-3\": \"ID of an existing vaulted shopper.\",\n    \"18-3\": \"Container of transaction-meta-data properties.\",\n    \"18-2\": \"Container of [transaction-meta-data](doc:transaction-meta-data) properties.\",\n    \"12-1\": \"container\",\n    \"18-1\": \"container\",\n    \"19-0\": \"`processing-info`\",\n    \"19-1\": \"container\",\n    \"19-3\": \"A container of processing-info properties.\",\n    \"19-2\": \"Container of [processing-info](doc:processing-info) properties.\",\n    \"10-0\": \"`payer-info`\",\n    \"10-1\": \"container\",\n    \"10-2\": \"Container of [payer-info](doc:payer-info) properties.\",\n    \"20-2\": \"Container of [fraud-result-info](doc:fraud-result-info) properties.\",\n    \"20-0\": \"`fraud-result-info`\",\n    \"20-1\": \"container\",\n    \"21-2\": \"Container of [refunds](doc:refunds) properties.\",\n    \"21-1\": \"container\",\n    \"21-0\": \"`refunds`\",\n    \"13-2\": \"Container of [ecp-transaction](doc:ecp-transaction) properties.\",\n    \"13-1\": \"container\",\n    \"13-0\": \"`ecp-transaction`\",\n    \"14-0\": \"`sepa-direct-debit-transaction`\",\n    \"14-1\": \"container\",\n    \"14-2\": \"Container of [sepa-direct-debit-transaction](doc:sepa-direct-debit-transaction) properties.\",\n    \"1-0\": \"`subscription-id`\",\n    \"1-1\": \"*integer*\",\n    \"1-2\": \"BlueSnap identifier for the subscription.\",\n    \"15-0\": \"`local-bank-transfer-transaction`\",\n    \"15-1\": \"container\",\n    \"15-2\": \"Container of [local-bank-transfer-transaction](https://developers.bluesnap.com/v8976-XML/docs/local-bank-transfer-transaction) properties.\",\n    \"8-0\": \"`transaction-approval-date`\",\n    \"9-0\": \"`transaction-approval-time`\",\n    \"8-2\": \"The date the transaction was approved.\",\n    \"9-2\": \"The time the transaction was approved.  This is in Pacific time.\",\n    \"8-1\": \"*string*\",\n    \"9-1\": \"*string*\",\n    \"7-0\": \"`vendors-info`\",\n    \"7-1\": \"container\",\n    \"7-2\": \"Container of [vendors-info](/v8976-XML/docs/vendors-info) properties.\",\n    \"16-0\": \"`ideal-transaction`\",\n    \"16-1\": \"container\",\n    \"16-2\": \"Container of [ideal-transaction](doc:ideal-transaction) properties.\",\n    \"17-0\": \"`sofort-transaction`\",\n    \"17-1\": \"container\",\n    \"17-2\": \"Container of [sofort-transaction](doc:sofort-transaction) properties.\",\n    \"6-0\": \"`tax-reference`\",\n    \"6-2\": \"Unique ID for the tax quote. Refer to the [Taxes guide](https://developers.bluesnap.com/v8976-Basics/docs/taxes) for further details.\",\n    \"6-1\": \"*string*\"\n  },\n  \"cols\": 3,\n  \"rows\": 22\n}\n[/block]","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"60fed269718a45001c25b491","createdAt":"2020-03-24T20:25:11.305Z","user":"5beb1b96bc2003003ecd645e","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Resources","slug":"resources","order":16,"from_sync":false,"reference":false,"_id":"60fed269718a45001c25b3ec","version":"60fed269718a45001c25b4a0","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.39 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["60fed269718a45001c25b3e0","60fed269718a45001c25b3e1","60fed269718a45001c25b3e2","60fed269718a45001c25b3e3","60fed269718a45001c25b3e4","60fed269718a45001c25b3e5","60fed269718a45001c25b3e6","60fed269718a45001c25b3e7","60fed269718a45001c25b3e8","60fed269718a45001c25b3e9","60fed269718a45001c25b3ea","60fed269718a45001c25b3eb","60fed269718a45001c25b3ec","60fed269718a45001c25b3ed","60fed269718a45001c25b3ee","60fed269718a45001c25b3ef","60fed269718a45001c25b3f0","60fed269718a45001c25b3f1","60fed269718a45001c25b3f2","60fed269718a45001c25b3f3"],"_id":"60fed269718a45001c25b4a0","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60a664e29be3b00016c6d151","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}

alt-transaction

Contains the details required to process a transaction with an alternative payment method

Request

Property Name
Type
Required
Description

merchant-transaction-id

string

Optional

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

soft-descriptor

string

Optional

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

amount

decimal

Required

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

Note: The maximum limit for SEPA Direct Debit transactions is 24,999 EUR.

currency

string

Required

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

tax-reference

string

Optional

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

vendors-info

container

Required for Marketplace vendors

Container of vendors-info properties.

payer-info

container

Optional

Container of payer-info properties.
For create-lbt-transaction, either the payer-info or the vaulted-shopper-id is required.

vaulted-shopper-id

integer

Optional

ID of an existing vaulted shopper.
For create-lbt-transaction, either the payer-info or the vaulted-shopper-id is required.

paypal-transaction

container

Required for PayPal transactions.

Container of paypal-transaction properties.

pf-token

string

Required for ACH (ECP) transactions if you're using the Secured Payment Collector.

ecp-transaction

container

Required for ACH (ECP) transactions if pfToken is not included.

Container of ecp-transaction properties.

sepa-direct-debit-transaction

container

Required for SEPA Direct Debit transactions

Container of sepa-direct-debit-transaction properties.

local-bank-transfer-transaction

container

Required for LBT transactions

Container of local-bank-transfer-transaction properties.

ideal-transaction

container

Required for iDEAL transactions

Container of ideal-transaction properties.

sofort-transaction

container

Required for Sofort transactions

Container of sofort-transaction properties.

authorized-by-shopper

boolean

Required for ACH (ECP) and SEPA Direct Debit transactions.

Value must be true.

Pass this parameter to indicate that you have obtained the shopper's permission to debit their account.

For ACH transactions, you must obtain permission from the shopper to debit their account, for example by showing a checkbox with the following wording on your checkout page. "I authorize this Electronic Check (ACH) transaction and agree to this debit of my account."

For SEPA Direct Debit transactions, you must obtain the shopper's acceptance of the SEPA Direct Debit Mandate.

transaction-description

string

Optional

Applicable to PayPal transactions.

PayPal transactions
By default, the PayPal page will show the statement descriptor as the description of the product being purchased. If you prefer to show a different description, you can send it in this element.

Can be up to 500 characters.

transaction-meta-data

container

Optional

Container of transaction-meta-data properties.

transaction-fraud-info

container

Optional

Container of transaction-fraud-info properties.

Response

Property Name
Type
Description

merchant-transaction-id

string

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

subscription-id

integer

BlueSnap identifier for the subscription.

transaction-id

string

BlueSnap identifier for the transaction.

soft-descriptor

string

Description of the transaction, which appears on the customer'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.

tax-reference

string

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

vendors-info

container

Container of vendors-info 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.

payer-info

container

Container of payer-info properties.

vaulted-shopper-id

integer

ID of an existing vaulted shopper.

paypal-transaction

container

Container of paypal-transaction properties.
Relevant only for PayPal transactions.

ecp-transaction

container

Container of ecp-transaction properties.

sepa-direct-debit-transaction

container

Container of sepa-direct-debit-transaction properties.

local-bank-transfer-transaction

container

Container of local-bank-transfer-transaction properties.

ideal-transaction

container

Container of ideal-transaction properties.

sofort-transaction

container

Container of sofort-transaction 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.