VibeFox Netopia for PrestaShop — Help

Requirements

PrestaShop: 8.0 to 9.x.

PHP: 8.0 or later with the OpenSSL, DOM and SimpleXML extensions. The module refuses to install without them.

Currency: the cart currency must be RON, EUR, USD or GBP. EUR, USD and GBP must be enabled on your Netopia account. For other currencies the payment method is hidden at checkout.

Netopia account: you need a Netopia Payments seller account with a point of sale. From its technical settings you need the account signature and, for each environment you use (sandbox and live), the public certificate (.cer) and the private key (.key). Nothing has to be set up on the Netopia side: the IPN address is sent with every payment request.

Public shop: the IPN (confirm) URL must be reachable from the internet, not behind a login or basic authentication. Orders are created only by the Netopia IPN.

VibeFox license key: bought on vibefox.net. One key works on one domain.

Installation

1. In the back office go to Modules > Module Manager and click Upload a module. Choose the module ZIP file.

2. When the upload finishes, click Configure, or find VibeFox Netopia Gateway in the module list later and click Configure.

3. Paste your VibeFox license key into License key in the license block at the top of the Configure page and click Activate (see License key).

4. In the Netopia admin open your point of sale, copy the account signature and download the certificate and private key of the sandbox and of the live environment. Paste the signature and the full file contents into the settings (see Configuration).

5. Turn on Enable/Disable and click Save. Test a payment in sandbox mode, then turn off Test mode to take real payments.

On install the module creates two order statuses, Awaiting Netopia payment and Netopia payment on hold. PrestaShop offers a new payment module for all currencies, countries and customer groups. You can limit them in Payment > Preferences.

Configuration

All settings are on the module page: Modules > Module Manager > VibeFox Netopia Gateway > Configure. Each section has its own Save button, which saves the whole page. Above the fields the page warns you when the account signature, certificate or private key of the active environment is missing (the payment method is then hidden at checkout), and shows Test mode is on: payments go to the Netopia sandbox and no real money is charged. while test mode is on. When you save, an invalid certificate or private key is rejected with an error and the previous value is kept; the other fields are saved.

IPN (confirm) URL

Shown read-only at the top of the page. With friendly URLs it looks like https://your-shop/module/wcp_netopia_gateway/notify, possibly with a language code such as /en/. It is sent with every payment request as the confirm URL, so you do not need to enter it in the Netopia admin. Netopia sends the IPN to this URL. The module decrypts it with the private key of the environment the payment was started in and checks your account signature and the payment request. Netopia reports these actions:

confirmed: the payment was made and captured. The order is created as paid, or an awaiting order is marked paid.

paid: the payment is authorized (pre-authorization). The order waits in Awaiting Netopia payment until you capture it in the Netopia admin.

confirmed_pending, paid_pending: the payment is under review at Netopia. The order waits in Awaiting Netopia payment.

canceled: the payment was cancelled. An awaiting order is cancelled; without an order the customer can pay again.

credit: a refund was made in the Netopia admin. It is recorded on the order.

A notification with a Netopia error code (for example a declined card) sets an awaiting order to Payment error; without an order the customer can pay again. Notifications that cannot be decrypted, carry another account signature or do not answer a payment request of that cart are rejected and change nothing.

Checkout

Enable/Disable: Enable Netopia Payments turns the payment method on or off. Default: off.

Title: the payment method title shown at checkout. It is also the payment method name stored in the order. Default: Card Payment (Netopia).

Description: the payment method description shown at checkout. Default: Pay securely with your credit or debit card via Netopia.

Netopia account

In the Netopia admin go to Seller accounts > your point of sale > Technical settings: copy the account signature and download the public certificate (.cer) and the private key (.key) of each environment. Open the files in a text editor and paste their full content, including the BEGIN/END lines.

Account signature: the seller account signature (format XXXX-XXXX-XXXX-XXXX-XXXX), the same for sandbox and live.

Test mode: uses the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Default: on. Turn it off to take real payments with the live keys.

Sandbox public certificate (.cer): the content of the sandbox public certificate file. It is used to encrypt the payment request.

Sandbox private key (.key): the content of the sandbox private key file. It is used to decrypt the IPN.

Live public certificate (.cer): the content of the live public certificate file.

Live private key (.key): the content of the live private key file.

Saved private keys are never shown again. The field stays empty, and its help text starts with A private key is saved. Leave it empty to keep the saved key, or paste a new key to replace it. An empty certificate field removes the certificate.

Clear saved private keys: tick a key and click Save to remove it. An empty field keeps the saved key.

