---
title: "Set Up Payment Provider Extension EBizCharge in Counter Sales"
app: "Counter Sales"
section: "How-to guides"
last_updated: "2026-07-16"
url: "https://insight-works.com/kb/counter-sales/set-up-payment-provider-extension-ebizcharge-in-counter-sales/"
---

# Set Up Payment Provider Extension EBizCharge in Counter Sales

The following guide covers the prerequisites and steps to set up and use Insight Works’ payment provider integration extension for EBizCharge in Counter Sales.

### Prerequisites

Before you begin, ensure you have the following:

- An active EBizCharge account. Contact [EBizCharge](https://ebizcharge.com/) to obtain one.
- Your API security key (Security ID) provided by EBizCharge.
- Your user credentials (User ID and Password) provided by EBizCharge.
- If using terminals, your terminal key and PIN provided by EBizCharge.
- The EBizCharge Counter Sales Payment Provider app installed in your Business Central environment. If you do not have the app, contact Insight Works to request the file.

### Set up EBizCharge

1. Navigate to the Counter Sales Payment Provider Configurations page in Business Central (see the _[Payment Provider Configurations](/kb/counter-sales/payment-provider-configurations-in-counter-sales/)_ page for more information on setting up and using Payment Provider Configurations).
2. Select **New** and input the following in the _General_ section:

   - Code: A unique name to identify this Payment Provider Configuration (e.g., EBIZCHARGE).
   - Type: Must be set to EBizCharge; if you do not see EBizCharge in the Type dropdown, the Insight Works app is likely not installed.

 Note: You can create multiple configurations for EBizCharge. For example, one for a sandbox environment and one for production, or separate configurations for different store locations. Assign each a different code.

1. Select **Actions** / **EBizCharge** / **Initialize** (populates the configuration with default settings, including the URLs required to communicate with EBizCharge; a confirmation message appears if initialization is successful).
2. Update the _Description_ field as needed (can be done at any time).
3. Locate the _Connection Details_ section and enter the credentials provided by EBizCharge (fields masked for security purposes):

   - API Key: Your EBizCharge security ID or security key.
   - User ID: Your EBizCharge user ID.
   - Password: Your EBizCharge password.
4. Locate the _Payment & Card Details_ section and modify the following field (required to process Counter Sales payments through EBizCharge):

   - Payment Method Code: The payment method code to be applied to the payment line created by each EBizCharge transaction.

 Note: If payment methods are configured in your payment networks, they take priority over this default value.

1. Select **Test Connection** (a confirmation message indicates whether the connection to EBizCharge was successful by using your API Key, User ID, and Password to request your customer list from EBizCharge).

 Note: If the test fails, confirm your credentials are entered correctly. Run the Initialize action again to reset the URL fields to their default values, re-enter your credentials, and test again.

1. Locate the _EBizCharge_section to configure terminal settings (if applicable; masked for security purposes):

   - EBizCharge Terminal Source Key: Provided by EBizCharge.
   - EBizCharge Terminal PIN: Provided by EBizCharge.

 Note: These credentials are separate from your API Key and must be entered before you can populate the terminals list.

1. Load the terminals associated with your EBizCharge account (if applicable):

   1. Select **Related** / **Terminals** (opens the _Counter Sales Payment Provider Terminals_ page for the current configuration).
   2. Select **Refresh** and select **OK** in the confirmation prompt (refreshes the list with your terminals, including each terminal’s name, status, make, model, and serial number as retrieved from EBizCharge).
2. Set the unique EBizCharge identifier code for each network if you are using Payment Networks (optional):

   1. Select **Related** / **Payment Networks** and ensure the Payment Networks list is populated.
   2. Select **Actions** / **EBizCharge** / **Set Identifier Code** and select which area(s) to update.
   3. Select **OK**.

For more information on setting up and using Payment Networks, see the [_Payment Networks_](/kb/counter-sales/payment-networks-in-counter-sales/) page.

### Notes

- For account setup or missing credentials, contact EBizCharge support directly.
- For installation of the Counter Sales Payment Provider integration app, contact Insight Works.
- The EBizCharge integration caches the Payment Provider Configuration settings for each user session to improve performance. If changes are made to the configuration, all users currently logged into Business Central must log out and back in for the updates. Alternatively, users can select **Actions** / **EBizCharge** / **Clear Current Session Configuration**, available on both the list and card pages.

### Payment provider configuration: EBizCharge field reference

The following fields are required for EBizCharge integration. URL fields are automatically populated when you select **Initialize** and do not need to be changed under normal circumstances.

| **Field** | **Required** | **Description** | **Expected / Default Value** |
| --- | --- | --- | --- |
| Code | Mandatory | A unique code to identify this configuration. | User-defined (e.g., EBIZCHARGE) |
| Type | Mandatory | Determines the payment provider used by this configuration. | EBizCharge |
| API Key | Mandatory | Your security ID or security key. | Provided by EBizCharge |
| User Id | Mandatory | Your user ID. | Provided by EBizCharge |
| Password | Mandatory | Your password. | Provided by EBizCharge |
| URL 1 | Mandatory | Service model URL used to communicate with EBizCharge. Set automatically by the Initialize action. | http://eBizCharge.ServiceModel.SOAP/IeBizService |
| URL 2 | Mandatory | Primary SOAP endpoint for EBizCharge. Set automatically by the Initialize action. | https://soap.ebizcharge.net/eBizService.svc |
| URL 3 | Required for card present transactions | Payment engine endpoint used for terminal payment requests. Set automatically by the Initialize action. | https://secure.ebizCharge.com/api/v2/paymentengine/payrequests |
| URL 4 | Required for card present transactions | Payment engine endpoint used for terminal device communication. Set automatically by the Initialize action. | https://secure.ebizCharge.com/api/v2/paymentengine/devices |
| Payment Method Code | Mandatory | The default payment method code applied to the payment line created by an EBizCharge transaction. | User-defined |
| EBizCharge Terminal Source Key | Required for card present transactions | Your terminal source key. | Provided by EBizCharge |
| EBizCharge Terminal PIN | Required for card present transactions | Your terminal PIN. | Provided by EBizCharge |
| EBizCharge Transaction History Time Period | Required for transaction history | Controls the date range used when retrieving transactions on the EBizCharge Transaction History page. Set automatically by the Initialize action. | 30D |
| EBizCharge Transaction History Maximum Results | Required for transaction history | Limits the number of transactions retrieved on the EBizCharge Transaction History page. Set automatically by the Initialize action. | 1000 |

### Payment Networks: EBizCharge Identifier Code reference

The following Identifier Codes are assigned by EBizCharge to each supported payment network. These codes are used to identify the card brand associated with a transaction.

| **Payment Network** | **Moneris Identifier Code** |
| --- | --- |
| Visa | V |
| Mastercard | M |
| American Express | AX |
| Discover | NO |
| Diners Club | NO |
| JCB | J |
