Guides
/
Integration guides
/
Board a merchant

Board a merchant

To board a merchant with Payroc, you need to create the following resources:
  • Merchant platform – The business and its legal information, its owners, and its processing accounts.
  • Processing accounts – Each merchant platform must include one or more processing accounts that run transactions.
  • Owners – Each processing account must include one or more owners. You must assign a control prong who is responsible for their merchant account.
  • Contacts – Each processing account can include additional contacts. They are individuals we can contact about the processing account, for example, a store manager.
When you create a merchant platform, we recommend that you add all the business's processing accounts. If the business expands after you board a merchant, you can add additional processing accounts and their contacts.

Relationship between the boarding resources

The merchant platform is the main boarding resource and includes all the information about the business, including its legal information, processing accounts, owners, and contacts. The following diagram shows the relationship between the boarding resources:

Example

The following example shows a merchant platform with two processing accounts:
  • Springfield processing account has one owner and two contacts.
  • Boston processing account has two owners and one contact.

Pricing

When you add a processing account to a merchant platform, you must provide the pricing model. Assign one of the following pricing models in the pricing object:
  • Pricing intent - Create a pricing intent and provide its ID in the pricingIntentId parameter.
  • Pricing agreement - Enter the details for the pricing model including the base fees, processor fees, and gateway fees.

Your integration journey

After you board the merchant we review their information and approve their account to process transactions.
  1. (Optional) Create a pricing intent.
  2. Create a merchant platform.
When you create a merchant platform, you must enter the unique tax ID of the business.
If you need to add more processing accounts, you can add these after you create the merchant platform.
  • Create a processing account.
  • Add an owner.
  • Add a contact.

Guides

Create a pricing intent

Create a template of fees that you can apply to processing accounts.

Create a merchant platform

Create a resource for the business.

Add a processing account to a merchant platform

Create processing accounts that run transactions.