Create an Approval Rule

Learn more about modifying payment and bank account approval rules

Users in roles with Organization Manage and Review permissions are allowed to modify approval rules. You can configure approvals rules from the Settings page.

All rule modifications (e.g. rule creation, edit, and delete actions) are logged in the Audit Trail. If you modify a rule, only new payments and bank accounts will be affected.

The tabs below contain more information about Payment Order and External Account approval rules.

TAB-Payment Orders

You can set up an approval rule to specify Payment Orders that require human review. For example, you can set up a rule to review large outgoing payments or payments that were created manually in the dashboard. A single approval rule consists of conditions and reviewers.


Conditions

Conditions describe what needs to be true for a review to be required.

You can create one or more conditions, grouped into condition blocks. Within a condition block, conditions are AND'd together. Between condition blocks, conditions are OR'd together.

Each condition is expressed as a field, operator, and value combination. Below are the conditions that can be specified for Payment Order approvals:

FieldOperatorsValues
Amount<, ≤, >, ≥, =, ≠Number (e.g. 1000)
Created Byis in any, is not in anyA list of Users
Creation Sourceis equal to, is not equal to, is in any, is not in anyAPI, Counterparty invitation form, by a User manually, bulk import, sweep
Directionis equal to, is not equal to, is in any, is not in anycredit, debit
Metadatais equal to, is not equal to, contains, does not contain, is missing, is presentKey and value
Payment Typeis equal to, is not equal to, is in any, is not in anyList of payment rails (e.g. ach, wire)
Receiving Account Typeis equal to, is not equal to, is in any, is not in anyinternal_account, external_account
Currencyis equal to, is not equal to, is in any, is not in anyList of currencies (e.g. usd, gbp)

Reviewers

Reviewers describe which Roles, and therefore which user, can take actions. You can specify one or more reviewers. For example, you can specify that you want two users with the Finance role to review. You can even specify conditional logic for reviewers, for example, that you want one user with either the Finance or Administrators Role to review.

Roles must have Accounts Manage, Review, and Edit access in order to review Payment Orders.


TAB-External Accounts

You can set up an approval rule to specify External Accounts that require human review. For example, you can set up a rule to review bank accounts that are created through the dashboard. A single approval rule consists of conditions and reviewers.


Conditions

Conditions describe what needs to be true for a review to be required.

You can create one or more conditions, grouped into condition blocks. Within a condition block, conditions are AND'd together. Between condition blocks, conditions are OR'd together.

Each condition is expressed as a field, operator, and value combination. Below are the conditions that can be specified for External Account approvals:

FieldOperatorsValues
Metadatacontains, does not containKey and value
Created By Useris one of, is not one ofA list of Users
Creation Sourceis equal to, is not equal toAPI, Counterparty invitation form, by a User manually, bulk import
Verified Byis equal to, is not equal toPlaid

Reviewers

Reviewers describe which Roles, and therefore which user, can take actions. You can specify one or more reviewers. For example, you can specify that you want two users with the Finance role to review. You can even specify conditional logic for reviewers, for example, that you want one user with either the Finance or Administrators Role to review.

Roles must have External Accounts Manage and Edit access in order to review External Account.