Use Case: Set Up Your New Facilitator Account
Set up your new Facilitator account to begin boarding Referrers and Merchants and optimizing your fees, payouts, and other benefits. This tutorial will walk you through the steps for setting up your new Facilitator account after being approved to join the Payrix platform.
Objective
Set up your new Facilitator account and create groups for users that will be boarded under your account.
Audience
Facilitators
Environment
Portal (Sandbox)
Portal (Production)
Getting Started
Prerequisites
You must have a fully boarded Payrix account to perform any of the actions described in the use case guides.
For a full list of additional prerequisites for businesses wishing to set up accounts on the platform as new Payment Facilitators, sometimes called “PayFacs”, expand the section below:
Additional Resources
As you begin setting up your account, please consult the Implementation Guide for more resources.
Review the Whitelabel Process with the Whitelabel and Customized Branding page and the How to Create a Whitelabel page.
Set Up Your New Facilitator Account
1: Log in to Your Portal Account
After your Facilitator account has been enabled on the platform, log into the Portal with your new user credentials.
2. Create a Host to Whitelabel your Merchant Portal
Step 1: Name the Host.
Step 2: Under API HOST, add the API subdomain.
Step 3: Under PORTAL HOST, add the Portal subdomain.
Step 4: Under Background Color, enter the Referrer-provided color code.
Step 5: Set the Signup Form Mode parameter as Sandbox or Production to allow submission in each environment respectively.
Step 6: Replace the Logo, Email Logo, PayFrame Logo, and Favicon with the provided graphic files by clicking on each image tile to upload
Step 7: Toggle on the Terms and Conditions and Privacy Policy parameters and enter their URLs accordingly in the fields to the right.
Step 8: Toggle on the Support Email and Support Phone Number parameters and enter the information in the fields to the right.
Step 9: Provide the Referrer’s Support URL with an optional custom URL Label.
Step 10: Click the Create button to complete the process.
3. Create a Division for Merchant Boarding
Step 1: Click Divisions under the Admin category in the left-hand navigation panel.
Step 2: Click the Add Division button in the upper right corner.
Step 3: Add the Login ID for the User managing the Division.
Step 4: Enter a Name and Email Address for outgoing email communications to Merchants under the Division.
Step 5: Click on your newly created Division to access its Division Profile page.
4. Create the New Group “All Merchants”
Step 1: Click GROUPS in the left-hand navigation panel to open the Groups page.
Step 2: Click the ADD GROUPS button in the upper right-hand corner of the page.
Step 3: Type “All Merchants” into the Group Name field, then click CREATE GROUP. The new group will appear in your Groups table.
5. Add Parameters to the All Merchants Group
Step 1: Click on the All Merchants group in the Groups table to open the Group Profile page.
Step 2: Click the PARAMETERS tab on the left-hand side of the profile page.
Step 3: Click the ADD PARAMETER button in the upper right-hand corner of the page.
Step 4: Add a new set of parameters.
6. Create the New Group “Boarding Group”
Step 1: Navigate back to the Groups page by clicking GROUPS in the left-hand navigation panel.
Step 2: Click the ADD GROUPS button in the upper right-hand corner of the page.
Step 3: Type “Boarding Group” into the Group Name field, then click CREATE GROUP. The new group will appear in your Groups table.
7. Add Parameters to the Boarding Group
Step 1: Click on the Boarding group in the Groups table to open the Group Profile page.
Step 2: Click the PARAMETERS tab on the left-hand side of the profile page.
Step 3: Click the ADD PARAMETER button in the upper right-hand corner of the page.
Step 4: Add a new set of parameters as shown in the Add Parameters page image.
8. Verify Your New Group Parameters
Step 1: Click SETTINGS in the left-hand navigation panel, then click PARAMETERS to open the Parameters page.
Step 2: Verify that no parameter configuration here overrides settings in your "All Merchants" group.
9. Create New Work Flows for each Merchant Group
Step 1: Click Divisions under the Admin category in the left-hand navigation panel.
Step 2: Click the Division listing to open the Division Profile page.
Step 3: Click the Work Flow tab from the Division Profile page menu.
Step 4: Click the ADD Work Flow button in the upper right-hand corner.
Step 5: Select BOARD from the Trigger drop-down menu, then click ADD.
Step 6: Click the new Work Flow ID listed on the menu to open the Work Flow Profile.
Step 7: Click the ADD WORK FLOW ACTION button on the right side of the Work Flow Profile.
Step 8: Select a Merchant Group you’ve created early like associated with the affected Merchants from the drop-down.
Step 9: Select Add or Remove from the Action drop-down. Then, click the Add button to complete the process.
Step 8: Repeat Steps 4-8 for each Merchant Group you’ve created.
10. Select Your Whitelabel Settings
Step 1: Click SETTINGS in the left-hand navigation panel, then click WHITELABEL BRANDING to open the Whitelabel Branding page.
Step 2: Set your desired colors, images, forms, and general branding style format.
11. (Optional): Set Other Parameters
Click SETTINGS in the left-hand navigation panel, then set up fees, billing, and withdrawal settings for each of your new groups.
Tip: Set Specific Parameters for Each Group
Due to the wide range of referrer and merchant business types, it is recommended that you set fee groups, billing groups, and withdrawal settings groups on a per-referrer basis. This reduces missed fee collection opportunities for merchants and referrers whose business models may not trigger a generalized "fee" in all cases.
For more information about setting fees, withdrawals, and billing within a group, visit the Set Up a Group use case.
Next Steps
Once your Facilitator account is set up, review the following guides:
Boarding New Merchants: Board Merchants under your account to begin generating revenue from transaction fees and other setups using the Board a New Merchant use case.
Boarding New Referrers: Board Referrers as vendors of your Portal and Payment Acceptance offering to offer your platform to Merchants on your behalf, using the Board a new Referrer use case.
Conclusion
Once you have finished setting up all the items above on the Platform, your account will be ready to use and begin boarding Referrers and Merchants.
References
Click the links or items below to access any of the following pages: