Skip to main content

Online payments

Configuration

Last updated: 09-Aug-2024

After installing the plugin, you need to configure the correct credentials that will associate it to your Verifone account.

  1. Click on the Edit button to enable the Verifone Hosted payment option.
  2. The configuration page should look like the one displayed below. There are several tabs, grouping various settings you need to perform.

       Each field/option has a tooltip which can be viewed by hovering the "?" icon.

    Account settings

    OpenCart Account settings screen

    The information in the Account settings area is mandatory.

    • Status: Enables or disables the Verifone Payment Method.
    • Choose environment: By toggling this setting, you can switch between production and test mode. You can use the Verifone Sandbox (CST) environment to test your integration (for this, you will need to have an account set up in the test environment). If the Test mode (CST) option is switched ON, you will need to use the information from your test account (user ID, API key, organization ID, PPC etc).
    • User ID: The ID of the user that generated the API key in Verifone Central. You can find this information in your Verifone Central account, under Profile API Keys.
    • API Key: The value of the API Key you created in Verifone Central, under the user icon > API keys > Create API key.
    • Organization ID: The organization ID can be found in Verifone Central, under Administration Organizations. There might be several organizations available as part of your account hierarchy. When filling in the organization ID here, make sure you pick the ID of the organization connected to your Payment Provider Contract. You can check that by clicking on the organization and searching for the associated payment provider contracts.
    • Region: The region in which your Verifone account is created. Check your Verifone Central access URL if in doubt.

    Display settings

    The Display settings area allows you to configure the look and feel of your payment page.

    OpenCart Display settings screen

    • Checkout type: Choose whether you need the Verifone checkout to be displayed as a standalone page where your customers are redirected to perform the payment or as an iFrame (embedded onto your website page).
      • Hosted Payment Page (HPP) - the shopper is redirected to a payment page hosted by Verifone to make the payment. Upon completion of the payment process, the shopper is redirected back to your website page.
      • iFRAME allows you to display a payment form component as part of your own website, without having to redirect the shopper to a new web page. The form is still securely hosted by Verifone, so there is no additional PCI scope required for you with this solution.
    • Total: The Checkout value the order must reach before Verifone payments are available.
    • You can define the payment statuses for OpenCart orders.
    • Geo zone: Geographical zone in which Verifone payments are available.
    • Theme ID: Verifone allows you to customize the look and feel of the payment page you show to your customers. To use this in conjunction with our WooCommerce plugin, you need to create a custom theme for your payment page, by using the tool available in your Verifone Central account. Once the customer theme is created, you will be able to pick up the theme ID and fill it in the WooCommerce display settings section. More on themes can be found here.

    Card payment settings

    The card payment settings area allows you to configure the payment details needed to process card payments, gift cards and/or Private Label Credit Cards (PLCC).

    OpenCart Card payment settings screen

    • If you switch ON the Enable card payment toggle button, you need to provide information about your Payment provider contract ID. You can find this info in your Verifone Central account, under Administration Payment Provider Contracts. Make sure you collect the ID belonging to that Payment Provider Contract that enables card payments.
      • If you switch ON the Enable card 3DS toggle, you need to provide information about your 3DS Contract ID. The 3DS Contract ID can be found in your Verifone Central account, under Administration 3D Secure Provider Contracts.
    • If you switch ON the Enable Gift Cards toggle button, you need to provide information about your Gift card contract ID. You can find this info in your Verifone Central account, under Administration Payment Provider Contracts. Make sure you collect the ID belonging to that payment provider contract that enables gift card payments.
    • If you switch ON the Enable PLCC toggle button, you need to provide information about your Gift card contract ID. You can find this info in your Verifone Central account, under Administration Payment Provider Contracts. Make sure you collect the ID belonging to that payment provider contract that enables gift card payments.

    Alternative payment options

    Based on your agreement with Verifone, there might be alternative payment methods that you would like to provide to your shoppers as options available on the payment page.

    OC alternative payment options

    • Apple Pay/Google Pay/ Vipps/Mobile Pay
      • SCA (Strong Customer Authentication): Given that wallet payment providers already have Delegated Authentication rights to perform Strong Customer Authentication, we recommend setting this to “wallet”.
      • Apple Pay/Google Pay/ Vipps/Mobile Pay Payment Provider Contract ID: The ID can be found in Verifone Central, under Administration Payment Provider Contracts, after selecting the contract available to process card payments through the desired wallet-type APM.
    • PayPal
      • PayPal payment provider contract ID: The ID can be found in Verifone Central, under Administration Payment Provider Contracts, after selecting the contract available for PayPal as a service provider.
    • Klarna
      • no additional fields should be configured.
    • Swish
      • no additional fields should be configured.
    • Bank OP payments
      • Bank OP payment provider contract ID: The ID can be found in Verifone Central, under AdministrationPayment Provider Contracts, after selecting the contract available for Bank OP as a service provider.

    Advanced settings

    OpenCart Advanced settings screen

    • Enable/Disable cURL verify host and peer: Enable this setting to avoid plugin requests to time out. Highly recommended if both host and peer are using HTTPS (TLS).
    • Enable/Disable overlay when placing order: This option will enable an overlay when placing an order. This is nothing more than a visual indication that the request is starting.
    • Transaction type:
      • Pre-auth - Preauthorization acts as a reservation on your cardholder’s account. Once you are able to ship the products and decide to withdraw the amount, you can then capture the payment. Preauthorization allows you more time to capture the payment (it is usually 30 days but this needs to be checked with acquirer, as it might vary depending on card schemes/ merchant category code). Also make sure Verifone supports this transaction type for the acquiring solution you are using.
      • Auth - Authorization also acts as a reservation on your cardholder’s account – that you can capture later on, once you ship the products to your customers. The difference between authorization and preauthorization is that you only have up to 7 days allowed by the time you decide to capture the amount. Here as well, check that Verifone supports this transaction type for the acquiring solution you are using.
      • Sale - The sale transaction implies authorization and capture are done in one single step.
  3. Once all needed options are selected, save the changes.

    OpenCart save changes

Once the configuration is completed, make sure to set up your Webhooks.

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo