Skip to main content

Overview of SlimPay payment gateway integration

Zuora

Overview of SlimPay payment 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 SEPA, Credit Card Reference Transactions (Tokenization)
Supported payment operations Validate Payment Method, Payment, Void Payment, Referenced refund
Support 3D Secure 2.0 No
Support Delayed Capture Yes
Support Level 2 and Level 3 card data No
Support stored credential transactions No
Support Gateway Options fields No
SlimPay payment gateways endpoint used for Zuora gateway integration service

https://api.slimpay.net

https://api.slimpay.net/oauth/token

https://api.slimpay.net/mandate

https://api.slimpay.net/direct-debits

https://api.slimpay.net/credit-transfers

https://api.slimpay.net/card-aliases

https://api.slimpay.net/payments

Support Gateway Reconciliation Yes
SlimPay production endpoint used for Gateway Reconciliation service slimprod.slimpay.net:6321
Support Payment Method Updater No

Supported payment methods

The SlimPay payment gateway integration supports the following payment methods:

  • SEPA
  • Credit Card Reference Transactions (Tokenization)

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

Support for mandate creation

Among the supported payment methods, Zuora supports mandate creation for SEPA payment methods. Zuora will generate and pass the mandate to the gateway.

Credit Card Reference Transactions

Zuora supports SlimPay tokens. Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.

Zuora’s SlimPay integration supports Card Aliases via the Credit Card Reference Transaction payment method. This feature allows you to leverage the SlimPay’s card-alias API to create credit card payments against subscriptions.

The following table shows the field mapping between Zuora and SlimPay for Credit Card Reference Transaction payment methods.

Zuora REST API or SOAP API SlimPay API
PaymentMethod.TokenId Card-Alias: id
PaymentMethod.SecondTokenId Card-Alias: reference

When creating a payment method from the Zuora UI or API, you need to populate the token generated from SlimPay only in the TokenId field on the payment method. Zuora automatically populates the value for the SecondTokenId field according to the value of the Slimpay API Card-Alias: reference field.

To enable the support for Credit Card Reference Transactions, submit a request at Zuora Global Support

Supported currencies

  • EUR (SEPA)
  • GBP (Direct Debit UK)

Support for Delayed Capture

The Delayed Capture feature allows you to authorize the availability of funds for a transaction but delay the capture of funds until a later time. Zuora's SlimPay gateway supports Delayed Capture for Credit Card Reference payment methods, which involves the use of the following API operations:

Zuora also supports capturing authorizations that were generated externally to call the Zuora's Create authorization API operation. 

Support for Gateway Reconciliation

The SlimPay gateway integration supports the following Gateway Reconciliation event types:

  • Settlement
  • Rejection

SlimPay supports gateway reconciliation failed payment events, and payment reversals. Gateway Reconciliation job status can be viewed beginning at 02:00 UTC. Any direct debit payment that does not have any direct debit issue associated and has been executed on its execution date, the payment is considered settled. The system will mark these transactions as settled and any rejected payments as rejected and create external refunds for them. 

See Gateway Reconciliation and Set up and configure a SlimPay payment gateway instance for more information.

Limitation

SlimPay gateway integration does not support non-referenced refunds.