The CRM Providers section enables users to set up, edit, or deactivate payment providers and MIDs. Activating and configuring a Payment Provider and its MIDs are essential steps to allow campaigns to collect transactions. After being configured, these can be incorporated into the user's campaign, facilitating customers to effectively place orders by paying for the products on checkout pages.
How to configure a new payment provider
Please follow the below steps to set up your new payment provider.
- Gather the Payment Provider details: Collect the account details of the payment provider by contacting the account owner. Each Payment Provider may require different information, so it is recommended to contact the DFO Banking team to learn what specifics are needed.
- Set Up the Entity: For creating an Entity for your payment provider in CRM, follow these steps. From the Entities page, click on the '+ Create new' button on the top right. A small tab will appear where you can input the Description, the Company Code, and if applicable, the PayPal Email Descriptor for PayPal entities. Once you've entered these details, click the 'Save' button to store the new entity into the system.
- Activate the Payment Provider & Set it as Offline or Credit Card provider: From the Providers page, input the payment provider that needs a new MID into the search bar. Go to the right side of the payment provider row and click on the 'Edit' button. A small tab will appear where you must toggle the 'Is Active' switch to ON. You can select whether the payment provider will be 'Credit Card (Online)' or 'Offline' by clicking on the 'Types' field.
- 'Credit Card (Online)' refers to online payment providers where customers input billing and credit card details to pay for the order without leaving the checkout page.
- 'Offline' payment providers require customers to log into the payment provider's system (like PayPal, iDeal, Mercado Pago, etc.), which will then automatically provide the billing details, shipping address, etc. The payment in this case is made on the provider's page, unlike the 'Online' payment providers where payments are made on our Checkout Pages.
After setting these, click the 'Save' button at the bottom of the tab.
- Add the MID(s): From the Providers page, type the name of the payment provider that needs a new MID into the search bar. On the payment provider row, click on the 'Provider Mids' button on the right side which will redirect you to the Merchant ID (Mids) page. Click on the '+ Create New' button on the Merchant ID (Mids) page and a 'New MIDs' tab will appear. Fill this tab with the MIDs details - note that the details required for a new MID may vary depending on the payment provider. After completion, click the 'Save' button at the bottom of the tab.
Your Payment Provider and its MIDs are now activated and ready for user testing.
For more information about the Merchant ID (Mids) page, please read the helpdesk article: Merchant ID (Mids)
Editing a Payment Provider
- Deactivate the Payment Provider & Set it as Offline or Credit Card provider: From the Providers page, search for the payment provider that needs a new MID. Go to the right side of the payment provider row and click on the 'Edit' button. In the tab that pops up, toggle the 'Is Active' switch to OFF. Just as when activating, you can select whether the payment provider will be 'Credit Card (Online)' or 'Offline' by clicking on the 'Types' field. After setting these, click the 'Save' button at the bottom of the tab.
- Edit the MID(s)
To edit a new MID for your payment provider, please follow the below steps.
1. From the Providers page, type the name of the payment provider that needs a new MID into the search bar.
2. On the payment provider row, go to the right side and click on the 'Provider Mids' button. This will redirect you to the Merchant ID (Mids) page.
- On the Merchant ID (Mids) page, go to the right side of the page and click on the 'Edit' button of the MID that needs to be updated.
- The MIDs tab will pop up. Change the details of the MID in the MIDs tab.
- Change the details of the MID in the MIDs tab
- Once you have finished editing, click on the 'Save' button at the bottom of the tab.
Merchant ID (Mids)
On the Merchant ID (Mids) page, you can set up a completely new MID, edit, deactivate, or reactivate an existing MID. Here's how you can access and configure it:
- Go to Payments and click on Providers. The Providers page will be displayed on the right side of the page.
- On the right side of the page, click on the 'Provider Mids' button.
- You will be redirected to the Merchant ID (Mids) page of the specific payment provider.
Configuring and Activating a new MID
To add a new MID for your payment provider, follow these steps:
Important: The information required to set up a new MID may vary depending on the payment provider.
- From the Providers page, type the name of the payment provider that needs a new MID into the search bar.
- On the payment provider row, go to the right side and click on the 'Provider Mids' button. This will redirect you to the Merchant ID (Mids) page.
- On the Merchant ID (Mids) page, click on the '+ Create New' button and the New MIDs tab will pop up.
- Fill in the details of the new MID in the New MIDs tab. Please note that the required details may vary for each payment provider
Once you have filled in the necessary information, click on the 'Save' button at the bottom of the tab.
Setting up and Editing in the MID tab
The MID tab provides options and settings for the MID across all payment providers. Here are the available options:
● Mid Code field: Enter the MID name, such as StripeDirectCharge@clientname-Main.
● Descriptor (Product Name) field: Set this field as {0}. For more information, please check the following helpdesk article: Banking Descriptors
● Dynamic Descriptor toggle: When set to ON, it enables the Banking descriptors configured at the product level. Refer to the helpdesk article "Banking Descriptors" for more information.
● Is Active toggle: Set this toggle to ON to activate the MID.
● Is Paypal Direct Debit Active toggle: Set this toggle to ON ONLY if the payment provider is PayPalDirectDebit. Otherwise, leave it OFF.
● 3DS Enabled (Secure Mid) toggle: Enabling 3D Secure (3DS) adds an extra layer of protection to online shopping. When enabled, each online purchase requires 2-step authentication. Only authorized payments will be processed. Unless required by your processor, we recommend this is left as OFF.
● Entity field: To set up a new Entity for your payment provider in CRM, follow these steps:
➢ From the Entities page, click on the '+ Create new' button on the top right.
➢ In the small tab that appears, add the Description, the Company Code, and if it's for PayPal, add the PayPal Email Descriptor.
➢ Click the 'Save' button to save the new entity into the system.
● Main Mid field: Select the main MID, if available, within the Payment Provider MIDs created. This should not be needed unless you have one Master MID and multiple sub MIDs relating to it.
● Mid Cap - Monthly Amount (USD) field: Add the maximum monthly limit that the MID can reach. Include this only if the MID has a monthly limit allowance. Note that if a MID reaches the monthly limit, it will be automatically blocked. It is advisable to set up multiple MIDs for the same campaign or funnel to avoid interruptions. If you do not have a MID cap, please make sure to remove the default value of 0 (it can be left empty)
● Is Active (Mid Cap) toggle: Set this toggle to ON only if the MID has the MID Cap enabled.
● Mid Card Types field: This option becomes visible after the MID has been configured. By selecting this field, a drop-down menu will appear, allowing you to select one, multiple, or all available Card Types.
● Currencies field: Add the currencies. This is a mandatory field, as without currencies, the MID will not function.
● Merchant Client ID field: This field appears for each currency set up on the MID. It can be edited before adding the currency to the list. Note that this is a mandatory field only for Braintree, where each currency should display its unique Merchant Client ID obtained from the user's Braintree account.
● Is Active (PRN) toggle: Set this toggle to ON to activate the MID.
Once you have finished configuring the MID tab, click on the 'Save' button at the bottom of the tab.
The Payment Provider and its MIDs have now been activated and are ready to be tested by the user.
Editing, Deactivating, or Activating an Existing MID
To edit an existing MID for your payment provider, follow these steps:
- From the Providers page, type the name of the payment provider that needs a new MID into the search bar.
- On the payment provider row, go to the right side and click on the 'Provider Mids' button. This will redirect you to the Merchant ID (Mids) page.
- On the Merchant ID (Mids) page, go to the right side of the page and click on the 'Edit' button of the MID that needs to be updated.
- To activate or deactivate the MID, simply toggle the 'Is Active' switch to ON or OFF. For PayPalDirectDebit, you will also need to toggle the 'Is Paypal Direct Debit Active' switch to ON or OFF.
Once you have made the necessary changes, click on the 'Save' button at the bottom of the tab. The Payment Provider and its MIDs have now been updated.