Skip to main content
Skip table of contents

Entity Management

Effective entity management is essential for partners to streamline operations and enhance onboarding. This article explores various entity types in the Payrix ecosystem, such as Facilitators, Referrers, and Merchants, along with their hierarchical interactions and other key entity terms.

Understanding these elements is crucial for successful merchant onboarding and payment facilitation services. Knowing various entity types and processes enables partners to customize solutions with control over capabilities, fees, billing, automated risk decisions, white label customization, onboarding workflows, secure URL redirection hosting, and more, enhancing portfolio management and streamlining operations.

Note

Some terms will only apply at a Facilitator level and may not be available to Referrers and below. To request updates to your Division, Host, or Workflow configuration as a Payrix Pro Partner, submit an Implementation ticket.

Entity Types

These entity types represent the types of business entities that interact with the Payrix platform either directly or through a white labeled offering:

  • Facilitator: A payment facilitator offering products and capabilities of the Worldpay platform to their Payment Facilitation-as-a-Service partners, assuming all risk and underwriting liabilities as a payment facilitation business.

  • Referrer: A Payrix Pro partner, offering Merchants the products and capabilities available through the platform as a white labeled referral of Payment Facilitation-as-a-Service offered through Payrix.

  • Merchant: A business successfully boarded to the platform through a Referrer to accept payment transactions for products and services sold to customers.

Tip

Schedule a demo with our sales team to explore the Payrix platform and learn how to get started as a Payrix Pro partner.

Entity Hierarchy

To illustrate the complex relationships among Facilitators, Referrers, and Merchants, this flow diagram provides a clear and detailed representation of the entity hierarchy within the platform ecosystem:

Entity Management Terms

These are technical terms used by the Payrix platform to describe logical groupings of various processes, entities, and their relevant portfolio data:

  • Partition: A representation of a Facilitator’s portfolio on the Payrix platform, housing all Referrers, Merchants, and Users data, Host settings, and other platform-wide settings. Partitions can be further divided into Divisions, to create strategic separations for individual Referrer portfolios within.

  • Division: A representation of a Referrer’s portfolio contained within a Payrix Partition or the Partition of another Facilitator-level entity that contains all Merchant and User data, Host settings, and Workflows within and can be modified on an individual basis without affecting other Divisions or Merchants under a Partition.

  • Host: A configuration of white label branding configurations and platform-wide settings that can be applied at a Partition and Division level.

  • Group: A collection of Referrer or Merchant entities that assign the same configurations for fees, billing, risk decisions, withdrawal flows, and other parameters that automatically apply to all entities within.

  • Workflow: An automated process configuration that assigns new Merchants to an existing Group when they submit a completed Signup Form hosted under a Partition or Division.

Blank diagram (2).png

Entity User Login Capabilities

Users from each entity can log in to their respective portal accounts and perform actions based on their roles and access granted via Teams. Higher-level entities can access the accounts and portal views for their boarded entities unless manually restricted. For example, a Referrer-level user can typically log into and view their Merchants' accounts in the portal.

Note

In common scenarios where one Merchant needs to log in to another Merchant as a result of multiple locations under the same business, a Multi-Location Merchant Structure is required. See Multi-Location Merchant Structure for more information about multi-location structure setups.

Learn more about each of the Entity Management terms above by visiting their respective pages below:

JavaScript errors detected

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

If this problem persists, please contact our support.