Connecting Magento 2 - Seller

This guide is for Sellers connecting their Magento 2 store with Convictional. The Buyer guide is here.
We recommend setting up a unique Magento store view to support Convictional's requirements without affecting your customer-facing store.
Convictional supports integrations with Magento version 2.4.4 and higher. Lower versions may not be able to integrate successfully.

Step One: Connect Platform

  1. Ensure that Magento 2 was selected when your company was created.
  2. Check this by looking for "Connect your Magento 2 Store" in your Convictional account's Integration Settings.
  3. Provide the URL of your store during sign-up. The format is "".
  4. If you do not see this section, contact support.

Step Two: Grant Permissions

  1. Go to your Admin dashboard > Stores > Configuration > Settings.
  2. Next, navigate to "Services" and "OAuth".
  3. Click the dropdown for "Allow OAuth Access Tokens to be used as standalone Bearer tokens" and select "Yes":
  4. Click "Save Config" at the top of the screen:

Step Three: Generate API Keys

  1. You will need to provide Convictional with Magento2 API keys in order to connect your store.
  2. Go to your Admin dashboard > System > Extension > Integrations.
  3. Click "Add New Integration"
  4. Enter in "Convictional" for the Name field, and your admin password:
  5. Go to Basic Settings > API. On the "Resource Access" dropdown under "Available APIs", select "All":
  6. Selecting "All" will check off the full list of resources:
  7. Click on the arrow beside "Save" and click "Save and Activate":
  8. Click "Allow":
  9. This will generate the API keys. The API Keys look like this:
  10. Copy these keys into your Convictional Settings panel. If you have the code for the store view that you obtained in the previous step, enter it in here as well. Click "Save Credentials":
  11. Convictional will display that the credentials saved correctly:
Within 30 minutes, your products will be visible within the Products tab.

Step Four: Enable Delivery Method

  1. You must enable a shipping method for Convictional to be able to place orders on your Magento store.
  2. Go to Admin > Stores > Settings > Configuration > Sales > Delivery Methods:
  3. Set "Enabled" to "Yes. This will enable "Flat Rate" or "Free shipping" shipping.
  4. You may need to uncheck "Use system value" before you can do this.
  5. Click "Save Config" at the top.

Step Five: Enable Payment Method

You must have a payment method enabled for Convictional to be able to place orders on your Magento store.

  1. Navigate to your Magento 2 Admin > Stores > Settings > Configuration > Sales > Payment Methods:
  2. Navigate to "Other Payment Methods". Then expand "Check / Money Order":
  3. Set "Enabled" to "Yes". This enables "Check / Money Order," "Cash On Delivery," or "Bank Transfer" settings.
  4. You may need to uncheck "Use system value" before you can do this.
  5. Click "Save Config" at the top.

Next Steps

  1. Now you will need to create your price list in the Prices page.
  2. Attach your price list to your partners. This will allow your partner to merchandise your products.
  3. When your buyer receives or directly submits an order for your product, we will pass that order back into your store so that you can fulfill it.


Whitelisting Convictional IP Address
You can whitelist our services in your firewall. Convictional requests originate from34.27.67.179
I don't want these shipping methods and payment settings open for my customers. What can I do?
We recommend setting up a new Magento store view for Convictional. This will allow you to set up your Magento store exactly how you'd like for the Convictional integration without affecting your main customer-facing store.

How did we do?

Connecting Magento 2 - Buyer