Introduction

Integrating to the BluePay Gateway to accept secure online payments is a simple and intuitive experience. Discover your options below, choose what's best for your business and we'll support you along the way.  

After you figure out what you need, we'll work with you through testing, complete with a dedicated sandbox account that allows you to do dry runs with your API payment processing system.

Request a Sandbox Account

After you fill out the form below, the BluePay Gateway team will send an email with your login credentials within 24 business hours.

When you're ready to get paid, we'll help you flip the switch. This last step assumes that you've got code in place and have finished testing. You'll also need an active merchant account.

Complete the form here

Payment Modules

The BluePay Gateway payment modules integrate into popular shopping carts, ERP and CRM systems, billing software, POS software, nonprofit software and more.

Once you have downloaded the module for your software, you’re ready to begin testing.

Android SDK

The BluePay Android SDK can be used to process authorizations, sales, generate tokens as $0 authorizations, and process card-present transactions. The SDK includes swipe support for the IDTech UniMag II and Shuttle.

Download the BluePay Android SDK

iOS SDK

The BluePay iOS SDK can be used to process authorizations, sales, generate tokens as $0 authorizations, process card-present transactions. The SDK includes swipe support for the IDTech UniMag II and Shuttle.

Download the BluePay iOS SDK

Magento 2 Extension

The Magento 2 Payment Module integrates the shopping cart software with BluePay's payment environment.

Magento 2 Payment Module Download Information

Microsoft Dynamics GP

The Microsoft Dynamics GP Payment Module integrates your accounting and back-end systems with BluePay's payment environment.

See instructional videos available in the left navigation.

To learn more, please contact integrationsupport@bluepay.com

Payment.js

Payment.js allows merchants working with various First Data APIs and gateways to tokenize payment credentials for later transactions without collecting, processing, or otherwise being able to view those payment credentials in their untokenized form, thus lowering their PCI compliance requirements. 

Visit Payment.js documentation

QuickBooks Desktop

QuickBooks Desktop Plugin Features

The QuickBooks Desktop plugin works right out of the box, but it also comes with a range of advanced features, including the ability to:

  • Run credit, debit, and ACH transactions as Payments, Sales Receipts, and Credit Memos
  • Store payment methods for repeat customers via tokenization
  • Set up, modify, and delete rebillings
  • Import batches of tokens, as well as rebillings
  • Process batches of invoices at one time
  • Import transactions processed outside of QuickBooks Desktop
  • Use with Desktop versions of Pro, Premier, and Enterprise editions 2012 or later
  • Reduce card processing fees and optimize reporting using Level 2/Level 3 processing

Setting Up the QuickBooks Desktop Plugin

To use this dedicated plugin, you'll need both an active BluePay account and QuickBooks Desktop - Pro, Premier, or Enterprise editions 2012 or later. Contact us at bluepaygateway@cardconnect.com to receive the plugin.

During the setup process, you’ll need to provide your Account ID (which is different from your BluePay username) and Secret Key (which is different from your BluePay password).

If you’re not sure where to find your Account ID or Secret Key:

  • Log directly into your BluePay account and click on Administration > Accounts > List
  • Next, click on the View icon, which will reveal your Account ID and Secret Key
  • You’ll need to copy these credentials and paste them into the relevant fields within the setup wizard

Once you're done installing the payment module, you’re ready to configure and begin using the QuickBooks Desktop plugin.

See instructional videos available in the left navigation. 

QuickBooks Online

QuickBooks Online Plugin Features

The QuickBooks Online plugin works right out of the box, but it also comes with a range of advanced features, including the ability to:

  • Run credit, debit, and ACH transactions as Payments, Sales Receipts, and Credit Memos
  • Store payment methods for repeat customers via tokenization
  • Set up, modify, and delete rebillings
  • Import transactions processed outside of QuickBooks Online
  • Email invoices directly to customers that can be paid via a secure hosted payment form
  • Reduce card processing fees and optimize reporting using Level 2/Level 3 processing

Setting Up the QuickBooks Online Plugin

To use this dedicated plugin, you'll need both an active BluePay account and QuickBooks Online. Contact us at bluepaygateway@cardconnect.com to receive the plugin.

During the setup process, you’ll need to provide your Account ID (which is different from your BluePay username) and Secret Key (which is different from your BluePay password).

If you’re not sure where to find your Account ID or Secret Key:

  • Log directly into your BluePay account and click on Administration > Accounts > List
  • Next, click on the View icon, which will reveal your Account ID and Secret Key
  • You’ll need to copy these credentials and paste them into the relevant fields within the setup wizard

See instructional videos available in the left navigation.

