---
title: Reconciliation Rules
slug: reconciliation-rules
createdAt: 2024-07-17T23:35:00.875Z
---

This feature allows you to specify the criteria for accepting incoming NPP and DE payments, by specifying the exact amount you expect to receive to an virtual account number or PayID in an agreed timeframe.&#x20;
When a payment is recieved it is evaluated against the reconciliation rules you have set up for the account, and returned if it doesn't meet an active rule.

Inbound transactions will only be accepted if:

- BSB, Account Number, and amount matches an active reconciliation rule; OR
- PayID and amount match an active reconciliation rule

There are two types of reconciliation rules:

- Smart reconciliation rules, which reject underpayments and refund the excess amount from overpayments. Once a payment is accepted using a smart reconciliation rule, the rule immediately expires.&#x20;
- General reconciliation rules, which only accept the exact amount specified and reject overpayments or underpayments.

Smart reconciliation rules differ from general reconciliation rules in that only one may be set up at a time per account number or PayID, whereas multiple general reconciliation rules for different values can be set up simultaneously on a single account number or PayID.&#x20;

An optional Expiry Date Time can be specified for each rule. If expiry date is not provided, this will be defaulted as per a pre-decided setup.

## Managing Reconciliation Rules

You can query an active reconciliation rule by ID, or request a list of all active rules by date. If a reconciliation rule is no longer required you can cancel it using the [Cancel Reconciliation Rule](docId\:RnWONpbLq7eC7dYAmjdg4) endpoint.
