Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Payment Methods

  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration

  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Chargebee Pay
  • Stripe
  • Adyen
  • Braintree
  • Authorize.net
  • PayPal Payment Services
  • GoCardless
  • Razorpay
  • Checkout.com
  • Mollie
  • BlueSnap
  • CyberSource
  • Global Payments
  • QuickBooks Payments
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
  • J.P. Morgan Mobility Payment Solutions
  • Twikey
  • dLocal
  • Bank of America
  • Solidgate
  • Pay.com
  • EBANX
  • BluePay
  • Sage Pay
  • Paymill
  • Bambora (formerly Beanstream)
  • E-xact Direct Integration
  • Orbital (Chase Paymentech)
  • Pin Payments
  • Moneris
  • Elavon
  • Network Merchants Incorporated (NMI)
  • eWay Rapid
  • Ecentric
  • Windcave
  • Metrics Global
  • Nuvei
  • Paystack
  • Articles and FAQ

Level 2/3 Data Support

  • Level 2/3 Data Support

Advanced Routing

  • Advanced Routing

Dunning

  • Dunning
  • Articles and FAQ

Offline Checkout

  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping

  • Transaction Sync and Invoice Mapping

Fraud Management

  • Fraud Management

Error Handling

  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs

  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Articles and FAQ

Others

  • Reach (Merchant of Record)
  • Payment Verification
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  3. Payment Gateways and Configuration
  4. Ecentric
  1. Payments
  3. Payment Gateways and Configuration
  4. Ecentric

Ecentric

This feature is a Private Beta Release. Request access to enable Ecentric via payFURL for your test and live sites.

Introduction

Ecentric Payment Systems is a South African payment gateway that simplifies online payments and provides the infrastructure and security necessary to ensure fast, reliable, and secure transmission of transaction data.

Chargebee integrates Ecentric Payment Systems via payFURL. payFURL is a payment orchestration platform that provides payment-related API services and specializes in payment gateway integrations.

Since this integration is supported through a partner (payFURL), using Ecentric via payFURL will incur an additional charge. Contact your Chargebee Account Manager or Chargebee Support for more information.

Choosing Ecentric Payment Systems

Consider the following factors before choosing Ecentric Payment Systems as a payment solution:

  • Countries: Ecentric is currently available for companies based in South Africa.
  • Payment methods: Ecentric supports almost all major credit and debit cards such as Visa, MasterCard, American Express, Diners Club, and more.
  • Currencies: Ecentric Payment Systems supports the South African Rand (ZAR).

Integration options

You can integrate Ecentric using the following:

Integration MethodDescriptionPCI Requirements
Chargebee Hosted PagesIn this method, customers' card information is collected by Chargebee's checkout and directly passed on to Ecentric.Low (Your PCI compliance requirements are greatly reduced due to usage of Chargebee's checkout.)
Chargebee JSIn this method, you can use Chargebee Components and Hosted Fields to collect the customer's card details.Low
Chargebee JSUsing Permanent Token - a token that represents a customer's card details stored in Ecentric's vault to process payments.

When creating a new token and converting card details to tokens using: Hosted Components: Low Your own Checkout: High

Chargebee JSVia Raw Card details You will collect raw card details via your custom checkout and pass it to Chargebee.js.High
Chargebee APIIn this method, you will have to collect card information and pass it on to Chargebee via API. Chargebee then routes this card information to Ecentric. Since you will be collecting card information directly, you will have to take care of PCI Compliance requirements.High

3D Secure is not supported for this integration.

Configuring Ecentric in your Chargebee site

You can only connect to your Ecentric production environment account in your Chargebee live site. If you don't have the relevant production Environment API URL, contact your Ecentric account manager. This URL is required while configuring Ecentric in Chargebee.

Follow the steps below to configure Ecentric in your Chargebee site:

  1. Log in to the Chargebee app.
  2. Click Settings > Configure Chargebee > Payment Gateways.
  3. Click Add Gateway and select Ecentric Payment System.
    image
  4. In the Merchant ID field, enter the Merchant GUID from your Ecentric account. If you don't have the GUID, contact your Ecentric account manager.
  5. Enter the Environment API URL of your Ecentric account environment (Sandbox, UAT, or Production) that you want to connect to.
  6. Click Connect.
    image

Configuring card settings

Follow the steps below to configure card settings for your Ecentric account in Chargebee:

  1. Click Manage under Cards.
    image
  2. Card verification: A micro amount is deducted from the customer's card for validation. This amount is refunded immediately. Cards that do not pass this validation will not be added.
  3. Always retain card information in Ecentric Payment System when customer updates it: This option determines where updated cards will be vaulted for existing customers when using multiple gateways. Enable to retain cards in Ecentric Payment System, even if smart routing is updated to a new gateway. Disable to gradually migrate customers to the new gateway as they update their cards. Learn more.
  4. Click Save.
    image

This integration supports the use of the Payment Initiator API parameter, which when passed along with the transaction, helps Chargebee distinguish between customer- and merchant-initiated transactions and handle the payment more effectively. Learn more

Frequently asked questions (FAQs)

  1. What if the tokens are vaulted in one merchant ID and the payment processing needs to happen with a different merchant ID under Ecentric?
    You can pass a different merchant ID via the Payment Source APIs (additional_information parameter > Ecentric > merchant_id), which will be used to verify and retrieve non-sensitive payment method details, bypassing the merchant ID set up in the configuration. This is assuming that Ecentric is configured to make it work across the merchant ID.
  2. Why are some of my transactions in sandbox testing in pending or canceled state?
    This could happen when you use the wrong test card or ones that are not officially provided by Ecentric. You need to only use the test cards/tokens provided by Ecentric for your sandbox testing.
  3. Why are some of my transactions in a needs_attention state?
    A transaction is in a needs_attention state when there is a potential timeout between the payment request and the response from the gateway. In such cases, the merchant is required to check the status of these transactions with the gateway and if found successful, proceed with a refund of those transactions.

Was this article helpful?