SalesForce

BluePay SalesForce Plugin gives you the ability to process credit card and ACH payments directly inside of your SalesForce environment against Accounts, Contacts and Opportunities. The plugin also supports recurring billing and secure storage of payment accounts using tokenization.

See instructional videos available in the left navigation.

Please contact integrationsupport@bluepay.com for more information. 

WordPress

These third-party WordPress plugins are compatible with the BluePay Gateway. 

Plugins available via CDI. 

JD Edwards

Integrating JD Edwards ERP systems with BluePay’s payment gateway gives you PCI-certified security and customization of your payment experience to meet your specific needs.

Learn More

Oracle

Integration of the Oracle ERP system with BluePay’s payment environment keeps your customers’ data secure and decreases your liability.

Learn More

SAP

Using SAP with BluePay’s payment solution provides efficient and secure credit card processing, allows customers to purchase from you via tablets and smartphones, and lets you decide exactly what functions you need.

Learn More

Embed a Payment Form

The BluePay Gateway can host your payment forms for quick, efficient and secure online transactions, without the worry of PCI compliance. 

  • Submit a request for the BluePay Gateway to host your Payment Form.
  • We'll post the form on our secure server and send you confirmation with the form's URL.
  • Embed that URL in your site or application.
  • Test the form and your processes.
  • Activate your account.
  • Customers visit the form on BluePay's secure server.
  • We collect information and process your payments.
  • You'll receive payment confirmations and other information.

Outlined below are four "ready-to-use" templates for payment forms. Click the links to view the samples or download a spreadsheet of available templates. Additionally, custom templates can be created. 

Sample Payment Form Templates:

After you have chosen the template that you would like to use, create a URL to that template with this tool: URL Generator

API Documentation

Recommended APIs

BluePay Post (bp10emu)

Our primary transaction processing API. Name/value pairs are posted to the gateway which responds with name/value pairs.

Samples: PHP, Perl, Ruby, Java, Python, C#, C++, Visual Basic.net, Classic ASP, Cold Fusion

BluePay Redirect (bp10emu)

The customer fills out a html form served from the merchant’s web server. When they click submit the information they filled in is sent to the redirect interface. It then processes the transaction and redirects the customer’s web browser to a web page on the merchant’s web server.

BluePay Hosted Payment Form (shpf)

Service where a order form can be securely hosted on the BluePay gateway server. Primarily used as a front end for BluePay 2.0 Redirect.

Tool: Hosted Payment Form URL Generator

BluePayJS

Javascript method to tokenize payment information from a merchant's payment form.

BluePay Authorize.net AIM Emulator (a.net)

This interface allows existing Authorize.net integrations to communicate to the BluePay gateway.

Manual CSV Upload

File upload of transactions to be processed using the gateway's web site.

BluePay CSV Upload (bp20bu)

Interface to upload comma delimited files into the gateway for processing.

