> This page is for Product Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.navipartner.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.navipartner.com/_mcp/server.

# Set up NP Pay reconciliation

> Certain configurations need to be completed in Business Central to make the NP Pay Reconciliation available. In addition to the general setup, you also need to configure webhooks, the general ledger or bank accounts for journal types.

To set up NP Pay Reconciliation Automation in the SaaS environment, make sure the prerequisites are met, and follow the provided steps:

#### Prerequisites

* Retrieve the NP Pay Web Service User credential from NaviPartner.
* Retrieve the NP Pay Report Service User credentials from NaviPartner.

#### Procedure

1. Search for **NP Pay Setup**, and choose the related link.\
   The **NP Pay Setup** administrative section is displayed.
2. Activate the **Enable NP Pay Automation** toggle switch.\
   It creates a common web service for importing NP Pay webhooks and allows you to activate specific integrations such as Pay by Link without adding the reconciliation functionality.
3. Activate the **Enable Reconciliation** toggle switch if you want to handle reconciliation tasks.\
   It creates a job queue for processing reconciliation webhooks and initializes the reconciliation webhook setup if it's missing.
4. Set the **Environment Type** in the **Management** section to either **Test Environment** or **Live/Production Environment** depending on the type of your NP Pay account.
5. Provide the **Management API Key** received from NaviPartner as the Web Service User Credential.\
   The key is automatically validated when the API key is provided. You will receive a warning if the key has expired or if it's been removed.
6. Move on to the **Reconciliation** section, and input the **Download Report API Key** received from NaviPartner as the Report Service User Credential.
7. Specify the number series for creating reconciliation documents in the **Reconciliation Document Nos** field, and specify the number series for posting during the reconciliation process in the **Posting Document Nos**.
8. Specify whether you want the reconciliation lines to be automatically posted after the matching is successfully completed in the background.\
   If you decide to leave automatic posting disabled, you can use the **Reconcile** action instead.
9. Specify whether you want the chargeback-related transactions to be automatically posted or triggered manually.
10. Specify whether you want to post the entries with the **Posting date** being the same as the **Date of Transaction**.
11. Set the **Reconciliation Integration Starting Date** from which the integration will become effective.

![np\_pay\_setup](/_fern-img/28f660fe1f79b6453156db326d49bead62a9d3cb385a358718ce605d51c11c97.webp)

12. Click **Actions** in the ribbon, followed by **Configurations** in the dropdown list, and then click **Upgrade Payment Lines** to mark all payments before the specified date as reconciled.
13. **Enable NP Pay Automation** in the **General** section to create a web service and job queue for processing reconciliation-related webhooks.
14. Give consent for the NP Pay webhook application to access the automation, web service API, and sign by clicking **Create Setup (Admin)** under **Actions/Configurations**.

![np\_pay\_consent](/_fern-img/01216f5d516eeadace08cab33201f65db2b347b092abe2e099345cc78df55ab4.webp)

## Next steps

### Configure webhooks

1. Navigate to the **NP Pay Webhook Setup List** page to configure notifications for new reports.

2. Click **Import Webhooks from NP Pay** to retrieve and create an **NP Pay Webhook Setup Card** for each webhook.

3. Create a **New** webhook, and populate the following fields:
   * **Webhook Type** - select the type based on the required events, e.g. **REPORT_AVAILABLE**
   * **Describe Webhook** - provide a description to ensure easier identification
   * **Web Service URL** - use the **Suggest Web Service URL** option to fill in the link automatically
   * **Active** - specify whether the webhook is enabled or not
   * **Merchant Account** - select the merchant account that will trigger the webhook

4. Send webhook configuration to NP Pay by clicking **Set up a Webhook**.\
   A confirmation message is displayed.

### Set up merchant account

1. Navigate to the **NP Pay Merchant Accounts** page.

2. Select a merchant, and click **Open Setup** in the ribbon.

   ![merchant\_setup](/_fern-img/cf6bfccd7f11482e8a82fd2f599e0a6e1b5465c7117d0329d9f713d7dbb50b4a.webp)

   If no associated **Merchant Account Setup** exists, the system will prompt you to create a new one.

3. Assign the **Posting Source Code**.

4. Create/assign general ledger accounts for all journal types.

   ![np\_pay\_merchant](/_fern-img/41b3d62556442ee78d46bbd4896bf990f753a7c0d47c8a05e1cd46d4b61d2cce.webp)

#### Merchant account setup – multiple payout currencies

The **NP Pay Merchant Account Default Setup**, opened from **NP Pay Setup**, works as the default configuration for reconciliation posting. This setup is applied when no currency-specific configuration is defined.

An action, **Open Merchant Currency Setup**, allows defining additional, currency-specific merchant account configurations.

![open\_merch\_setup](/_fern-files/navipartner.docs.buildwithfern.com/33c3b354bed7fae8c9ecb52fdd781b64283147ee9ac130f51543350742384bc1/products/product/assets/np_pay/how-to/reconciliation/open_merch_setup.png)

Using **Merchant Currency Setup**, it is possible to specify a separate **Reconciliation Account Type** and **Account No.** per currency that exists in Business Central. These settings are maintained per merchant, allowing different merchants to have different account mappings for the same currency.

![merchant\_acc\_setup](/_fern-img/b90e37e33a52af0b6bbfa02e7dac9dff40ee86be57c5fdaded5121e15487b330.webp)

During reconciliation posting, the system applies the following logic:

1. It first looks for a matching combination of **Merchant Account Name + Currency Code + Reconciliation Account Type** in the Merchant Currency Setup.
2. If no matching record is found, the system falls back to the **Default Merchant Account Setup**.

This gives full flexibility to the user: specific accounts can be configured only for selected reconciliation transaction types and currencies, while all remaining postings continue to use the default setup.

**Example**

A merchant processes transactions in **DKK** and **EUR**, where **DKK** is the LCY.

* The **Default Setup** is used for posting DKK transactions.
* For EUR transactions, the user creates Merchant Currency Setup lines for the required Reconciliation Account Types with **Currency Code = EUR**.
* As a result, EUR transactions are posted to the accounts defined in the Merchant Currency Setup, while DKK transactions continue to use the Default Setup.

It is also possible to fully replace the Default Setup by defining Merchant Currency Setup lines for all required currencies and reconciliation account types, including the LCY (for example, setting DKK as the NP Pay Currency Code).

However, the recommended approach is to keep the Default Setup filled for the LCY and use Merchant Currency Setup only for additional currencies.

### Perform reconciliation

Once you're done setting up NP Pay reconciliation, you can perform it by following the steps provided in [<ins>this guide</ins>](/product/np-pay-perform-reconciliation).