Developer FAQs

Does the emulator support tokenization?

Yes. Pass the BluePay transaction ID (token) into the x_trans_id field. This works identically to passing back a previous transaction ID in the BluePay Gateway with our other standard APIs.

What are the response codes returned by the emulator?

Response Code

  • 1 Approved
  • 2 Declined
  • 3 Error

Response Reason Code

  • 1 Approved
  • 2 Declined
  • 4 Hold or Pick Up Card
  • 5 Amount Error
  • 6 Card Account Not Valid
  • 7 Invalid Expiration
  • 8 Expired
  • 12 Missing Auth Code
  • 13 Invalid Account
  • 15 Invalid Transaction ID
  • 27 AVS Mismatch
  • 28 Card Type Not Accepted
  • 32 Invalid Reason Code
  • 33 Missing x_login
Does the emulator support recurring billing (rebill)?

No.'s Automated Recurring Billing (ARB) interface is not emulated on BluePay's emulator.

Where can a merchant verify that BluePay is PCI compliant?
What is the maximum number of transactions that the Transaction Search can return?


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, click the preferences icon (exclamation mark icon) next to the user to be change
  2. Click the "Edit" button.
  3. Check the "Create New" checkbox.
  4. Enter "PrintCSVHeader" in the first box.
  5. Enter "1" in the second box.
  6. Click "Save."
  7. Have the user log out and log back in.
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 our partner Payvision.

What currencies can be processed using Payvision?
  • EUR Euro
  • USD U.S. Dollar
  • GBP British Pound
  • HKD Hong Kong Dollar
  • SGD Singapore Dollar
  • JPY Japanese Yen
  • CAD Canadian Dollar
  • AUD Australian Dollar
  • CHF Swiss Franc
  • DKK Danish Krone
  • SEK Swedish Krona
  • NOK Norwegian Krone
  • ILS Israeli Shekel
  • MYR Malaysian Ringgit
  • NZD New Zealand Dollar
  • TRY New Turkish Lira
  • TWD Taiwan Dollar
  • THB Thailand Baht
  • CZK Czech Koruna
  • HUF Hungarian Forint
  • SKK Slovakian Koruna
  • EEK Estonian Kroon
  • BGN Bulgarian Leva
  • PLN Polish Zloty
  • ISK Iceland Krona
  • INR Indian Rupee
  • LVL Latvian Lat
  • KRW South-Korean Won
  • ZAR South-African Rand
  • RON Romanian Leu New
  • HRK Croatian Kuna
  • LTL Lithuanian Litas
Where can I see a sample of an online application?
What is the email address of merchant services?
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

Are the AVS and CVV filters case sensitive?


With which banks can ACH transactions be processed directly?

Bank of America, Chase, Central Bank of Boone County, Comerica, Capital One, PNC, US Bank, and Wells Fargo

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

The encrypted card number is kept for three (3) 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?


Are there any images that a merchant can display on its website when using the BluePay gateway?

They can display the BluePay merchant seal that can be downloaded from here.

Once a merchant completes the ControlScan PCI testing, they can download an image which can be displayed on their web site.

How can a merchant get help with the DDS/Trustwave PCI scan?

Email issues to Trustwave with MID, DBA, and merchant's email address, or give them a call at 800-363-1621.

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?

Add a second TEST processor to the demo account and change the Payment Type to ACH. 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.

How can a merchant find out about a service interruption or scheduled maintenance on the BluePay Gateway?

If subscribed, a merchant will receive status notification emails or texts from BluePay. Visit to subscribe to notifications and view the operational status of the BluePay Gateway and BlueView Merchant Portal.  Or, follow our @BluePay_Status Twitter feed for instant status changes.

Can’t find what you’re
looking for? We can help.

Contact 800-350-2684 for Integration Support.

  • Microsoft Gold Partner Badge
  • 2018 American Business Awards Gold Stevie® Winner Badge for Best Payment and Electronic Commerce Solution
  • 2018 CNP Awards Customer Choice Winner Badge for Best E-Commerce Platform/Gateway
  • Best in Biz Awards 2018 Silver Winner Badge for Business Development Department of the Year
  • TSG Gateway Awards 2019 BluePay
BluePay Processing, LLC is a registered ISO of Wells Fargo Bank, N.A., Concord, CA, 94524 U.S.A.
BluePay Canada ULC, is a Registered ISO/MSP of Peoples Trust Company, Vancouver, Canada.