Sample: PHP

    BluePay CSV Upload Report (bpbureport)

    Interface to check the status of and download results of CSV files uploaded into the gateway for processing.

      BluePay Rebill Administration (bprebadmin)

      This interface is for updating and cancelling rebillings set up in the BluePay Gateway.

      Samples: PHP, Perl, Ruby, Java, Python, C#, C++, Visual Basic.net

        BluePay Customer Token Administration (bp20tokenadmin)

        Interface for creating, updating and reading Customer Token data.

          BluePay Daily Report 2 (bpdailyreport2)

          A new version of the reporting interface for the retrieval of transaction data. 

          Retrieve by transaction date samples: PHP, Perl, Ruby, Java, Python, C#, C++, Visual Basic.net

          Retrieve by settlement date samples: PHP, Perl, Ruby, Java, Python, C#, C++, Visual Basic.net

            BluePay Single Transaction Query (stq)

            Interface that can retrieve information of a single transaction using the transaction ID, merchant defined order_id or other search criteria.

            Samples: PHP, Perl, Ruby, Java, Python, C#, C++, Visual Basic.net

              BluePay Reserve Query (reserveq)

              Interface that can retrieve information on ACH reserve payments using a date range and other fields.

              BluePay Manager CSV Export

              Export of transaction data in Comma Separated Value (CSV) format using the gateway's website.

                Rebill Post

                Post to remote application when a recurring billing transaction is processed.

                Trans Notify Post

                Post to remote application when transactions are processed by the gateway.

                Samples: PHP, Perl, Ruby, Java, Python, C#, Visual Basic.net

                  Mobile EMV App

                  Mobile App for the processing of swipe & EMV chip transactions on Apple iOS and Google Android devices using a ID Tech VP3300 reader.

                    Deprecated APIs

                    BluePay 2.0 Post (bp20post)

                    Name/value pairs are posted to the gateway which returns results as name/value pairs. Same concept as BluePay 1.0 Post but the data is formatted differently.

                    Samples: PHP, Perl, Ruby, Classic ASP

                      BluePay XML Post (asby)

                      XML based interface to the gateway that can be used for basic transaction processing. See BluePay 1.0 Post if advanced features are needed.

                      BluePay Daily Report (bpdailyreport)

                      A reporting interface for the retrieval of transaction data.

                      Sample: Perl

                        Code Samples

                        PHP

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        C#

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Perl

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Ruby 

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Java

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Python

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        C++

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Visual Basic.NET

                        Transactions

                        Get Data

                        Rebill

                        Hosted Payment Forms

                        Status & Support

                        BluePay Gateway Status

                        Get real-time notifications on the BluePay Gateway operational status.

                        status.cardconnect.com

                        Contact Our Integration Team

                        For technical questions related to the BluePay Gateway, please complete the form here or contact us directly at: 

                        bluepayintegration@cardconnect.com 800.350.2684

                        Developer FAQ

                        What is the maximum number of transactions that the Transaction Search can return?

                        20,000.

                        How can a gateway user be set to have the "Include Column Headers" option for CSV export checked by default?

                        1. From the User List page, under Options choose Preferences.
                        2. Click the “Edit” button.
                        3. Change the value of “Print CSV Headrers” from “No” to “Yes”.
                        4. Click the “Save” button.

                        What causes an "Invalid field name" error when the field names are correct in a batch upload file?

                        The file is probably using Unicode encoding. Open the file in Notepad and save file using ANSI encoding.

                        Can the BluePay Gateway process foreign currencies?

                        Yes, using Fiserv’s Global ePricing service.

                        Where can I see a sample of an online application?

                        Why is the CVV result no match when the CVV value is correct but the expiration date is incorrect?

                        The CVV value is not a value stored by the card issuer. It is a value calculated using the card number, expiration date and other information on file with the card issuer. Because the expiration date is used in that calculation, supplying the wrong expiration date causes the calculated value to not match the one on the card. When the values don’t match, a no-match CVV response is returned.

                        What user permissions must be set to give a gateway user view only access?

                        account.view, scope.account, scope.hier, trans.view

                        With which banks can ACH transactions be processed directly?

                        • American Charter Bank
                        • Bank of America
                        • Capital One
                        • Central Bank
                        • Chase Bank
                        • Comerica Bank
                        • First Republic Bank
                        • Metabank
                        • PNC Bank
                        • Regions Bank
                        • US Bank
                        • Wells Fargo Bank

                        How long is a transaction available for use as a Master ID on a new transaction?

                        The encrypted card number is kept for seven (7) years.

                        What is Rebill Retry and how does it work?

                        If a rebill credit card transaction is declined, the gateway can automatically reattempt the transaction after a configurable amount of time. This option is not available for ACH. IT must enable and configure this option.

                        Why is a test transaction declined?

                        The results of a test transaction are determined by the dollar amount of the transaction without cents. If the dollar amount is odd, an approval is returned. If the dollar amount is even, a decline is returned. This allows testing of both transaction result types.

                        If "Customer Receipt" is checked in the settings, will customer receipt emails be sent when a rebilling executes?

                        Yes. 

                        Does BluePay issue SSL certificates?

                        BluePay does not issue SSL certificates. The merchant would need to contact a certificate authority to get an SSL certificate. Some of the larger companies issuing SSL certificates are GoDaddy, Thawte, Comodo and Verisign. GoDaddy is usually the least expensive option.

                        When using a USB card swipe with the Virtual Terminal, is the address information required?

                        Address information is not required when the track data is submitted in the "Swipe Result" field. Using "Swipe Result" causes a transaction to be treated as a card present transaction.

                        What does RRNO stand for?

                        RRNO is an acronym for Reference Routing Number. It is more commonly known as the transaction ID.

                        How can a demo account be configured to process test ACH transactions?

                        Send an email to bluepaygateway@cardconnect.com with your demo account ID requesting that ACH processing capability be added. The number sequence 123456780 can be used as the routing number on test ACH transactions.

                        Which shows on a BluePay Manager receipt — the Account Name or the DBA Name?

                        The Account Name is displayed on the receipt.

                        Instructional Videos

                        Processing Transactions

                        Fraud Management

                        QuickBooks Desktop Plugin

                        QuickBooks Online Plugin

                        Salesforce Plugin

                        Microsoft Dynamics GP Plugin