Docs
This feature is a Private Beta Release. Contact support to enable Nuvei for your Test and Live site.
Nuvei is a leading financial technological company. It is a secure and reliable payment processing solution that offers multi-currency processing, low-cost payment processing, currency conversion, payment server development, payment gateway, business card processing, direct selling and gateway services. Nuvei is available in over 200 global markets (countries).
Chargebee is integrating Nuvei via payFURL , which is a payment orchestration platform that provides payment-related API services and specialises in payment gateway integrations.
You can integrate Nuvei using the following:
| Integration Method | Description | PCI Requirements |
|---|---|---|
| Chargebee Hosted Pages | In this method, customers' card information is collected by Chargebee's checkout and directly passed on to Nuvei. | Low (Your PCI compliance requirements are greatly reduced due to usage of Chargebee's checkout.) |
| Chargebee JS | In this method, you can use Chargebee Components and Hosted Fields to collect the customer's card details. | Low |
| Chargebee JS | Using Permanent Token - a token that represents a customer's card details stored in Nuvei'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 JS | Via Raw Card details You will collect raw card details via your custom checkout and pass it to Chargebee.js. |
High |
| Chargebee API | In this method, you will have to collect card information and pass it on to Chargebee via API. Chargebee then routes this card information to Nuvei. Since you will be collecting card information directly, you will have to take care of PCI Compliance requirements. |
High |
3D-Secure is supported for this integration.
Consider the following factors before choosing Nuvei as a payment solution:
Follow the steps below to fetch the information that you will be required to enter during your gateway configuration in your Chargebee site:
Login to your Nuvei account .
Select My Integration Settings under Settings from the left navigation.
Copy the Merchant ID, Site ID, and Secret Key. Save these for future use during the gateway configuration in your Chargebee site.
Follow the steps below to configure Nuvei in your Chargebee site:
Login to your Chargebee site .
Go to Settings > Configure Chargebee > Payment Gateways.
Click Add Gateway and select Nuvei.
Enter the Merchant ID, Site ID, and Secret Key in the dedicated fields as copied in Step 3 of the previous section from your Nuvei account.
Click Connect.
Follow the steps below to configure Card settings for your Nuvei account in Chargebee:
Cards is enabled by default on the Configure Nuvei page. Click Manage to enable other settings under Cards.
Enable the following:
a. Always retain card information in Nuvei when customer updates it: Enabling this option stores the updated card information in Nuvei rather than the default gateway.
b. Enable 3D Secure: Enable this option if you wish to enable authentication for payments made via cards.
Click Save.
This integration supports the use of the Payment Initiator API parameter, which, when passed along with the transaction, helps Chargebee distinguish between Customer-Initiated and Merchant-Initiated transactions and handle the payment more effectively.
In order to successfully setup tokens at Nuvei, following details are needed for all the tokens you want to setup in Chargebee:
* Mandatorily needed to setup token at Nuvei
If you are moving cards from a different payment gateway to Nuvei, then make sure to work with Nuvei to get the transactionId from Nuvei representing a Customer Initiated Transaction (CIT) reference.
Make sure to collect all the above details for all tokens you want to migrate into Chargebee before raising a migration request.
If you are setting this up via API, then you can use the following API reference to map the fields in the permanent token flow:
Here is a sample API reference:
curl -X POST "https://yourdomain-test.chargebee.com/api/v2/payment_sources/create_using_permanent_token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Basic secret=" \
?data "customer_id=3pfr7nqxTJymuyEEA" \
?data "gateway_account_id=gw_2szNCZ6c7c3fiigREJy" \
?data "reference_id=987637653" \
?data "type=card" \
?data "additional_information={"nuvei":{"userTokenId":"5TunrM6zrtJDZfhz71B0EbcZhQkPdVQZ","transactionId":"6597368229552198550"}}"
Note - Replace the field values with your site data when you try this out in sandbox.
Articles & FAQ