📘
Please reach out to BlueSnap Merchant Support to enable this payment method.

The Create Pre-Authorized Debit Transaction request performs a transaction (purchase) using the Pre-Authorized Direct Debit payment method. Note that the shopper's account is not immediately debited - it takes about 3 business days for the shopper's bank to approve the charge and for their account to be debited. For more information about this payment method, see the Pre-Authorized Direct Debit guide.

👍
Prerequisite: Enable the Pre-Authorized Direct Debit payment method in your account
In the Merchant Portal, go to Checkout Page > Payment Methods and select Show in the menu next to the Pre-Authorized Direct Debit payment method. Click Submit to save your changes.

Request Content

Send an altTransaction object with the following:

Property	Type	Required
`acssDirectDebitTransaction`	object	required (see acssDirectDebitTransaction )
`amount`	decimal	required
`authorizedByShopper`	boolean	required, value must be true
`currency`	string	required
`merchantTransactionId`	string	optional
`payerInfo`	object	required if `vaultedShopperId` is not sent (see payerInfo)
`pfToken`	string	optional
`productDescription`	string	optional
`softDescriptor`	string	optional
`taxReference`	string	optional
`transactionFraudInfo`	object	optional (see transactionFraudInfo)
`transactionMetaData`	object	optional (see transactionMetaData)
`vaultedShopperId`	integer	required if `payerInfo` is not sent
`vendorsInfo`	object	optional (see vendorsInfo)

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:


`fraudResultInfo`	(see fraudResultInfo)
`processingInfo`	(see processingInfo)
`transactionId`
`vaultedShopperId`

Examples

Request Examples

📘
Note
The agreementId in the examples below should be replaced with the agreementId you obtain through the Create Debit Agreement mandate API request.

curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountNumber": "9990000001",
    "accountType": "PERSONAL",
    "agreementId": 87
},
    "amount": 11,
    "payerInfo": {
    "zip": "12345",
    "firstName": "John",
    "lastName": "Doe",
    "country": "CA"
},
    "currency": "CAD",
    "authorizedByShopper": true
}

curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "publicAccountNumber": "7772",
    "agreementId": 87
},
    "amount": 11,
    "vaultedShopperId": 19610966,
    "currency": "CAD",
    "authorizedByShopper": true
}

curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "becsDirectDebitTransaction": {},
    "amount": 11,
    "currency": "AUD",
    "vaultedShopperId": 19610968,
    "authorizedByShopper": true
}

curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "transactionOrderSource": "MOTO",
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountNumber": "9990000001",
    "accountType": "PERSONAL",
    "agreementId": 87
},
    "amount": 11,
    "payerInfo": {
    "zip": "12345",
    "firstName": "John",
    "lastName": "Doe",
    "country": "CA"
},
    "currency": "CAD",
    "authorizedByShopper": true
}

Response Examples

{
    "transactionId": "38701842",
    "amount": 11,
    "currency": "CAD",
    "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "ca",
    "zip": "12345"
},
    "vaultedShopperId": 19610966,
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountType": "PERSONAL",
    "publicAccountNumber": "9992",
    "agreementId": 87
},
    "processingInfo": {
    "processingStatus": "PENDING",
    "transactionRegion": "CA"
}
}

{
    "transactionId": "38702780",
    "amount": 11,
    "currency": "CAD",
    "vaultedShopperId": 19610966,
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountType": "BUSINESS",
    "publicAccountNumber": "7772",
    "agreementId": 87
},
    "processingInfo": {
    "processingStatus": "PENDING"
}
}

{
    "transactionId": "38702772",
    "amount": 11,
    "currency": "AUD",
    "vaultedShopperId": 19610968,
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountType": "BUSINESS",
    "publicAccountNumber": "7772",
    "agreementId": 87
},
    "processingInfo": {
    "processingStatus": "PENDING"
}
}

{
    "transactionId": "38701842",
    "amount": 11,
    "currency": "CAD",
    "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "ca",
    "zip": "12345"
},
    "vaultedShopperId": 19610966,
    "acssDirectDebitTransaction": {
    "routingNumber": "001004820",
    "accountType": "PERSONAL",
    "publicAccountNumber": "9992",
    "agreementId": 87
},
    "processingInfo": {
    "processingStatus": "PENDING"
}
}

API Explorer