Skip to main content

Overview of BlueSnap gateway integration


Overview of BlueSnap gateway integration

Supported features 

The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.

Supported payment methods Credit Card/Gift Card/Prepaid Card, ACH, SEPA
Supported payment operations payment, referenced refund
Support 3D Secure 2.0 Yes
Support Delayed Capture No
Support Level 2 and Level 3 card data Yes
Support stored credential transactions Yes
Support Gateway Options fields Yes
Gateway provider’s API version BlueSnap payment XML version 1.0
BlueSnap production endpoint used for Zuora gateway integration service

Support Gateway Reconciliation Yes
BlueSnap production endpoint used for Gateway Reconciliation service

Support Payment Method Updater Yes (Visa, MasterCard)
BlueSnap production endpoint used for PMU service
Support idempotency for retrying a transaction request Yes. See Electronic payment processing for details.

Supported payment methods

BlueSnap supports the following payment methods:

  • ACH
  • SEPA
  • Credit Card/Gift Card/Prepaid Card, including:
    • Visa
    • Mastercard
    • Discover
    • American Express
    • JCB (in select countries)
    • Diners Club 
    • Elo
    • Hipercard
    • Argencard
    • Cabal
    • Cencosud
    • Nativa
    • Tarjeta Naranja
    • Tarjeta Shopping
    • Cartão MercadoLibre

For more information about setting up payment methods in Zuora, see Define and set up payment methods.

Supported payment operations

The following payment operations are available through BlueSnap:

  • Payment

    The Soft Descriptor field is also supported if you create a SEPA payment.

  • Full Refund

    For SEPA refunds, it takes about 7 days for a SEPA payment to reach a stage when it can be refunded.

  • 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.

Support for 3D Secure 2.0

See Enable 3DS2 for BlueSnap gateway integration and Zuora’s implementation of 3D Secure 2.0 for more information.

Support for Level 2 and Level 3 card data processing

The BlueSnap gateway integration supports processing Level 2 and Level 3 credit card data. For more information, see the following articles:

Support for stored credential profiles

BlueSnap gateway includes support for the Stored Credential Transactions framework and the sharing NTI feature. For details, see Support for stored credential transactions overview.

Support for Gateway Reconciliation

The BlueSnap gateway integration supports the following Gateway Reconciliation event types for ACH transactions:

  • Payment Settlement
  • Payment Rejection
  • Payment Chargeback
  • Refund Settlement

For refund transactions, the BlueSnap gateway integration only supports the settlement event. The refunds in the Rejected status are ignored. 

The reconciliation job retrieves the reconciliation report from the BlueSnap gateway daily at 3:00 pm PST. It usually takes 3-10 days for these endpoints to be updated with the status of the transaction.

For more information about enabling and configuring the Gateway Reconciliation service, see the following articles:

Support for Payment Method Updater

To set up the BlueSnap Payment Method Updater service in Zuora, see Configure BlueSnap Payment Method Updater for more information.

Supported Gateway Options fields

If the support for Level 2 or Level 3 data processing is enabled, you can submit additional information to the BlueSnap gateway using gateway options. Currently, BlueSnap gateway integration supports the following gateway option fields:

  • InvoiceNum
  • TaxSum
  • TransactionOrderSource: To indicate that the current transaction is a MOTO payment transaction, specify MOTO for this field. If you want to configure a gateway instance, through which all transactions will be processed as MOTO transactions, see Transaction Order Source configuration field.

You can use these fields in Payment Pages 2.0 or the following REST API operations:

All Gateway Options fields are string fields.


BlueSnap gateway integration does not support non-referenced refunds.

Additional information

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. 

For ACH payment methods, Zuora splits the string specified in the account holder name field into two parts at the first space from the left. The first part will be passed to BlueSnap and populated in the firstName field. The second part will be passed and populated in the lastName field. The limit is 25 characters for both fields according to BlueSnap PayerInfo documentation. For example, if Axxxxxxx Bxxxxxxx Cxxxxxx Dxxx Exx is specified, Axxxxxxx is firstName and Bxxxxxxx Cxxxxxx Dxxx Exx is lastName.

To add an ACH payment method to a Business Checking type of account, the payerInfo > companyName field must be included in the request to the gateway. You can pass in the company name through the following approaches. The value passed in will be mapped to the payerInfo > companyName field, in addition to the firsName and lastName fields.