Beanstream®

Table of Contents Show

BeanStream® Processing Features

Beanstream Internet Commerce Inc.® provides payment, risk management and authentication solutions to some of North America’s leading companies and institutions. Beanstream® has forged relationships with major financial institutions, built a network of over 700 partners and 22,000 merchants, and provides white label solutions for First Data Canada, TD Bank, and Sage Payroll. Customers include both online merchants and brick and mortar merchants, government, financial institutions and higher education. Beanstream is situated in Victoria, British Columbia, Canada.

AbleCommerce supports all the standard features of the BeanStream payment gateway.

  • Authorize

  • Authorize Capture (Sale)

  • Capture

  • Partial and Remaining Capture

  • Refund

  • Partial Refund

BeanStream is a Canadian provider.  All amounts will be in CAD unless configured differently within your merchant account.

 

DEV NOTE: BeanStream will not work under medium trust. You will need to use full trust for this gateway to function.

Post-order Processing

All AbleCommerce payment gateway integrations offer full support for post-order processing.  This means that after an order is placed, you can authorize, capture, refund, and void transactions from the AbleCommerce order administration area.

Some post-order processing features, such as refunds, may require that you enable credit card storage from the Configure > Security > System Settings page.

Installing the Beanstream® Gateway

  1. Login to your AbleCommerce installation.

  2. Using the menu, go to the Plugins page.

  3. Use the Filter Plugins option and select the type "Payment".

    NOTE: Beanstream plugin will be available in the list as shown in the screenshot below.

  4. Click the green Install button in the far right column.

  5. When the confirmation popup appears, click the green Yes, install it button.

  6. Upon completion, click the orange Configure button.


    NOTE: Version shown may be different depending on the release of AbleCommerce you are using.

Configure Beanstream® Payment Gateway

Before you begin, make sure that you have the following information which will be provided by Beanstream:

  • Merchant Login ID = Your Beanstream Merchant ID

  • Merchant Password = Your gateway password

  • User Name = Your gateway username

If you have trouble finding this information, skip to the next section on this page for help.

  1. From Configure > Payment > Gateways page, all of the installed payment gateways will be shown.

    NOTE: Visit the Plugins page to install a new payment gateway. There is no limit to the number of gateways that can be install and/or in use.

  2. To configure a new gateway, click the blue plus (+) button to continue. If the gateway is already configured, click the Edit button to make changes.

  3. You will now be on the Add BeanStream configuration page as shown below:

  4. In the field named Merchant Login, enter the number known as the Merchant ID.  This should be displayed in the upper-right corner of your merchant account.

  5. In the field named Merchant Password, enter your payment gateway password.  This is not the same password you use to login to your merchant account.  This information is under the Order Settings section of the Administration > Account Settings page.

  6. In the next field, enter your User Name.  Also found within the Order Settings section of the Administration > Account Settings page.

  7. Choose the type of Authorization Mode.

    • Authorize: to request authorization without capturing funds at the time of purchase. You can capture authorized transactions through the order admin interface.

    • Authorize & Capture: to capture funds immediately at the time of purchase. You should not use this feature unless you are able to ship goods the same day of the sale.

  8. Choose the Gateway Mode.

    • Live Mode - used for processing live transactions with a production merchant account.

    • Test Mode - used for testing transactions with a development merchant account.

  9. Debug Mode: When debug mode is enabled, all messages sent to and received from BeanStream are logged. This should only be enabled at the direction of qualified support personnel.

    Default Log File Location: ..\App_Data\Logs\[gatewayname].log

  10. The Test URL and Live URL fields are used to store the connection link to the gateway.  This information is pre-populated when you configure the gateway and should not be changed unless directed by BeanStream or AbleCommerce personnel.

    NOTE: The BeanStream gateways uses one endpoint URL. To switch between Test and Live, copy the URL to the applicable field and save.

  11. In the bottom section of the page, find the section called Payment Methods.

  12. Click the box next to all credit card payment methods that will use the BeanStream gateway.

  13. At the bottom of the page, click the Save and Close button to finish.

Configuration Settings in your BeanStream account

This section provides information on configuring your BeanStream account to work with the AbleCommerce integrated gateway.

  1. Go to BeanStream's website and login to your merchant account.

  2. From the left navigation bar, expand the administration menu.

  3. Then expand the account settings menu.  Now click on the order settings link.

  4. Scroll down until you see the "Payment Gateway section as shown in the example below:

  5. Within the "Security/Authentication" section, make sure the option to 'Use username/password validation' is selected.

  6. Enter your own unique User Name and Password in the fields provided.  You should use a strong password unlike the sample provided.

  7. Make sure the 'Include hash validation in the Transaction Response Page' option is also selected.  Use Hash algorithm option SHA-1

  8. SAVE your changes.

Testing with BeanStream

Setup a BeanStream test account through http://developer.beanstream.com/

  1. Edit the BeanStream gateway configuration page in AbleCommerce.

  2. Change the Gateway Mode to Test Mode.

  3. At the bottom of the page, click the SAVE button.

  4. Using the credit card numbers listed below, you can test an approval or decline.

  5. Be sure to change the Gateway Mode to Live before processing real credit card transactions.

BeanStream Test Credit Card numbers

Visa Approved: 4123450131003312

Visa Declined: 4003050500040005

MasterCard Approved: 5100000010001004

MasterCard Declined: 5100000020002000

Amex Approved: 371100001000131

Amex Declined: 342400001000180

 

NOTE: There may be additional features within your BeanStream account that have not been tested with AbleCommerce.  If you enable unsupported features, you are doing so at your own risk.