Table of Contents

Understanding the Integration


How the Gateway Works?

Our Platform offers a secure server-based transaction processing service which enables your business to authorize and process credit and debit card transactions online, in real-time. All the information necessary to process the transactions is sent over a secure, encrypted connection.

Once the transaction details have been provided and submitted to the payment gateway, the server connects with your acquiring bank to perform the authorization procedures and, depending on the transaction type and the acquirer's response, a receipt is returned to your customer.

The transactions are settled automatically by the Payment Gateway and the Acquiring Bank deposits the funds into your bank account.

Nuvei automatically archives sales that are finalized so that you can refer to them at a later date.

This guide is going to provide instructions on how to integrate a website or application with the payment gateway and take automatic credit card payments.

Choosing Your Integration Method

There are two integration methods available: Hosted Payment Page and XML. You can use one or a combination of them as required, but you should consider the integration method carefully before starting any development planning.

The following information is presented to help you decide on the most appropriate integration method for your solution with the Nuvei gateway. It is intended for review after you have decided upon your merchant account but before you start integrating with us. All costs will be considered including integration cost, ongoing merchant costs, PCI DSS compliance costs and Nuvei's own charges. Different technologies, languages, consumer industries, server environments and other technical considerations will also be addressed.

The Hosted Page Integration Method

The Hosted Page (HP) has been created as a method for small-to-medium sized organisations to integrate their websites with our payment gateway. This is a hosted service with the highest levels of internet security, whose appearance can be customized to look just like your site. This is solely for use as a payment gateway for websites.

The benefits of the HP:

The XML Gateway Integration Method

The XML gateway is intended for much more elaborate integrations and for very large sites. It offers full access to all of our products and methods through a high speed, common platform gateway. This can be used as a payment gateway for a large website, but it can also be integrated into your existing corporate infrastructure. Companies using the XML gateway must maintain their own security and are subject to more rigorous PCI security assessment.

Benefits of the XML gateway:

Costs

Small Business

For small businesses the Hosted Payment Page is nearly always the most cost effective route. There is an extra cost involved with using this service, but it is greatly outweighed by the savings made both directly because an SSL certificate does not have to be maintained and because the integration is very simple compared to other methods, and indirectly in that it removes the workload required to manage PCI compliance.

Large Enterprise

For large enterprise the costs involved can be quite difficult to calculate. You must take into account development costs, opportunity costs during the development period, the value of customer loyalty due to having an easy to use site, etc.

Testing Your Integrations

In order to integrate with the Payment Gateway, a few modifications are necessary to your solution.

Once you have completed your modifications, perform the relevant transaction types as listed in our Merchant Validation Document.

Please note that when testing you must supply at least TWO successful transactions per transaction type that you intend to use. Please refer to the functionality checklist in the Merchant Validation Document. Two transactions are necessary to ensure consistency when our Integration team analyses your transactions. Record all pertinent information relating to the testing and return the completed forms to our integration team via email. The integration team will contact you to confirm that you have successfully validated against the Payment Gateway.

For details on testing, please visit the Integration Docs and explore our guides.