Magento: Set up the Verifone Hosted Cart on your Magento store (NZ)

Learn how to integrate the Verifone Hosted Cart with Magento to accept eCommerce transactions on your website

Verifone’s Magento setup documentation

Before following Verifone’s global setup instructions, read this article first. it includes critical NZ-specific advice, common pitfalls, and tips from our local support team to help you get set up smoothly.

What you'll need

• A Verifone Central account with Online Payments enabled
• Administrator access to your Magento store

Manual setup recommended

While Verifone provides an Automatic Setup option for Magento, we recommend following the manual setup process instead. This gives you more control over your configuration.

You’ll find manual configuration instructions in Verifone’s documentation here:

• Magento manual setup guide

Key setup tips for New Zealand merchants

Set your Verifone account region to New Zealand

• This ensures the correct features and settings are applied
• Do not select other regions

Organisation ID

• Go to Administration > Account Setup > Organisation Company and Sites

• Select your organisation and copy the Organisation ID

• Paste it into the plugin exactly as it appears in Verifone Central

Important: Avoid IDs with "Account" or "Site" in the name. Choose the one linked to your eCommerce Payment Provider Contract.

Generate your Secure Card Capture Key under “Account:”

This key must be created at the Account level, not site level

• Navigate to your entity in Verifone Central that starts with "Account:"

• Go to Secure Card Capture and click Create new public key

Enable invoicing

• In the plugin settings, set Invoice to Yes
• This ensures successful transactions automatically generate an invoice in Magento

Select “Sale” as the transaction type

• In Card Payment Settings, choose Sale
• Other options can cause transaction issues or unexpected behaviour in NZ

Fraud Protection not available in NZ

• The global documentation may refer to Fraud Protect, but NZ uses 3DS (3D Secure)
• In the plugin settings, enable 3DS and enter your 3DS Contract ID

Alternate Payment Methods (APMs) not available

• Verifone’s documentation may mention APMs like Apple Pay or PayPal
• These are not currently supported in the NZ configuration

Test credentials

• If you choose to enable Test mode, you’ll need to enter Test Credentials from your test environment
• Contact our support team if you need assistance with this

Get started

Go to Verifone’s Magento setup documentation for full installation and configuration instructions.

Need help?

Our NZ-based support team is here if you need help. Submit a ticket here.