ePay User Guide
On This Page
Questions about a step? Contact support.
ePay User Guide
This guide shows you how to set up and navigate the ePay extension, Dynamics eShop’s all-in-one payment solution for Dynamics 365 Business Central — from licensing and installation, through gateway credentials and setup card configuration, to the everyday operations of authorizing, capturing, voiding and refunding funds.
📋 How to use this guide
- For a fresh installation, follow this document in order so no intermediate setup is missed.
- For a specific task later on, jump to the relevant section from the contents list.
- For support specific to your implementation, contact support@dynamicseshop.com or your project manager.
1. Introduction
ePay offers PCI-compliant payment processing integrated with the CardConnect and Authorize.net payment gateways. You can use it to manually authorize or charge funds for orders, and to automate customer payment at different stages of the ordering process.
From within Business Central you can manage customer payment profiles, dictate when and how incoming orders are charged, and maintain accurate cash receipt journals for every transaction. Where ePay is purchased alongside Dynamics eShop’s B2B/B2C ecommerce solutions, ePay and its sub-products eShop Pay, Bill Pay and Email Pay can take on the payment processing side of Sales and Accounts Receivable.
2. Licensing
Dynamics eShop maintains a licensing system for all of its products, including ePay. If your license is found to be invalid or expired you may lose access to the ePay extension and its functionality within Business Central and any connected ecommerce websites.
Follow these steps to gather the information Dynamics eShop needs in order to activate your ePay license.
1) In Business Central, select the ? help icon. In the Help pane on the right, choose Help & Support, then select Inspect pages and data from the menu in the centre.
2) Once the Page Inspection pane loads on the right, select the icon, then search for and choose Companies. Find and highlight the Business Central company you will use ePay in, then copy the full Id shown under Page Inspection.
3) Send the details for your deployment type to support@dynamicseshop.com or your Dynamics eShop project manager:
| Deployment | What to send |
|---|---|
| Cloud Business Central | Your organisation’s Microsoft Azure tenant ID, the Business Central environment name, and the Business Central company Id. |
| On-premises Business Central | The Business Central server address and the Business Central company name or Id where ePay will be used. |
⚠️ Wait for confirmation
Dynamics eShop support or your project manager will respond once your subscription has been activated. Installation can continue in the meantime, but the license must be registered before ePay will work.
3. Installing the ePay Extension and Registering the License
⚠️ Permissions required
To install an extension, the user must be a member of the D365 Extension Mgt user group or hold the EXTEND. MGT. – ADMIN permission set.
1) At the top of Business Central, select the search icon, then search for and open Extension Marketplace.
2) Use the search bar to find the ePay Credit Card & ACH Payments extension published by Dynamics eShop Inc. Select Free trial on the AppSource page, and again in the pop-up.
⚠️ This step interrupts other users
Installing the extension forces Business Central users to close the pages and reports they are on and redirects them to the home page. Plan the installation accordingly.
3) Select Install to begin. When installation finishes you receive a confirmation message and a prompt to refresh Business Central.
4) Select the search bar and start typing ePay License until you can choose ePay License Registry.
5) On the ePay License Registry screen, select Get Active Licenses.
📝 License expired?
Contact support@dynamicseshop.com or your Dynamics eShop project manager.
4. Permissions and Role Setup
4.1 User permissions for ePay
Once ePay is installed and licensed, permission sets dictate how Business Central users can interact with it. The three sets are listed below from highest to lowest privilege:
| Permission Set | What it allows |
|---|---|
| ESHOP-EPAY PS | Edit the ePay setup card and perform all other ePay processes. |
| ESHOP-EPAY EDIT PS | Manage ePay profiles, authorize, charge and void. Cannot edit the ePay setup. |
| ESHOP-EPAY READ PS | Read-only access to ePay tables such as profiles and transactions. |
⚠️ Administrator task
The steps below should be completed by a Business Central administrator.
1) Search for Users and select a user name to open the User Card.
2) Scroll to the User Permission Sets table and insert the relevant ePay permission set.
3) Specify the Business Central company the permission applies to, or leave it blank to apply it across the entire environment.
4.2 User roles and the ePay Dashboard
The following Business Central roles can view the ePay Dashboard, which gives a quick reference for ePay profiles and credit card authorizations that are expiring or expired:
| Role | Role | Role |
|---|---|---|
| Accountant | Accounting Manager | Accounts Payable Coordinator |
| Accounts Receivable Administrator | Outsourced Accounting Manager | Sales Order Processor |
| Sales and Relationship Manager | Sales Manager | Finance (FIN) |
| IT Manager | System Admin | Inventory Manager |
| Warehouse | Warehouse Worker | Shipping & Receiving |
Two dashboard tiles are updated by a job queue that polls the connected payment gateway:
| Tile | What it shows |
|---|---|
| Expired Credit Cards | Selecting the tile opens a filtered view of expired ePay profiles. |
| Expired Authorizations | Selecting the tile opens the authorizations that have expired. |
5. Merchant Onboarding
5.1 New merchant application
Contact accounting@dynamicseshop.com to request the merchant application for your new payment gateway. Include your company name and the email address of the person who will sign the application.
5.2 Onboarding process
Once the merchant process has been initiated, work with the gateway and Dynamics eShop to complete the application and get the account live.
5.3 Creating gateway credentials
With the merchant account live, generate the integration credentials that connect the payment gateway to Business Central.
5.3.1 Credentials for CardPointe
- Open the CardPointe portal and go to Administration, then Credentials. If you cannot see Credentials, you are not signed in with an admin account.
- Choose the account the credentials should be linked to and select + Create Credentials.
- Select the company again, enter a friendly name (for example DeSePayLive) and choose Generate Password.
- Note down the MID, the Username (used as the API Token) and the Password (used as the API Key). The URL is
https://fts.cardconnect.com.
⚠️ Keep these secure
These values populate the ePay Setup Card in the next section. Treat them as production secrets.
5.3.2 Credentials for Authorize.net
- Open the Authorize.net portal and go to Account. Select Settings on the left, then API Credentials & Keys under Security Settings → General Security Settings.
- Note down the API Login ID. This is used as both the Identifier ID and the API Token.
- Select New Transaction Key and submit. Authorize.net asks you to verify your identity with a PIN before creating the key.
- Note down the new Transaction Key, which is used as the API Key. The URL is
https://api.authorize.net/xml/v1/request.api.
6. ePay Setup Card
In Business Central, search for ePay and confirm that ePay Setup appears, then select it.
6.1 Gateway settings
These fields establish the connection between the ePay extension and your payment gateway. Dynamics eShop can provide test credentials until your merchant application has been processed.
⚠️ Switching from test to live
Once merchant onboarding is complete, confirm the correct GateWay is selected — transaction reference numbers and token IDs generate differently in CardConnect/CardPointe than in Authorize.net. The URL, API Token and API Key fields also change to your live credentials. See section 5.3 for retrieving them from your merchant portal.
| Field Name | Functionality |
|---|---|
| General > GateWay | Selects the corresponding merchant provider. |
| Identifier ID | Unique ID identifying you to the gateway. |
| URL | The URL used to connect to the gateway. |
| API Token | The token for the API integration. |
| API Key | The key for the API integration. |
Credit card fields
ACH fields
Once configured, select Test Connection in the top bar and choose Credit Card or ACH depending on what your business uses. You should see a Success response from the gateway; if not, contact your IT department or the ePay team.
6.2 Functional settings
| Field Name | Functionality |
|---|---|
| Convenience/Additional Processing Fee | Establishes whether a convenience fee applies. Credit card only. Can be a percentage or a flat amount depending on the adjacent Is Percentage toggle. |
| Payment Journal Batch, Sales Journal Template, Sales Journal Batch for CC/ACH | Required for automations such as automatic posting to cash receipt journals and general ledgering of payment information. Your accounting team or Business Central partner will typically configure these to fit your existing sales and accounting workflows. |
Credit card functional settings
ACH functional settings
6.3 Automations
Below the General, Credit Card and ACH settings you will find the Automation section. These settings determine at what point in an order ePay attempts to authorize or charge funds, and whether customers are emailed a receipt. Since different business models warrant different timing, enable only those relevant to your own sales and accounting workflow.
📝 Payment profile hierarchy
Automations require an ePay-enabled Payment Method Code on the order, and use this hierarchy of payment profiles when attempting to authorize or charge funds:
- An ePay Account Reference specified on a sales order overrides the customer’s default profile for that order only.
- If there is no account reference, the ePay Profile ID used in the previous authorization or charge on the order is used.
- If neither exists, the Default ePay Profile on the customer card is used.
If the Payment Method Code is missing or invalid, or none of the profile options are satisfied, ePay displays a detailed error message showing which fields need input.
| Field Name | Functionality |
|---|---|
| Auto Authorize while Release | Automatically authorizes sales orders with ePay on release. See section 8.2.2. |
| Auto Capture while Posting | Automatically captures funds when a sales order or invoice is posted with ePay. See section 8.3.2. |
| Auto Close Invoice with Email Pay | Automatically closes an invoice in Email Pay (a paid add-on — contact sales@dynamicseshop.com). |
| Retrieve Transaction while Release Only | Retrieves the transaction into Business Central as the order is released. If cleared, the transaction is retrieved while validating the Your Ref Number. Recommended off. |
| Enable E-Mail Receipts | Should be off during initial implementation and testing. Emails receipts to customers automatically when funds are captured. Requires an email account set up in Business Central. |
| Cash Receipts Enabled | Creates cash receipts automatically in the cash receipts journal when funds are captured. Pairs with Post Cash Rcpts While Capture. |
| Post Cash Rcpts While Capture | Posts cash receipt journal lines automatically while funds are captured. Pairs with Cash Receipts Enabled. |
| Re-Auth & Capture While Shipping Partially | Allows orders to be partially shipped and paid for. Orders are re-authorized and captured for the partial amount when shipped. |
6.4 Email Pay
These fields are specific to Email Pay, a paid add-on to the standard ePay extension that sends automated payment request emails and accepts payment via a secure link. To add it to your solution, contact sales@dynamicseshop.com; see the separate Email Pay User Guide for full details.
| Field Name | Functionality |
|---|---|
| E-Mail Pay URL | The URL provided by eShop to connect to the Email Pay service. |
| Invoice Email Pay Request Template | Selects a different template for posted sales invoices that have not passed their due date. |
| Order Email Pay Template | Selects a different template for sales orders. |
| Invoice Email Pay Attachment Template | Selects the report layout attached to payment requests sent on posted sales invoices. |
| Overdue Email Pay Template | Selects a different template for posted sales invoices past their due date. |
| Order Email Pay Attachment Template | Selects the report layout attached to payment requests sent on sales orders. |
| Duration For Payment Reminders | The time in days that must elapse before another payment request is sent. |
| Default Send-to-Email | Selects whether the request goes to the Bill-To email on the customer card or the email on the posted sales invoice. |
| First Payment Request based on Due Date | The number of days before or after the invoice due date that the first payment request is sent. |
7. Payment Method Configuration for ePay
Marking a payment method as ePay Payment Method enabled allows ePay functionality to work on sales orders using that payment method’s code. Any sales order with a payment method code that is not ePay-enabled has no access to ePay functionality.
📝 Posted sales invoices are different
This restriction does not apply to posted sales invoices — an invoice works with ePay regardless of payment method code, relying instead on whether the customer has a valid ePay profile.
It is also worth using an ePay-enabled payment method on customer accounts that are not on terms, so the automations can confirm a card is on file when processing a sales order.
1) In Business Central, search for Payment Method and select Payment Methods.
2) Select the ePay Payment Method box for every payment method to be used by ePay, and confirm the changes saved in the top right.
3) For payments requiring authorization before release, enable ePay Requires Auth Before Release. See the example in section 8.2.5.
⚠️ Precursor required
This toggle requires ePay Payment Method to be enabled on that payment method first.
4) To capture funds in full when items leave your warehouse, enable ePay Auto Captures while Shipping for the payment method used on the order. You can also enable ePay Requires Capture to Post Shipment to verify funds are captured before a warehouse shipment can be posted. See the example in section 8.2.4.
| Field Name | Functionality |
|---|---|
| ePay Payment Method | Makes the payment method ePay applicable. When enabled, all ePay functionality is available for orders using this code. |
| ePay Requires Authorization before Release | Requires funds to be authorized before any shipment of product is released. Requires ePay Payment Method as a precursor. |
| ePay Auto Captures while Shipping | Automatically captures funds (and authorizes them if not already authorized) when a warehouse shipment is posted for a sales order. ePay follows the payment profile hierarchy in section 6.3, and displays an error if none of the options can be used. Requires ePay Payment Method as a precursor. |
| ePay Requires Capture to Post Shipment | Checks that funds were captured successfully before the warehouse shipment can be posted — a safeguard against shipping unpaid items. Requires ePay Auto Captures while Shipping as a precursor. |
8. Everyday Operations
8.1 Managing customer profiles
8.1.1 Creating an ePay customer profile
- In Business Central, open the Customers list.
- Find the customer and select the Customer No. to open the Customer Card.
- Select ePay on the action pane, then Profiles to display all of the customer’s ePay profiles.
- Select New.
📝 Gateway differences
The example below is for CardPointe. Other merchant gateways may look different.
For credit cards: complete the required information and save.
For ACH: enable the ACH button, complete the required information and save.
📝 Default profiles
If Default was enabled, that payment profile becomes the default for payments on that customer.
ePay profile list fields
| Field Name | Functionality |
|---|---|
| Default | A visual check showing which profile is set as default. |
| Profile ID | The corresponding ID from the payment gateway. |
| Identifier ID | The merchant code from the payment gateway. |
| Account ID | Differentiates between multiple profiles on one customer. |
| Type | The payment type — credit card or ACH. |
| Account No | Stores only the last four digits of the card. |
| Token | The unique token associated with the card information stored in the payment gateway. |
8.1.2 Updating a customer profile
- Navigate to the customer’s ePay profiles (see section 8.1.1).
- Find the profile to edit — the arrow shows which profile is selected.
- Select Manage, then Edit.
- Edit the necessary fields, then select Update Profile or confirm the changes saved in the top right.
Profile card actions
| Action | Functionality |
|---|---|
| New | Creates a new ePay customer profile with the information entered. |
| Update Profile | Updates the customer profile card. |
| Transactions | Shows the transactions associated with that profile card. |
| Make Default | Makes the profile card the default. |
| Remove Default | Removes the profile card as the default. |
| Delete Profile | Deletes the ePay profile. |
8.1.3 Making a customer profile the default
- Navigate to the customer’s ePay profiles.
- Select the profile you want as default and choose Make Default. Verify that the profile now has a checked Default box.
- To remove a default, select the profile and choose Remove Default. Verify the box is no longer checked.
8.1.4 Setting a non-default profile for a particular order
Besides the default profile, you can set an ePay Account Reference on a specific sales order. That profile is then used for the remainder of the process on that order only.
- Navigate to or create an open sales order.
- Scroll to the Invoice Details section and select ••• next to ePay Account Reference.
- Select or create an ePay profile to be used in subsequent automations on this order, then select OK.
8.2 Authorizing and capturing a sales order
8.2.1 Authorizing a sales order manually
⚠️ Credit card only
ACH does not allow authorization at the sales order level. ACH funds can only be captured at the posted sales invoice level.
- Sign in to Business Central with your admin account.
- Select Sales, then Sales Orders, and choose the order number to authorize.
- Select ePay, then Authorize.
- Select the existing payment profile or enter new card details. If a default profile exists it is selected automatically.
- Select Submit once all information is added.
📝 Convenience fee
The convenience fee established on the ePay Setup Card is applied and added to the total amount. The fee remains editable for flexibility.
Payment card fields
| Field Name | Functionality |
|---|---|
| Total Amount | The sales order total plus the convenience fee. |
| Convenience/Additional | The convenience fee from the ePay Setup Card applied against the sales order total. |
| Select Existing Profile | Selects a saved customer payment profile (see section 8.1). |
| New Card/ACH Details | Details for a new card or ACH account. Selecting Save Profile stores them as a new customer payment profile. |
8.2.2 Authorizing a sales order automatically
⚠️ Credit card only
As above, ACH cannot be authorized at the sales order level.
- Search for ePay and select ePay Setup.
- Under Automation, enable Auto Authorize while Release.
- Release an order to have it authorize automatically. Make sure the customer has a default profile for the authorization to use.
📝 Interaction with payment method settings
If ePay Requires Auth Before Release is enabled on the payment method, authorization is still required before any release. That authorization can happen automatically when Auto Authorize while Release is on and the customer has a default profile.
8.2.3 Capturing a sales order
- Complete the authorization in section 8.2.1 first — it is required to capture at the sales order level.
- Select ePay, then Transactions.
- Select the authorization line, choose Capture and confirm with Yes.
The sales order has now captured prepayment.
8.2.4 Capturing a sales order automatically when items ship
- Create a sales order (see section 8.2.1) using a payment method with ePay Auto Captures while Shipping and ePay Requires Capture to Post Shipment enabled (see section 7).
- Authorize the funds manually (section 8.2.1) or automatically (section 8.2.2).
- Create the warehouse shipment, then Create Pick. Open the pick line from Shipment → Pick Lines, then Register Pick. Back on the warehouse shipment, select Post, choose Ship and confirm.
- Back on the sales order, confirm in the info panel that ePay has authorized and captured the funds. Transaction details and reference numbers are under ePay → Transactions.
📝 Warehousing varies
Step 3 may differ depending on your organisation’s Business Central warehousing process. The result of that step should be a posted sales shipment; the instructions above follow the standard Business Central process.
8.2.5 Reauthorizing sales orders
⚠️ Authorize first, then void
Reauthorization requires a completed authorization from section 8.2.1 or 8.2.2. Selecting Authorize again without voiding the existing authorization produces the message shown below.
- Open the sales order card (see section 8.2.1).
- Select ePay, then Transactions.
- Select the authorized payment — the arrow denotes the selected line.
- Select Void.
- Return using the arrow at the top left, then select Authorize and follow steps 3–5 in section 8.2.1.
📝 Automatic reauthorization
If ePay Requires Authorization Before Release is enabled on the payment method, ePay attempts to reauthorize automatically using this hierarchy:
- ePay Account Reference specified on the sales order.
- Profile ID on the previous authorization line.
- Default ePay profile on the customer card.
8.2.6 Multiple captures on a sales order
- Open the sales order card (see section 8.2.1).
- Capture a transaction for the order (see section 8.2.3).
- Add a new sales line, or edit the existing one.
- Repeat the authorize and capture process.
📝 Voiding
To void an authorized transaction, see section 8.9.
8.2.7 Declined authorizations and captures
If ePay returns any response code other than Successful, the details the payment gateway provides about the card issue are saved to the ePay Transaction List.
The unfiltered ePay Transaction List can be opened from the search button anywhere in Business Central. From a sales order or posted sales invoice, ePay → Transactions shows only that document’s transactions.
8.3 Processing a sales invoice
Sales orders may or may not have been authorized already; funds can be captured either way. To check before invoicing, open the ePay transaction list, which shows whether the order has been authorized and/or captured.
8.3.1 Processing a sales invoice manually
- In Business Central, select Sales, then Sales Orders, and choose the order number.
- Select Home, then Post, and choose either Invoice or Ship & Invoice.
- Open the resulting posted sales invoice. Select ePay, then Charge. Enter the payment information and select Submit (see section 8.2.1 for help).
⚠️ Authorization may be required first
If ePay Requires Authorization before Release is enabled for the payment method and no authorization exists, an error appears stating that authorization is needed. Authorize the sales order to proceed (see sections 8.2.1 and 8.2.2).
The posted sales invoice is now processed, and closed if Cash Receipts Enabled and Post Cash Rcpts While Capture are on. Funds are authorized and captured.
8.3.2 Processing a sales invoice automatically
This method requires Auto Capture while Posting to be enabled in the Automation section of the ePay Setup Card (see section 6.3).
- In Business Central, select Sales, then Sales Orders, and choose the order number.
- Select Posting, then Post, and choose either Invoice or Ship & Invoice.
- Open the posted sales invoice — funds should already be authorized and captured. View the detail in the ePay transaction list.
📝 Invoice closure
With Cash Receipts Enabled and Post Cash Rcpts While Capture enabled on the ePay Setup Card, the sales invoice is closed automatically.
8.4 Charging a posted sales invoice
This section applies only to posted sales invoices whose funds have not already been authorized and captured.
8.4.1 For credit card
- In Business Central, search for Posted Sales Invoice and select the number to charge.
- Select ePay, then Charge.
- Enter the payment information and select Submit. Note the convenience fee from the ePay Setup Card is added.
The posted sales invoice now has its funds authorized and captured.
8.4.2 For ACH
- In Business Central, search for Posted Sales Invoice and select the number to charge.
- Select ePay, then Charge.
- Enter the payment information and select Submit. Note that the convenience fee is removed for ACH.
The posted sales invoice now has its funds captured.
📝 Refunds
To refund an authorized and captured transaction, see section 8.9.
8.5 Authorizing a service order
- In Business Central, search for Service Orders and select the number to authorize.
- Make sure the service order status is Finished, then select Release and Release to Ship.
- If Auto Authorize while Release is disabled on the ePay Setup Card, authorize manually: select ePay, then Authorize, and submit the payment (see section 8.2.1).
- Select Posting, then Post, and choose the posting option.
📝 Automatic authorization
If Auto Authorize while Release is enabled on the ePay Setup Card and a payment method code is selected, step 3 is already done. Verify by selecting ePay → Transactions.
The service order should now be a posted service invoice.
8.6 Authorizing a service invoice
- In Business Central, search for Service Invoices and select the number to authorize.
- Select ePay, then Authorize.
- Enter the payment information and select Submit.
- Post the now-authorized service invoice: select Approve, then Post.
8.7 Charging a posted service invoice
This section applies only to posted service invoices whose funds have not been authorized and captured.
- In Business Central, search for Posted Service Invoices and select the number to charge.
- Select ePay, then Charge.
- Enter the payment information and select Submit. Note the convenience fee from the ePay Setup Card is added.
- Select ePay, then Transactions, and verify the funds were authorized and captured.
8.8 Charging funds from a cash receipt journal
- In Business Central, search for Cash Receipt Journals.
- Select the appropriate batch name.
- Select the account number for the customer and set Document Type to Payment.
- Copy the Document No., then select Process and Apply Entries.
- Paste the document number into the Applies-to ID field for every applicable posted sales invoice, then select OK.
- Select ePay, then Charge. Enter the payment information and select Submit.
- Repeat for any other lines in the batch.
- Select Post/Print, then Post.
The journal lines are now posted and the customer’s account balance reflects the payment. Verify this on the customer card — the balance should show the change, and ePay → Transactions displays the record.
8.9 Voiding or refunding an authorization or capture
8.9.1 Voiding an authorization transaction
⚠️ Captured funds cannot be voided
If the authorization line has already been captured, the funds can no longer be voided and must be refunded instead — see section 8.9.2.
- Open the document whose authorization needs voiding.
- Select ePay, then Transactions.
- Select the authorization line. Where there are several, find the live one with a status of Approval that has neither Captured nor Voided checked.
- Select Void. A new line appears with a transaction type of Void.
The authorization has now been voided. To reauthorize the sales order, see section 8.2.5.
8.9.2 Refunding a capture transaction
- Open the document whose capture needs refunding — a sales order, prepayment invoice or posted sales invoice.
- Select ePay, then Transactions.
- Select the capture transaction line, then Refund.
- In the pop-up, choose Full Refund and select OK.
📝 What happens next
On a posted sales invoice with Cash Receipts Enabled, an opposing cash receipt entry is posted and the invoice is left open to be captured and closed again. See sections 8.2.3 and 8.4 for capturing funds again.
8.9.3 Partially refunding a capture transaction
- Open the document whose capture needs partially refunding.
- Select ePay, then Transactions.
- Select the capture transaction line, then Refund.
- In the pop-up, choose Partial Refund and select OK.
- Specify the amount to refund and select Submit.
📝 What happens next
On a posted sales invoice, an opposing refund cash receipt entry is posted against the payment and the invoice is left open to be captured and closed again. See sections 8.2.3 and 8.4.
📝 Need help?
For support specific to your implementation of ePay, contact support@dynamicseshop.com, your project manager, or the Support Portal.