Skip to main content

Overview of BlueSnap gateway integration

Zuora

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, payment cancel/void
Support 3D Secure 2.0 Yes
Support Delayed Capture No
Support Level 2 and Level 3 card data No
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

https://ws.bluesnap.com/services/2

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

https://ws.bluesnap.com/services/2/report/TransactionDetail

https://ws.bluesnap.com/services/2/report/DirectDebit

Support Payment Method Updater Yes
BlueSnap production endpoint used for PMU service https://ws.bluesnap.com/services/2/account-updater

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.

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

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 stored credential profiles

BlueSnap gateway includes support for the Stored Credential Transactions framework. For details about the supported payment methods, 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.0SOAP API, or the following REST API:

Limitations

  • BlueSnap gateway integration does not support non-referenced refunds.
  • The ACH payment method verification request has not been implemented because this operation is not supported by BlueSnap.

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.