Skip to main content

Chargebee Activation and Configuration (Beta)

December 6, 2024

Description

An overview, requirements and steps for setting up and processing payments through Bank of America

What's in this article?

Chargebee is business software and an e-commerce platform that provides businesses with the ability to bill and invoice customers through subscription management and recurring billing. They have options for connection via an API or hosted payment pages.

Chargebee's integration with the Bank of America Gateway leverages the bank's Microform and Card Not Present Integration Toolkit integration methods to help meet the Self-Assessment Questionnaire A (SAQ A) Payment Card Industry (PCI) compliance level.

Requirements

A Merchant Services account with Bank of America, a live website, and a Chargebee 2.0 account are required to activate the solution.

Configure payment settings

Set up your payment settings in Chargebee. You can set them up for a live site or a test site first.

IMPORTANT!
If you choose to do testing in the test environment, you will need to configure the payment settings a second time, when you are ready to switch to the live environment.

To generate security keys and configure payment settings

  1. Generate security keys for the live environment or test environment.
  2. Configure Chargebee payment settings
To configure Chargebee settings
  1. Log in to your Chargebee admin dashboard in the top right corner of www.chargebee.com.
  2. Choose TEST Site or Go Live depending on whether you are configuring settings for the testing environment or the live environment.Test Site and Go Live buttons
  3. From the left navigation menu, select Settings.
  4. Under Settings, select Configure Chargebee.
  5. Under Billing, select Payment gateways.Settings and Billing menus
  6. Under Payment gateways, select Bank of America.Bank of America listing under Payment gateways section
  7. From the left navigation menu, under the Bank of America logo, click Manage
    IMPORTANT: Do not click the Manage link under Payment methods.Manage button under Bank of America logo
  8. Copy and paste your Merchant ID, and Shared Secret and Key generated above, to Chargebee.

    Merchant ID, Shared Secret Key and Key fields

  9. In the top right corner, click Connect.

    • If the connection was successful, you will see a Successfully updated the Bank of America credentials message in the bottom right corner of the screen.

    • If the connection was unsuccessful, contact us for assistance.

  10. Configure additional settings by clicking Manage in the top right corner of the page under Payment methods. 
    IMPORTANT: Do not click the Manage link under the Bank of America logo.

    Manage link under Payment methods

    SettingDescription
    Card verificationValidates a customer's card with a test authorization for a micro amount, which will be refunded immediately. Cards cannot be added if this test authorization fails.
    NOTE: This setting is automatically enabled and mandatory for recurring payments so they are processed faster and achieve better approval rates.
    Allow prepaid cardsEnables payments processed with prepaid cards.
    Always retain card information in Bank of AmericaUseful in cases when multiple payment gateways are configured, this setting retains card information for the Bank of America Gateway.

    Additional settings options

  11. Click Save to save the changes.


To run a test transaction

  1. Run a test transaction using test credit card numbers. If you require assistance, contact us.
  2. If you tested in the test environment, after successful testing, repeat the steps above to configure payment settings for the production (live) environment. 

To archive the Bank of America payment gateway

  1. In the Chargebee admin dashboard, below the Bank of America logo, select Archive.

Archive selection under Bank of America logo

    • Payments for new customers will not be processed through this payment gateway.
    • Payments for existing subscriptions configured to the Bank of America gateway will continue to be processed through this payment gateway. 

Resources

Did you find this article helpful?