A new fee model is detached by default and not linked to anything. When you create a new fee model, you also must link it to an organization, program, or an account. Otherwise, it will not be applied. Only one fee model can be applied to an organization, program, or account at a time.

You can link a fee model at the following levels of detail:

• Organization level—Link to all accounts in your organization, regardless of which program contains the account. For details on the corresponding API endpoint, refer to Attach fee model to org.
• Program level—Link to all accounts within a specific program. For details on the corresponding API endpoint, refer to Attach fee model to program.
• Account level—Link to selected accounts, regardless of which program they are in. This type of link cannot be done through the Control Center. For details on the corresponding API endpoint, refer to Attach fee model to account.

In addition, you can optionally link a fee model with one or more platform operations, such as a credit transaction using one or more processing codes.

You can find sample payloads for each fee model type in the Create fee model endpoint.

📘

You can't use Control Center to attach fee models to accounts. To do this, you must use the endpoint Attach fee model to account.

Note that these levels are hierarchical — for any operation performed on an account, the platform applies the most specific fee model, starting with the account level.

Link a fee model to an organization

Every organization on the platform is linked to a default fee model. This model is used whenever a platform operation requires a fee model but none is linked at the account or program level.

To attach a different fee model to an organization:

1. From the main menu, select Configurations > Fee models.
2. Select the fee model you want to link.
3. On the Fee Model Details screen, open the Association type tab and select Associate to organization.
4. In the confirmation dialog, select Yes then select Next to review.
5. On the Review screen, verify your changes and select Finish.

Link a fee model to a program

You can link fee model to multiple programs at a time but only one fee model to each program.

To attach a fee model to one or more programs:

1. From the main menu, select Configurations > Fee models.
2. Select the fee model you want to attach.
3. On the Fee Model Details screen, open the Association type tab and select Associate programs.
4. On the Associate a program screen, for each program that you want to link, select its Add button then select Next to review.
5. On the Review screen, verify your changes and select Finish.

Link a fee model with platform operations

Optionally, you can link a fee model with one or more platform operations, such as a credit transaction. To do this, link one or more processing codes to the fee model. In cases where no charges are applied, simply do not include a processing code.

To link a fee model with platform operations:

1. From the main menu, select Configurations > Fee models.
2. On the Fee model details screen, select the fee model you want to link and then select Edit.
3. On the Processing code screen, select each processing code you want to link and select Next to review.
4. On the Review screen, verify your changes and select Finish.