• Documentation
  • API Reference
  • Documentation
  • API Reference
Expand All Collapse All
  • Payment Overview
    • Introduction
    • Choosing an Integration Method
  • Accept Payment
    • Payment Page
      • Quick Start
      • Input Parameters
      • Output Parameters
    • Web SDK
      • Quick Start
      • Nuvei Fields
        • Styling
      • Additional Functions
      • APM Payments
      • Tokenization-Only Flow
      • Scenarios
      • Using ReactJS
        • Full Samples
        • Sandbox Examples
      • FAQs
    • Checkout
      • Quick Start
        • UI Customization
        • Payment Customization
        • Advanced Controls
        • Checkout Examples
      • Server-to-Server
      • Payment Scenarios
      • Mobile SDKs (Beta Release)
        • Android Mobile SDK (Beta Release)
        • iOS Mobile SDK (Beta Release)
      • Flow Diagrams
      • Plugins
        • Magento
          • Rebilling with Magento
        • WooCommerce
          • Rebilling with WooCommerce
        • PrestaShop
          • PrestaShop with Web SDK
          • PrestaShop with Checkout
        • OpenCart
        • Shopify (via AsiaBill)
        • Mirakl
        • Salesforce
        • SAP
        • WIX
      • Marketplaces
    • Features
      • Authentication
      • Financial Operations
        • Refund
        • Void
        • Auth and Settle
        • Partial Approval
        • Currency Conversion (DCC and MCP)
        • Payout
      • Card Operations
        • Card-on-File
        • PCI and Tokenization
        • Zero-Authorization
        • Merchant-Initiated Transactions (MIT)
        • Blocking Cards
      • Subscription (Rebilling)
      • 3D-Secure
        • 3D-Secure Explained
        • 3DS Implementations
          • 3DS MPI-Only Web SDK
          • 3DS MPI-Only REST
          • 3DS External MPI
          • 3DS Responses
        • 3DS Functions
          • 3D-Secure Fingerprinting
          • 3D-Secure Authentication Challenge
      • Webhooks (DMNs)
        • Payment Transaction Requests
        • Control Panel Events API
    • Guides
      • Testing Cards, APIs and APMs
        • Testing Cards
        • Testing APIs with Postman
        • Testing APMs
      • Response Handling
      • Alternative Payment Guides (APMs)
      • Airline Ticket Guides
        • Airline Addendum
        • External Authorization Addendum
      • Payment Facilitators (PayFac)
      • Cashier
        • Cashier Events Guide
        • Cashier Features
      • Withdrawal Guide
      • Risk Guide
        • Nuvei Services
        • Transaction Types
        • Credits and Payouts
        • Fraud to Sale Programs
        • Compliance Programs
        • Chargebacks
      • eKYC Guide
      • Server SDKs
        • Java SDK
        • .NET SDK
        • PHP SDK
        • Node.JS SDK
      • Fast Track Onboarding Developer Guide
      • Currency Conversion Guides
        • Multiple Currency Pricing (MCP)
        • Dynamic Currency Conversion (DCC)
          • DCC in Cashier or Payment Page
          • DCC in REST API Workflows
          • DCC in Web SDK Workflows
      • Website Compliance Guides
    • Additional Links
      • FAQs
      • API Reference
      • Release Notes
      • Country and Currency Codes

    PrestaShop with Web SDK

    On this page:
    • Assumptions and Restrictions
    • Supported Versions
    • Installation
    • Plugin Configuration
    • Payment Page
    • Order Payment Status Update
    • Order Details
    • Rebilling with PrestaShop
      • Download Merchant Payment Plans from the Control Panel
      • Create Nuvei Attribute
      • Configure a Product

    Assumptions and Restrictions

    Before proceeding to Nuvei plugin installation, you need to have PrestaShop installed.

    The Nuvei plugin should be also installed and configured.

    If you do not have test credentials to test the payment flow, please contact our Tech Support team.

    Supported Versions

    The Nuvei PrestaShop plugin is tested on the following versions:

     Oldest Supported VersionLast Tested Version
    PrestaShop1.7.7.0current

    Installation

    Follow the instructions in the GitHub page to install the plugin:

    https://github.com/SafeChargeInternational/safecharge_prestashop

    Plugin Configuration

    Before setting up the Nuvei PrestaShop plugin, you should contact Tech Support to provide account credentials.

    The plugin can be found in Modules > Module Manager menu at the bottom of the page – Other.

    To configure the plugin:

    1. Click the Configure button and enter the credentials below:
    2. Click Save.

    ParameterMandatoryDescription
    Default titlenoThe title for the Store
    Test modeyesEnable the payment test mode. Any payments on the test mode are not really processed. Please, do not use real credit card details.
    Merchant IDyesThis is the merchant ID provided by Tech-Support. If you don’t have it, please contact Tech-Support
    Merchant Site IDyesThis is the Merchant Site ID provided by Tech-Support. If you don’t have it, please contact Tech-Support
    Merchant Secret keyyesThis is the secret key provided by Tech-Support. If you don’t have it, please contact Tech-Support
    Hash typeyesThe hash type provided by Tech-Support. If you don’t have it, please contact Tech-Support
    Payment actionyesThe transaction type preferred from the merchant and approved by Tech Support. If you don’t have it, please contact Tech Support.
    Save logsnoCreate daily logs with sent and received data and settings. The logs are very helpful for debugging and resolving problems with the plugin.

    Payment Page

    1. Select a product from your shop and go to the Payment Page.
    2. Follow the steps of checkout.
    3. In the Payment Method step (its number can be different), select Nuvei and then press Continue.

    Upon successful payment, the user is redirected to a successful order page.

    Order Payment Status Update

    The order payment details are found in the Sell > Orders > Orders menu.

    Click on any order. Nuvei orders are marked in the Payment column.

    For each order processed with Nuvei, there are order trace notes to help track the payment process.

    After successful payment, the transaction is processed and the order status is updated in the background.

    Order Details

    Order Details and the logs (if they are enabled) are the two places where the merchant can see what happens with an order.

    If the merchant flow is “Auth & Settle” (Transaction type option), all new orders have a status of “Pending payment”.

    Under Items, you see the Settle button to settle an order.

    If the merchant flow is “Sell” or the order was Settled, two buttons are available: Partial Refund and Void. With them you can request a refund or void your transaction once the order is completed.

    When you click on either of these buttons, you must confirm your action. After the action is completed, a note with the information is created.

    Rebilling with PrestaShop

    The Nuvei plugin for PrestaShop supports Rebilling via a credit card.

    Download Merchant Payment Plans from the Control Panel

    1. Go to the Modules menu and find the Nuvei Payments plugin.
    2. Click the Configure button.
    3. Scroll to the end of the page and click the Download Payment Plans button.

    If you do not have any Plans, a default one is created. If the operation is successful, a green checkmark is shown. Under the button, you have the the date of last download.

    We use these plans later to populate Subscription details, which you can then update.

    The Initial amount is always 0.


    Create Nuvei Attribute

    1. Go to Catalog > Attributes & Features and click the Add new attribute button on the top.
    2. For the new Attribute, set the English Name to “Nuvei Payment Plan”. For the Public name you can use a different name. In the Attribute type dropdown, select “dropdown list” and click Save.
    3. Add new parameters for the Attribute by clicking on its name in the attributes list. If the parameters list is empty, click the Add new value button on the top.
    4. Be sure that the Attribute group is “Nuvei Payment Plan”.
    5. Set the Value, which is just the name of the plan. The details of the plan are set later individually for each product.
    6. Click Save.

    You can add as many plans names as you want.

    Configure a Product

    1. Go into Catalog > Products and either create new one or edit an existing one.
    2. On the right under Combinations on the Basic settings tab, select “Product with combinations”.
    3. On the Combinations tab, on the right is the list with all attributes in Prestashop.
    4. Find “Nuvei Payment Plan” attribute and select all plan names you want to use for this product.
    5. After you selected the attributes, click the Generate button and the Combinations are generated and ready for edit.
    6. For each new product, at the end of the row, there are two icons – edit and delete. You must edit each product and set the Subscription plan details.

    Changing the Plan ID prefills other parameters, but the merchant can change them.

    There is no Initial Amount filed, it is 0 by default. The Product price can be used as Initial amount. At the end save the changes.

    If the merchant changes Basic Settings > Combinations to Simple product, all generated products are deleted.

    An example product with Subscription in the Store:

    When the client changes the Nuvei Payment Plan, the Nuvei Plan details are filled with product Subscription details.

    An Order can hold only one product with a Payment plan. If there is a product with a payment plan in the Cart, you cannot add more products to it.

    However, you can have more than one of the same product with a Plan in the Cart. In this case, the number of Subscriptions is equal to the Product quantity.

    The Subscriptions start after a successful Sale or Settle transaction and a DMN is received.

    The Subscriptions, if any, are cancelled after a successful Void and a DMN is received.

    The merchant can recognize the orders with the Rebilling in the Orders list by the “Nuvei Subscription” indication next to their status:

     

     

    Oldest Supported Version Last Tested Version
    Oldest Supported Version
    Last Tested Version
    PrestaShop 1.5 1.7.6.0

     

    # Field Name Mandatory Notes
    1 Default title no The title for the Store
    2 Merchant ID yes This is the merchant ID provided by Tech-Support. If you do not have it, please contact Tech-Support
    3 Merchant Site ID yes This is the Merchant Site ID provided by Tech-Support. If you do not have it, please contact Tech-Support
    4 Merchant Secret key yes This is the secret key provided by Tech-Support. If you do not have it, please contact Tech-Support
    5 Hash type yes The hash type provided by Tech-Support. If you do not have it, please contact Tech-Support
    6 Payment action yes The transaction type preferred from the merchant and approved by Tech Support. If you do not have it, please contact Tech Support.
    7 Test mode no Enable the payment test mode. Any payments on the test mode are not really processed. Please, do not use real credit card details.
    8 Force HTTP notify URLs no If your site is on https server, but you cannot receive the DMS, force Notify URL to be http.
    9 Save logs no Create daily logs with sent and received data and settings. The logs are very helpful for debugging and resolving problems with the plugin.
    10 Remove oldest logs Remove oldest logs, last 30 are kept.

     

    2022 Nuvei. All rights reserved.