The Create ECP Transaction request performs a transaction (purchase) using the ACH/ECP payment method. For more information about this payment method, see ACH/ECP.
Prerequisite: Enable the ECP payment method in your account
In the Merchant Portal, go to Checkout Page > Payment Methods and select Show in the menu next to the ECP payment method. Click Submit to save your change.
Tip
You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.
Request Content
Send an altTransaction object with the following:
Property | Type | Required |
---|---|---|
merchantTransactionId | string | optional |
softDescriptor | string | optional |
amount | decimal | required |
currency | string | required |
taxReference | string | optional |
vendorsInfo | object | optional (see vendorsInfo) |
payerInfo | object | required if vaultedShopperId is not sent (see payerInfo) |
vaultedShopperId | integer | required if payerInfo is not sent |
pfToken | string | required if using Secured Payment Collector |
ecpTransaction | object | required if pfToken is not sent (see ecpTransaction) |
authorizedByShopper | boolean | required, value must be true |
transactionMetaData | object | optional (see transactionMetaData) |
transactionFraudInfo | object | optional (see transactionFraudInfo) |
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
Property | Notes |
---|---|
transactionId | |
vaultedShopperId | |
processingInfo | (see processingInfo) |
fraudResultInfo | (see fraudResultInfo) |
vendorsInfo | (see vendorsInfo) |
Examples
Request Examples
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 '
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": "4099999992"
},
"amount": "100",
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": "1234567890"
},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"authorizedByShopper": true,
"transactionFraudInfo": {
"fraudSessionId": "1234",
"customerId": "121341",
"customerCreationDate": "2021-08-05"
}
}
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 '
{
"ecpTransaction": {},
"amount": 100,
"vaultedShopperId": 19563598,
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"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 '
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": 4099999992
},
"amount": 100,
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": 1234567890
},
"merchantTransactionId": "unique_001",
"currency": "USD",
"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 '
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": 4099999992
},
"amount": 100,
"vendorsInfo": {
"vendorInfo": [
{"vendorId": "10398030"}
]
},
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": 1234567890
},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"authorizedByShopper": true,
"transactionFraudInfo": {
"fraudSessionId": 1234
}
}
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 '
{
"vaultedShopperId": "19570144",
"ecpTransaction": {
"accountType": "CONSUMER_CHECKING",
"publicAccountNumber": "99992",
"publicRoutingNumber": "75150"
},
"amount": "100",
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": "1234567890"
},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"authorizedByShopper": true,
"transactionFraudInfo": {"fraudSessionId": "1234"}
}
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 '
{
"pfToken": "eba795a8ec2a8e7754afe7a69b0a0869fba0e6daec01e2d81e1ccbb6771c24ab_",
"amount": 100,
"currency": "USD",
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": "1234567890"
},
"softDescriptor": "ABC COMPANY",
"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 '
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": "4099999992"
},
"amount": "115.50",
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": "1234567890"
},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"authorizedByShopper": true,
"taxReference": "048deff0-a285-47e1-bc39-42f79bf0095b",
"transactionFraudInfo": {"fraudSessionId": "1234"}
}
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",
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": "4099999992"
},
"amount": "100",
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": "1234567890"
},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"authorizedByShopper": true,
"transactionFraudInfo": {
"fraudSessionId": "1234",
"customerId": "121341",
"customerCreationDate": "2021-08-05"
}
}
Response Examples
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": 4099999992
},
"amount": 100,
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": 1234567890
},
"vaultedShopperId": 21614935,
"processingInfo": {"processingStatus": "PENDING"},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"transactionId": 38504784,
"fraudResultInfo": {"deviceDataCollector": "Y"}
}
{
"ecpTransaction": {},
"amount": 100,
"vaultedShopperId": 19563598,
"processingInfo": {"processingStatus": "PENDING"},
"softDescriptor": "ABC COMPANY",
"currency": "USD",
"transactionId": 38504786
}
{
"ecpTransaction": {
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING",
"accountNumber": 4099999992
},
"amount": 100,
"payerInfo": {
"zip": "02453",
"firstName": "John",
"lastName": "Doe",
"phone": 1234567890
},
"vaultedShopperId": 21614935,
"merchantTransactionId": "unique_001",
"processingInfo": {"processingStatus": "PENDING"},
"currency": "USD",
"transactionId": 38504788
}
{
"transactionId": "1015593717",
"vendorInfo": {
"vendorId": 10398030,
"commissionPercent": 30
},
"vendorsInfo": {
"vendorInfo": [
{
"vendorId": 10398030,
"commissionPercent": 30
}
]
},
"softDescriptor": "ABC COMPANY",
"amount": 100,
"currency": "USD",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"zip": "02453",
"phone": "1234567890"
},
"vaultedShopperId": 22324287,
"ecpTransaction": {
"accountNumber": "4099999992",
"routingNumber": "011075150",
"accountType": "CONSUMER_CHECKING"
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
{
"transactionId": "38505332",
"softDescriptor": "ABC COMPANY",
"amount": "100",
"currency": "USD",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"zip": "02453",
"phone": "1234567890"
},
"vaultedShopperId": "19570144",
"ecpTransaction": {
"accountType": "CONSUMER_CHECKING",
"publicAccountNumber": "99992",
"publicRoutingNumber": "75150"
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
{
"transactionId": "1066353507",
"softDescriptor": "ABC COMPANY",
"amount": 100,
"currency": "USD",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"zip": "02453",
"phone": "1234567890"
},
"vaultedShopperId": 37729623,
"ecpTransaction": {
"accountType": "CONSUMER_CHECKING",
"publicAccountNumber": "99992",
"publicRoutingNumber": "75150"
},
"processingInfo": {
"processingStatus": "PENDING"
},
"fraudResultInfo": {}
}
API Explorer
To test out a basic API request, click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.