Orders

Order status after payment: the status of a paid order.

Processing (Payment accepted): the standard PrestaShop status for paid orders (default).

Completed (Delivered): every paid order becomes Delivered.

Advanced

Debug log: writes requests and IPN processing to logs/netopia_p_debug.log.php in the module folder. The file cannot be opened from the web. Card data, keys and customer details are not logged. Errors, for example rejected IPNs, are always logged, even when the option is off. Default: off.

Log: shows the size and the latest entries of the log. Click Clear log to empty it.

Delete data on uninstall: removes the gateway settings, the Netopia payment records of the module and the log when the module is uninstalled. Orders are kept. Default: off.

Checkout

At the payment step the customer chooses the payment method (by default Card Payment (Netopia)) and confirms. The next page shows Redirecting you to Netopia for secure payment… and sends the customer to the Netopia payment page automatically, with the buttons Proceed to payment and Cancel (back to the checkout) as a fallback. The payment request is encrypted with your Netopia certificate and contains the cart total in the cart currency, Cart # with the cart number, and the billing and shipping contact details. In sandbox mode the request goes to the Netopia sandbox. No order exists yet at this point.

The customer pays by card on the Netopia page and returns to your shop. The return itself never creates or pays an order. The order is marked paid only after Netopia confirms it by the IPN. If the order exists, the customer sees the standard order confirmation page. For an awaiting order it shows Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. For an order on hold it shows Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. For a cancelled order it shows The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. For an order with a payment error it shows The payment was declined by Netopia.

If the IPN has not arrived yet when the customer comes back, a Payment confirmation page shows the same "not confirmed yet" text with the buttons Check again and Back to checkout. The order is created as soon as the IPN arrives.

If Netopia reported a cancellation or a decline before any order was created, the customer is back at checkout with The payment was cancelled at Netopia. You can try again or choose another payment method. or The payment was declined by Netopia. You can try again or choose another payment method. The cart is kept. Each new attempt is a new payment request; earlier requests of the cart stay valid, so a late IPN of an earlier attempt is still recorded.

If the module is not set up correctly, the customer stays at checkout with Netopia gateway is not configured properly. Please contact the store administrator. Other messages are Netopia cannot process payments in plus the currency, This order has nothing to pay. and Payment encryption failed. Please try again or contact support. The technical reason is written to the log.

The IPN works while the shop is in maintenance mode and is not blocked by the country restriction of your shop.

The module takes card payments through the Netopia v1 card protocol only. It has no refunds or capture from PrestaShop, no saved cards or one-click payments, no subscriptions, installments or other payment methods, and no Netopia API v2.

Orders and refunds

Order statuses

No order yet: the customer was sent to Netopia and has not paid, or Netopia has not sent the IPN yet. Only the cart exists.

Payment accepted or Delivered: Netopia confirmed the payment. The status follows Order status after payment. The payment is recorded with the Netopia transaction as the transaction ID, and a private note shows the amount, the masked card number and the Netopia transaction; sandbox payments are marked [sandbox].

Awaiting Netopia payment: the payment is a pre-authorization waiting for capture in the Netopia admin, or it is under review at Netopia. No payment is recorded yet. The order moves to the paid status when Netopia confirms it.

Netopia payment on hold: the invoice amount or currency differs from the cart or order, only part of the payment was captured, Netopia confirmed the payment of a cancelled order or of an order placed with another payment method, or a sandbox (test) payment was confirmed while the shop is in live mode (no real money was received, so no payment is recorded). The note explains it. Check the transaction in the Netopia admin, then process the order or refund the payment there.

Payment error: Netopia reported an error, for example a declined card, for an awaiting order.

Canceled: Netopia cancelled the payment of an awaiting order.

Refunded: the payment was fully refunded in the Netopia admin.

Late notifications never downgrade a paid or closed order. If Netopia confirms another payment for an order that is already paid, a note asks you to refund the duplicate in the Netopia admin.

Netopia block

The order page shows a Netopia Payments block with the Netopia transaction, the environment (sandbox or live), the payment request, the last IPN action, the masked card, the paid, refunded and remaining amounts and the refund history. The block is read-only.

Refunds

Refunds are not made from PrestaShop: the Netopia v1 card protocol has no refund call. Refund the transaction in the Netopia admin. Netopia then sends a credit IPN, and the module records the refund on the order automatically with the note Netopia refund processed: and the amount. A partial refund keeps the order status; when nothing is left to refund, the order is set to Refunded. For EUR, USD and GBP orders the refunded amount, which Netopia reports in RON, is converted back to the order currency. A refund is never recorded twice and never for more than the remaining amount. If Netopia reports an error for the refund, only a note is added.

