Magento 2: Test and go live

Test payment methods

Test your payment methods by simulating various payment statuses.



  • Use Mollie test credentials to test credit/debit cards.
  • Apple Pay Direct works only in a production environment (in either test or live mode), and on Apple devices or Safari.
  • Test Apple Pay Direct and the Bancontact QR code by making actual payments, as they only work in live mode.

Switch to test mode

In test mode, Mollie simulates payments: no real money transfers occur.

  1. Log in to Magento 2.
  2. Go to Stores > Configuration.
  3. Expand the Mollie section in the left sidebar, and select General.
  4. Select Test from the Modus drop-down menu under API details.
  5. Save the changes.

Make a test payment

  1. Make a test purchase in your Magento 2 shop.
  2. On the checkout page, select the payment method and submit the order.
  3. In the dialogue box that appears, select a payment status and click Continue.
    This takes you to a page about the payment's status. For example, if you selected Paid, the page confirms a successful payment.

Get status updates in local test environments

Mollie webhooks only work with public URLs. This means that when you're developing locally (for example, https://localhost:8000), you must create a temporary, public URL to tunnel Mollie HTTP traffic to your local host.



In principle, your local environment remains public for as long as the tunnel exists. However, tunneling apps usually provide options for restricting access.

  1. Download and install a tunneling app. We recommend using ngrok↗.
  2. Start an HTTP tunnel:
    ngrok http 80 -region eu
  3. Change the base URL manually in the backend of your Magento 2 installation.
    Alternatively, use n98-magerun↗ to change the URL:
    export SHOPHOST=""
    n98-magerun2 config:store:set web/unsecure/base_url http://$SHOPHOST/
    n98-magerun2 config:store:set web/secure/base_url https://$SHOPHOST/
    n98-magerun2 config:store:set web/unsecure/base_link_url https://$SHOPHOST/
    n98-magerun2 config:store:set web/secure/base_link_url https://$SHOPHOST/
    n98-magerun2 cache:flush
  4. Depending on your installation, you may need to add the ngrok URL as a virtual host or alias to your Apache or NGINX server.
    If you use Laravel Valet or Laravel Valet +, run the following:
  5. valet link

Go live

Go live to switch from test payments to actual payments.



You can only accept actual payments after Mollie has approved your website profile.

What you need to do in advance

  1. Ensure that you've completed the Mollie signup process.
  2. Set up the app according to your preferences.
  3. Test your payment methods to ensure they work properly.
  4. If you have a multiple websites or stores, keep in mind that configuration settings apply to all levels of the hierarchy by default. Ensure that you understand how sites, stores, and view scopes work↗, and change the scope↗ if needed.

Switch to live mode

  1. Log in to Magento 2.
  2. Go to Stores > Configuration.
  3. Expand the Mollie section in the left sidebar, and select General.
  4. Select Live from the Modus menu under API details.
  5. Paste your live API key in the Live API key field.
  6. Select Test API key to ensure your API key is correct.
  7. Save the changes.