Integrate X-Cart and Bluesnap
Trexle connects X-Cart to Bluesnap and 100+ other payment gateways using a single plugin for one time annual fee
Bluesnap and X-Cart Integration Guide
How to get your BlueSnap API credentials
You will need a BlueSnap account in order to obtain API credentials.
Follow these steps to get your API credentials:
- Go to Settings > API Settings in the top menu of the BlueSnap Merchant Console.
- Define your API password by entering it in the Password and Verify your password fields.
Password rules
- Minimum of 7 characters (no maximum character limit)
- Allowed characters: a-z A-Z 0-9 _~!@#&$%^*()|’-
- One capital letter and one number
- Start with a letter
- Should not contain consecutive characters
Important: Remember your API Password for later
- In the New IP Address field, enter the IP address to be used for API calls. You can add up to fifteen IP addresses or a subnet.
- Click Request API credentials. The credentials are generated and your new API Username is displayed.
API credentials in the HTTP Basic Authentication header
You’ll include your BlueSnap API username and password in the Basic Authentication header when you make calls to our API.
Take the credentials you just obtained from Bluesnap and navigate to Trexle dashboard, click Payments Gateways and select Bluesnap from the drop down menu as shown below.
Fill into your Bluesnap credential and click Add Gateway. Click the Activate button next to Bluesnap, and it will give you a success message and the button will turn into green. You should see something like below.
How to install Trexle extension to X-Cart store
1. Download Trexle X-Cart extension from Trexle Github repository
2. Log in to your X-Cart admin panel and click on the ‘Modules’ link in the left menu
3. Click on the ‘Upload addon’ button and browse to the location of the Trexle X-Card extension you previously downloaded.
4. After the installation has been successful, you will find Trexle extension in the List of recently installed modules
5. Check the ‘Enable’ checkbox under the extension.
Your Trexle extension has now been installed.
To ensure the integration works seamlessly, create a test product, logout from your admin session and perform a checkout as a regular customer.
Test Credit Card Numbers
The following credit card numbers can be used for testing purposes in the BlueSnap Sandbox environment. The table indicates what the expected result is for each test card, such as a successful charge or a specific error. To test Apple Pay transactions, click here.
Note: If the CVV Code is blank, please input three digits (for Visa, MasterCard, and Discover cards) or four digits (for Amex cards) in the CVV field if required on the checkout form.
Amex
374245455400126
05/2023
Success
Amex
378282246310005
05/2023
Failure
Discover
60115564485789458
12/2023
US
USD
Success
Discover
6011000180331111
12/2023
US
USD
Failure
JCB
3530111333300000
02/2023
Success
JCB
3530111333300000
07/2023
Failure
JCB
3530111333300000
03/2023
JP
JPY
Success
JCB
3530111333300000
07/2023
JP
JPY
Failure
MasterCard
5425233430109903
04/2023
Success
MasterCard
5425233430109903
12/2004
Invalid exp. date
MasterCard
2222420000001113
08/2020
Success
MasterCard
2223000048410010
09/2020
Success
Visa
4263982640269299
02/2023
Success
Visa
4263982640269299
02/2023
837
Success
Visa
4263982640269299
01/2023
837
ARS
EUR
USD
Failure
Visa
4263982640269299
04/2023
738
Success
Visa
4263982640269299
03/2023
738
ARS
EUR
USD
Failure
Visa
4917484589897107
01/2023
ARS
EUR
USD
Failure
Visa1
4001919257537193
09/2019
BR
BRL
Success
Visa1
4007702835532454
10/2020
BR
BRL
Success
ELO1
6362970000457013
8/2019
BR
BRL
Success
Hipercard1
6062826786276634
09/2020
BR
BRL
Success
Argencard1
5011054488597827
12/2019
AR
ARS
Success
Cabal1
6271701225979642
03/2020
AR
ARS
Success
Cencosud1
6034932528973614
06/2020
AR
ARS
Success
Naranja1
5895626746595650
11/2020
AR
ARS
Success
Nativa1
5200533989557118
11/2019
AR
ARS
Success
Tarjeta Shopping1
6034883265619896
09/2020
AR
ARS
Success
1 Only supported for testing LatAm integrations. Your account must first have LatAm processing enabled by contacting [email protected].
Apple Pay test cards
The following cards may be used to test Apple Pay transactions.
Amex
349956959041362
12/2022
1111
Discover
6011000994462780
11/2022
111
MasterCard
5204247750001471
11/2022
111
Visa
4761120010000492
11/2022
533
Note: To test Amex cards for Apple Pay, your device region must be set to United States.
Bluesnap Supported Countries
Bluesnap Supported Payment Processing Actions
✔ Authorize
✔ Capture
✔ Void
✔ Credit
✔ Recurring
✖ Card Store
Key Features
About Trexle
Trexle is a powerful online recurring subscription billing platform that integrate Bluesnap and other +100 payment gateways with X-Cart and other dozen of e-commerce platforms.
About Bluesnap
More than just basic credit card processing, BlueSnap gives you as many ways to accept payments as there are to make sales. Depending on your business model, you decide how you want to reach customers and vendors. BlueSnap supports traditional online checkout as well as invoice payments, phone and email orders through virtual terminal, subscription billing, and marketplace (multi-vendor) business models.
About X-Cart
X-Cart is a renowned open-source e-commerce platform that powers over 35,000 stores in 111 different countries. With its open-source PHP backend, it gives users full control over their installation and is very easy to use, maintain and modify. It comes with a website builder, enabling merchants to customize every element of their online store.