{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"altTransaction","type":"basic","slug":"alt-transaction","excerpt":"Contains the information 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 \"3-0\": \"`merchantTransactionId`\",\n \"3-2\": \"Optional\",\n \"3-3\": \"Merchant's unique ID for a new transaction. Between 1-50 characters. Special characters are not recommended.\",\n \"3-1\": \"*string*\",\n \"3-4\": \"A container of card-transaction properties.\\nThis property may appear more than once within the given resource.\",\n \"h-4\": \"Description\",\n \"4-0\": \"`softDescriptor`\",\n \"5-0\": \"`transactionDescription`\",\n \"4-3\": \"Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.\",\n \"4-1\": \"*string*\",\n \"6-0\": \"`currency`\",\n \"5-1\": \"*string*\",\n \"10-0\": \"`transactionFraudInfo`\",\n \"6-1\": \"*string*\",\n \"10-1\": \"*object*\",\n \"5-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 \"4-2\": \"Optional\",\n \"5-2\": \"Optional\\n\\nApplicable to PayPal transactions.\",\n \"6-2\": \"**Required**\",\n \"10-2\": \"Optional\",\n \"6-3\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n \"10-3\": \"See [transactionFraudInfo](doc:transaction-fraud-info).\",\n \"9-0\": \"`transactionMetaData`\",\n \"9-1\": \"*object*\",\n \"9-2\": \"Optional\",\n \"9-3\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"11-0\": \"`paypalTransaction`\",\n \"11-1\": \"*object*\",\n \"11-3\": \"See [paypalTransaction](doc:paypal-transaction).\",\n \"11-2\": \"**Required** for PayPal transactions.\",\n \"0-0\": \"`amount`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"**Required**\",\n \"0-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-0\": \"`payerInfo`\",\n \"1-1\": \"*object*\",\n \"1-2\": \"Optional\",\n \"1-3\": \"See [payerInfo](doc:payer-info).\",\n \"2-0\": \"`vaultedShopperId`\",\n \"2-1\": \"*integer*\",\n \"2-2\": \"Optional\",\n \"2-3\": \"ID of an existing vaulted shopper.\",\n \"13-0\": \"`ecpTransaction`\",\n \"13-1\": \"*object*\",\n \"13-2\": \"**Required** for ACH (ECP) transactions if `pfToken` is not included.\",\n \"13-3\": \"See [ecpTransaction](doc:ecp-transaction).\",\n \"18-0\": \"`authorizedByShopper`\",\n \"18-1\": \"*boolean*\",\n \"18-2\": \"**Required** for ACH (ECP) and SEPA Direct Debit transactions.\",\n \"18-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 \"14-0\": \"`sepaDirectDebitTransaction`\",\n \"14-1\": \"*object*\",\n \"14-2\": \"**Required** for SEPA Direct Debit transactions\",\n \"14-3\": \"See [sepaDirectDebitTransaction](doc:sepadirectdebittransaction).\",\n \"15-0\": \"`localBankTransferTransaction`\",\n \"15-1\": \"*object*\",\n \"15-2\": \"**Required** for Local Bank Transfer (LBT) transactions\",\n \"15-3\": \"See [localBankTransferTransaction](https://developers.bluesnap.com/v8976-JSON/docs/localbanktransfertransaction)\",\n \"8-0\": \"`vendorsInfo`\",\n \"8-1\": \"*object*\",\n \"8-2\": \"**Required** for Marketplace vendors.\",\n \"8-3\": \"See [vendorsInfo](/v8976-JSON/docs/vendorsinfo).\",\n \"16-0\": \"`idealTransaction`\",\n \"16-1\": \"*object*\",\n \"16-2\": \"**Required** for iDEAL transactions\",\n \"16-3\": \"See [idealTransaction](doc:idealtransaction).\",\n \"12-0\": \"`pfToken`\",\n \"12-1\": \"*string*\",\n \"12-2\": \"**Required** for ACH (ECP) transactions if you're using the [Secured Payment Collector](doc:secured-payment-collector).\",\n \"12-3\": \"[Secured Payment Collector](doc:secured-payment-collector) token.\",\n \"17-0\": \"`sofortTransaction`\",\n \"17-1\": \"*object*\",\n \"17-2\": \"**Required** for Sofort transactions\",\n \"17-3\": \"See [sofortTransaction](doc:soforttransaction).\",\n \"7-0\": \"`taxReference`\",\n \"7-1\": \"*string*\",\n \"7-2\": \"Optional\",\n \"7-3\": \"Unique ID for the tax quote. Refer to the [Taxes guide](https://developers.bluesnap.com/v8976-Basics/docs/taxes) for further details.\"\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 \"3-0\": \"`merchantTransactionId`\",\n \"3-1\": \"*string*\",\n \"h-3\": \"Description\",\n \"3-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nSee Transaction Types\",\n \"14-0\": \"`transactionId`\",\n \"14-1\": \"*string*\",\n \"14-3\": \"BlueSnap identifier for the transaction.\",\n \"h-4\": \"Description\",\n \"3-2\": \"Merchant's unique ID for a new transaction.\",\n \"14-2\": \"BlueSnap identifier for the transaction.\",\n \"15-0\": \"`paypalTransaction`\",\n \"15-2\": \"See [paypalTransaction](doc:paypal-transaction).\\nRelevant only for PayPal transactions.\",\n \"15-3\": \"Container of card-holder-info properties.\",\n \"15-1\": \"*object*\",\n \"0-0\": \"`amount`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"Amount to be charged in the transaction, including decimal points.\",\n \"2-0\": \"`vaultedShopperId`\",\n \"2-1\": \"*integer*\",\n \"2-2\": \"ID of an existing vaulted shopper.\",\n \"1-0\": \"`payerInfo`\",\n \"1-1\": \"*object*\",\n \"1-2\": \"See [payerInfo](doc:payer-info).\",\n \"4-0\": \"`processingInfo`\",\n \"4-1\": \"*object*\",\n \"4-2\": \"See [processingInfo](doc:processing-info).\",\n \"5-0\": \"`softDescriptor`\",\n \"5-1\": \"*string*\",\n \"5-2\": \"Description of the transaction, which appears on the customer's credit card statement.\",\n \"6-0\": \"`currency`\",\n \"6-1\": \"*string*\",\n \"6-2\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n \"11-0\": \"`transactionMetaData`\",\n \"11-1\": \"*object*\",\n \"11-2\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"12-2\": \"See [fraudResultInfo](doc:fraud-result-info).\",\n \"12-1\": \"*object*\",\n \"12-0\": \"`fraudResultInfo`\",\n \"20-0\": \"`refunds`\",\n \"20-2\": \"See [refunds](doc:refunds).\",\n \"20-1\": \"*object*\",\n \"16-0\": \"`ecpTransaction`\",\n \"16-1\": \"*object*\",\n \"16-2\": \"See [ecpTransaction](doc:ecp-transaction).\",\n \"17-0\": \"`sepaDirectDebitTransaction`\",\n \"17-1\": \"*object*\",\n \"17-2\": \"See [sepaDirectDebitTransaction](doc:sepadirectdebittransaction).\",\n \"13-0\": \"`subscriptionId`\",\n \"13-1\": \"*integer*\",\n \"13-2\": \"BlueSnap identifier for the subscription.\",\n \"9-0\": \"`transactionApprovalDate`\",\n \"10-0\": \"`transactionApprovalTime`\",\n \"9-2\": \"The date the transaction was approved.\",\n \"10-2\": \"The time the transaction was approved. This is in Pacific time.\",\n \"9-1\": \"*string*\",\n \"10-1\": \"*string*\",\n \"8-0\": \"`vendorsInfo`\",\n \"8-1\": \"*object*\",\n \"8-2\": \"See [vendorsInfo](/v8976-JSON/docs/vendorsinfo).\",\n \"18-0\": \"`idealTransaction`\",\n \"18-1\": \"*object*\",\n \"18-2\": \"See [idealTransaction](doc:idealtransaction).\",\n \"19-0\": \"`sofortTransaction`\",\n \"19-1\": \"*object*\",\n \"19-2\": \"See [sofortTransaction](doc:soforttransaction).\",\n \"7-0\": \"`taxReference`\",\n \"7-1\": \"*string*\",\n \"7-2\": \"Unique ID for the tax quote. Refer to the [Taxes guide](https://developers.bluesnap.com/v8976-Basics/docs/taxes) for further details.\"\n },\n \"cols\": 3,\n \"rows\": 21\n}\n[/block]","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"628531cd1258c8003f6dd268","createdAt":"2020-03-24T21:42:56.561Z","user":"5beb1b96bc2003003ecd645e","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON Objects","slug":"resources","order":16,"from_sync":false,"reference":false,"_id":"628531cd1258c8003f6dd1ca","version":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.42 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628531cd1258c8003f6dd1bf","628531cd1258c8003f6dd1c0","628531cd1258c8003f6dd1c1","628531cd1258c8003f6dd1c2","628531cd1258c8003f6dd1c3","628531cd1258c8003f6dd1c4","628531cd1258c8003f6dd1c5","628531cd1258c8003f6dd1c6","628531cd1258c8003f6dd1c7","628531cd1258c8003f6dd1c8","628531cd1258c8003f6dd1c9","628531cd1258c8003f6dd1ca","628531cd1258c8003f6dd1cb","628531cd1258c8003f6dd1cc","628531cd1258c8003f6dd1cd","628531cd1258c8003f6dd1ce","628531cd1258c8003f6dd1cf","628531cd1258c8003f6dd1d0","628531cd1258c8003f6dd1d1","628531cd1258c8003f6dd1d2"],"_id":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"622783372cd60c003782d77e","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}altTransaction
Contains the information required to process a transaction with an alternative payment method
Property Name
Type
Required
Description
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.
vaultedShopperId
integer
Optional
ID of an existing vaulted shopper.
merchantTransactionId
string
Optional
Merchant's unique ID for a new transaction. Between 1-50 characters. Special characters are not recommended.
softDescriptor
string
Optional
Description of the transaction, which appears on the shopper's credit card statement. Maximum 20 characters.
transactionDescription
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.
taxReference
string
Optional
Unique ID for the tax quote. Refer to the Taxes guide for further details.
pfToken
string
Required for ACH (ECP) transactions if you're using the Secured Payment Collector.
Secured Payment Collector token.
ecpTransaction
object
Required for ACH (ECP) transactions if pfToken is not included.
See ecpTransaction.
sepaDirectDebitTransaction
object
Required for SEPA Direct Debit transactions
localBankTransferTransaction
object
Required for Local Bank Transfer (LBT) transactions
authorizedByShopper
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.
Property Name
Type
Description
amount
decimal
Amount to be charged in the transaction, including decimal points.
vaultedShopperId
integer
ID of an existing vaulted shopper.
merchantTransactionId
string
Merchant's unique ID for a new transaction.
softDescriptor
string
Description of the transaction, which appears on the customer's credit card statement.
transactionApprovalDate
string
The date the transaction was approved.
transactionApprovalTime
string
The time the transaction was approved. This is in Pacific time.
subscriptionId
integer
BlueSnap identifier for the subscription.
transactionId
string
BlueSnap identifier for the transaction.
