BlueSnap Gateway

Knowledge Center > Billing and Payments > Payment Gateways > Supported Payment Gateways > BlueSnap Gateway

BlueSnap Gateway

BlueSnap provides payment gateway services that provide online credit card payment processing. This gateway is pre-integrated with Zuora for easy configuration and use with ACH and credit card payments.

Note: The ACH payment method verification request has not been implemented because this operation is not supported by BlueSnap.

Supported Payment Operations

The following payment operations are available through BlueSnap:

  • Payment
  • Full Refund
  • Multiple, Partial Refund (Referenced Refund)

BlueSnap's API supports only the first partial refund.  An error will occur if attempting to refund multiple partials.  BlueSnap Support team can be contacted to handle this scenario.

  • Payment Cancel / Auth Reversal (Void)

This operation is available prior to transaction capture.  Once the transaction is captured, then a Refund request can be used.

Supported Payment Methods

BlueSnap supports the following payment methods:

  • Credit Cards (Visa, MasterCard, Discover, American Express, JCB, and Diners Club) 
  • ACH

Payer Name Extraction

While Zuora stores the name of a credit card payment method as a single string, e.g., "John Smith", BlueSnap requires that the first name and last name are sent as two separate fields. To conform to BlueSnap's requirement, Zuora extracts the first name and last name from the single name string. BlueSnap recommends splitting the name by the first space character. 

Configure the BlueSnap Gateway

  1. Navigate to Payments Settings > Setup Payment Gateway
  2. Click Gateway Type field and select BlueSnap, Payment API v2.0.
  3. Click create gateway
  4. Specify the field values.
  5. Click save gateway information.

BlueSnap Configuration Fields

The following are the common configuration fields you must specify for all gateways. See Setting Up Payment Gateways for the general information about setting up a payment gateway and specifying the values for the common fields: 

  • Name: Name of this gateway instance
  • Use Gateway Test Environment
  • Cards Accepted
  • Default Authorization Amount
  • Verify new credit card (optional)
  • Verify updated credit card (optional)

In addition to the common fields, you must provide the following field values that are specific to the BlueSnap gateway. All the fields are required:

  • Username: Username for the BlueSnap API. Follow the steps at BlueSnap Payment API Credentials to create a username for BlueSnap API.
  • Password: Password for the BlueSnap API. Follow the steps at BlueSnap Payment API Credentials to create a password for BlueSnap API.
  • Soft DescriptorYour DBA (doing business as) name as it appeared on your shopper's credit card statement. This field is required by BlueSnap for each payment request. The example format looks like BLS*CompanyName 2125552222.
    • The CompanyName portion of the descriptor supports 20 alphanumeric and special characters: '&', ',', '.', '-', '#'.
    • The phone number supports 0-9 numbers and should contain your customer support phone number.

Last modified


This page has no custom tags.


(not set)