The module does not create credit slips and does not restock products. The standard PrestaShop refund buttons of the order page do not send money back through Netopia.

License key

The module works with a VibeFox license key from vibefox.net. The license block License — VibeFox Netopia Gateway is the first block on Modules > Module Manager > VibeFox Netopia Gateway > Configure, above the settings. Paste the key into License key and click Activate. After that the block shows the key masked, the status (for example the date the license is active until and your domain) and the buttons Check now to check the status again, Change key to enter another key and Remove key to remove the key from this shop. Below them are the line Product: presta-payment-netopia and the link Manage licenses and domains in your account, which opens your vibefox.net account. Only employees with the Configure permission for the module can change the key. The texts of the block follow the back office language (English and Russian are included).

If the key is not accepted, the block says why, for example Key not found, This key belongs to another product, Domain limit reached or License expired on a date. After the shop address changes, or after you free a domain slot in your account, click Check now. If the license server cannot be reached, the module keeps working on the last known status.

One key works on one domain: the domain of the main shop, also in a multistore setup. Removing the key from the shop does not free its domain slot. Free the slot in your vibefox.net account.

Without an active key, Netopia is not shown to customers at checkout. If a payment is started anyway, the customer sees This payment method is not available. Please choose another one. The PrestaShop storefront does not know that you are logged in to the back office, so the payment method is hidden for you too: you can set up the module before you buy a key, but not test it at checkout. A reminder appears in Modules > Module Manager on the Alerts tab. Existing orders are not affected: payments already started are still confirmed, and refunds made in the Netopia admin are still recorded.

When a license expires, the module keeps working, but updates and support need a renewal. The status is checked again automatically while you work in the back office: once a day for the first 14 days after the key is entered, then once a week. No cron job is needed. Uninstalling or resetting the module always removes the license key and license status.

Troubleshooting

Netopia does not appear at checkout: check that the license is active, Enable/Disable is on, the active environment is complete (Account signature plus the certificate and private key of the sandbox in test mode, or of live in live mode) and the cart currency is RON, EUR, USD or GBP. The settings page shows a warning when something is missing. In Payment > Preferences check that the module is allowed for the cart currency, the customer's country and the customer's group.

The payment went through, but no order was created: the IPN did not reach your shop or was rejected. Check that the IPN (confirm) URL from the settings is reachable from the internet (no basic authentication or firewall). Look at the Log field on the module page: rejected IPNs are always logged. Turn on Debug log to see every IPN. The customer's return alone never creates an order.

Log shows failed decrypting data: the private key does not match the certificate Netopia used. The IPN is decrypted with the saved private key of each environment, so keep the key of the other environment saved while its payments are still open. Netopia retries the IPN.

Log shows signature mismatch: the Account signature differs from the point of sale that sent the IPN. Copy it again from the Netopia admin.

Log shows unknown payment request: the IPN does not answer a payment request your shop made for that cart in that environment (sandbox or live). Nothing is changed.

Log shows gateway not configured: no private key or no account signature is saved. Netopia retries the IPN, and the payment is recorded once the settings are complete.

Log shows busy, retry later or processing failed: the cart was being processed by another request at the same moment, or the order could not be created (for example, the module is disabled). Netopia retries the IPN automatically.

Error on save about the certificate or private key: the pasted text is not a valid certificate or key. Paste the full file content including the BEGIN/END lines. The previous value was kept.

Order is Netopia payment on hold after payment: read the private note of the order (see Order statuses). The amount or currency differed, only part was captured, the order had been cancelled, or a sandbox payment was confirmed while the shop is in live mode. Check the transaction in the Netopia admin.

A refund made in Netopia does not appear on the order: the credit IPN did not reach the shop or was rejected. Check the log.

Uninstall

Go to Modules > Module Manager, open the menu next to VibeFox Netopia Gateway and choose Uninstall. The license key and license status of this module are always removed. If Delete data on uninstall is on, the gateway settings (including the saved keys), the Netopia payment records of the module (shown in the Netopia block of orders) and the log are removed. If it is off, everything is kept for a later re-install. Orders and the order statuses Awaiting Netopia payment and Netopia payment on hold are never deleted. Existing orders keep their payment notes and transaction IDs.

Netopia Payments and mobilPay are trademarks of their respective owners. This module is not affiliated with or endorsed by Netopia Payments.