Skip to main content
Skip table of contents

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:

Click here to view the complete list of new Facilitator tasks.

To begin setting up your account, you must first complete the following tasks:

  1. Conduct a Product Demonstration with the Sales team.

  2. Register with applicable Payment Processors (e.g. WorldPay, Vantiv, Wells Fargo, FirstData, Elavon, Apple, Google, etc.)

  3. Registration with Card Brands (e.g. Mastercard, Visa, Amex, and Discover)

  4. Submit a Copy of your business’s Information Security Policy

  5. Submit the signed Payrix Premium Partner Contract with PCI Attestation of Compliance, and Completed Premium Application documents.

  6. Submit a whitelabel request with your businesses' branding materials (colors, logos, etc.)

  7. Complete a Risk and Due Diligence Review, including the following:

    • OFAC Watchlist Screening - Entity

    • OFAC Watchlist Screening - All Individuals

    • Business Verification - Entity

    • Consumer Verification - All Individuals

    • TIN Validation

    • Secretary of State Lookup

    • Justia search

    • Anti-Money Laundering [AML] Check

Additional Resources


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:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.