ePay User Guide
- Introduction
- Licensing
- Installing the ePay Extension & license registration
- Permissions & Role Setup
- Merchant Onboarding
- ePay Setup card
- Payment Method Configuration for ePay
- Everyday Operations
- Managing Customer Profiles (Create, Update & Make Default)
- How to authorize/capture a sales order
- How to process a Sales Invoice
- How to charge (Authorize & Capture) on a Posted Sales Invoice
- How to authorize a Service Order
- How to authorize a Service Invoice
- How to charge (Authorize & Capture) Posted Service Invoice
- How to charge/capture funds from a Cash Receipt Journal
- How to Void or Refund an Authorize/Capture
1.Introduction
This guide will show you how to set up and navigate the ePay extension, Dynamics eShop’s all-in-one payment solution for Dynamics 365 Business Central. ePay offers PCI-compliant payment processing integrated with the CardConnect and Authorize.net payment gateways. ePay can be used to manually authorize or charge funds for orders as well as automate customer payment at different stages in the ordering process. From within Business Central, you can manage customer payment profiles, dictate when and how your incoming orders are charged, and maintain accurate cash receipt journals for all transactions. If ePay was purchased in addition to/alongside Dynamics eShop’s B2B/B2C ecommerce solutions, ePay and its subproducts eShop Pay, Bill Pay and Email Pay can alleviate the payment processing aspects of Sales and Accounts Receivable.
For a fresh ePay installation, this document should be followed chronologically to avoid any missing intermediate setups. For review of specific functionalities/setups later on, refer to the Table of Contents for the business process you wish to see with ePay. In case you require additional support or have concerns specific to your implementation of ePay, please contact support@dynamicseshop.com or your project manager for assistance.
2.Licensing
Dynamics eShop maintains a licensing system for all the product offerings including ePay. If at any time your license is found to be invalid or expired, you may lose access to the ePay extension and its functionality within your Business Central environment and any connected ecommerce website(s). Below are the steps to get the information needed to the DES personnel in order to activate your ePay license in Business Central.
1) In your Business Central environment, click the ? help icon. In the Help pop-up to the right of the page, select Help & Support. Then on the Help & Support menu at the center, select Inspect pages and data.
2) Once the Page Inspection tab loads at the right, click the icon. Search and select Companies. Find the Business Central company you will be using ePay in and highlight it in the list. Under Page Inspection, copy the full Id.
3) For Cloud Business Central: Send an email to support@dynamicseshop.com or your Dynamics eShop Project Manager with your organization’s Microsoft Azure Tenant ID, Business Central environment name, and Business Central Company Id.
For On-Premises Business Central: Send an email to support@dynamicseshop.com or your Dynamics eShop Project Manager with the Business Central server address and the Business Central Company Name/Id where ePay will be used.
4) 🛑 Dynamics eShop support/project manager will respond once your subscription is activated.
3.Installing the ePay Extension & license registration
1) In order for a user to install an extension the user must either be a member of D365 Extension MGT user group or must have the EXTEND. MGT. – ADMIN permission set.
2) At the top of Business Central, click the icon. Search for and click into Extension Marketplace.
3) Use the search bar at the top to find the ePay Credit Card & ACH Payments extension published by Dynamics eShop Inc. Click Free trial on the main AppSource page and then again in the pop-up.
4) 🛑 This step will install the ePay extension and force Business Central users to close the pages/reports they are on and redirect to the Business Central home page.
Click Install to begin extension installation. After ePay finishes installing, you will receive a confirmation message and a prompt to refresh your Business Central.
5) Then click the search bar and begin typing “ePay License” until you can select ePay License Registry.
6) In the resulting ePay License Registry screen, click Get Active Licenses.
In case your license has expired, please contact support@dynamicseshop.com or your Dynamics eShop Project Manager.
4.Permissions & Role Setup
4.1.User Permissions for ePay
Once ePay is installed and a license is activated, user permission sets dictate how Business Central users are allowed to interact with ePay. The 3 permission sets are listed below from highest to lowest level of privilege:
- ESHOP-EPAY PS – This permission set can edit ePay setup card and perform all other ePay processes.
- ESHOP-EPAY EDIT PS – Can manage ePay profiles, authorize/charge, and void. Unable to edit ePay setup.
- ESHOP-EPAY READ PS – Can only read ePay tables like profiles and transactions.
The below steps should be completed by a Business Central administrator to add an ePay permission set.
1) Search Users and click a User Name to enter the User Card.
2) Scroll to the User Permission Sets table and insert the relevant ePay permission set in the table.
3) Specify the Business Central company where the permission applies (or leave blank to apply to the entire environment).
4.2.User Roles & Dashboard
The following Business Central roles can view the ePay Dashboard for quick reference of ePay profiles and credit card authorizations that are expiring/expired:
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 |
There are currently two ePay Dashboard tiles are updated via job queue that poll the connected payment gateway:
• Expired Credit Cards
• Expired Authorizations Example of Expired Credit Cards Tile → Clicking this tile would take the user to a filtered view of expired ePay Profiles |
5.Merchant Onboarding
4.1) New Merchant Application
Reach out to accounting@dynamicseshop.com regarding getting the Merchant Application for the new Payment Gateway.
In the email, please provide: Company Name & the email of the person who will be signing the Merchant Application.
4.2) Onboarding Process
After the Merchant process is initiated, follow through with the Gateway & DeS on filling out & completing the Application process, and getting the account live.
4.3) Credentials Creation
After the Merchant Account is live, follow the steps below to generate the Integration credentials which will be used to connect the Payment Gateway to BC.
a) Creating credentials for Cardpointe
- Head to the Cardpointe Portal and go to Administration. In that tab, select Credentials. If you do not see credentials, you need to be logged in with an Admin account.
- Select which Account you want the credentials to be linked to, and click + Create Credentials
- After clicking it, select the company again and create a user-friendly name [EX: DeSePayLive] and select Generate Password.
- Once the Password has been created, make sure to note down the MID, Username [Used as API Token], & Password [Used as API Key]. The URL will be https://fts.cardconnect.com
- This information will be used to populate the ePay Setup Card in the next section, please make sure to keep this information secure.
b) Creating credentials for Authorize.net
- Head to the Authorize.net portal and go to Account. Select Settings on the left and select API Credentials & Keys which can be found under the Security Settings -> General Security Settings section.
- Note down the API Login ID. This will be used in Step 5 as the Identifier ID & API Token.
Select New Transaction Key & click Submit. Authorize.net will ask to verify your identity with a pin before proceeding to create the key.
- After submitting, note down the new Transaction Key. This will be important and will be used in the ePay Setup Card in the next section.
- The API Login ID [Used as Identifier ID & API Key] & Transaction Key [Used as API Key] gathered in the previous steps will be needed to populate the ePay Setup Card in the next section. The URL will be https://api.authorize.net/xml/v1/request.api
6.ePay Setup card
In Business Central, search for “ePay”. Confirm that ePay Setup comes up. Click ePay Setup.
6.1.Gateway settings
The following fields on the ePay Setup card establish the connection between the ePay extension in Business Central and your payment gateway. DES can provide the test credentials until your merchant application is processed successfully.
Once your merchant onboarding is complete, you will need to confirm that the correct GateWay is selected since transaction Reference No.s and Token IDs will generate differently in CardConnect/CardPointe vs Authorize.net. The URL, API Token, and API Key fields will also change to match your live payment gateway credentials instead of the generic testing values we use. In case you are unsure what to insert in these fields, feel free to reach out to support@dynamicseshop.com or your project manager for clarification.
Refer to section (4.3) to retrieve the live API token & key fields from your merchant portal.
Gateway, Credit Card & ACH Settings
Field Name | Functionality |
General > GateWay | Corresponding merchant provider selector. |
Identifier ID | Unique ID to identify for gateway. |
URL | URL needed to connect to the Gateway. |
API Token | Corresponding Token for the API Integration information. |
API Key | Corresponding Key for the API Integration information. |
Credit Card Fields
ACH Fields
After configuring the above fields, click Test Connection in the top bar and select Credit Card or ACH depending on what your business is using.
You should see a “Success” response message from the payment gateway. If the test connection(s) did not work, contact your IT department or the ePay team.
6.2.Functional settings
Field Name | Functionality |
Convenience/Additional Processing Fee | Establishes if there is a convenience fee. Applicable only to Credit Card. Can be a percentage or a flat amount depending on adjacent Is Percentage toggle field. |
Payment Journal Batch, Sales Journal Template, Sales Journal Batch for CC/ACH | These fields are necessary for setting up the automations such as automatic posting to Cash Receipt Journals & general ledgering of payment information.
Your accounting team or Business Central partner will typically set up these fields to integrate well with your existing sales and accounting workflows in Business Central. |
Credit Card Functional Settings
ACH Functional Settings
6.3.Automations
Below the General, Credit Card, and ACH settings of the ePay Setup card, you will find the Automation section. These powerful settings determine at what point in an order ePay will attempt to authorize/charge funds as well as whether to notify customers via email with a receipt.
Since different business models may warrant different timing of transactions, you can toggle on only those relevant to your specific sales and accounting workflow. For specific examples of these automations in action, click the link(s) next to the Field Name to be taken to the relevant section later in this document.
These automations require an ePay-enabled Payment Method Code on the order and will use the following hierarchy of payment profiles (discussed in next section) when attempting to authorize/charge funds – this hierarchy is reiterated further in this document when applicable:
- An ePay Account Reference specified on a Sales Order will override the customer’s default profile for just that order.
- If there is no Account Reference on the order, the ePay Profile ID used in the previous authorization/charge on the order will be used.
- If neither of the above exists, there have not been any transactions on the order yet. The Default ePay Profile on the Customer card will be used in automations.
In the case that the Payment Method Code is invalid or missing, or that none of the payment profile options are satisfied, ePay will display a detailed error message of which fields need an input to proceed with enabled automations.
Field Name | Functionality |
Auto Authorize while Release (7.2.2) | Allows automatic authorization of sales orders with ePay upon release. |
Auto Capture while Posting (7.3.2) | Allows the automatic capture of funds when a Sales Order/Invoice is posted with ePay |
Auto Close Invoice with Email Pay | Allows the automatic closing of an Invoice in Email Pay (paid add-on to the default ePay product, contact sales@dynamicseshop.com for more information). |
Retrieve Transaction while Release Only | Allows the option to retrieve the transaction to BC while the order is being released. If this is not selected, the transaction will be retrieved while validating the Your Ref Number. (Recommended off) |
Enable E-Mail Receipts | This setting should be off during initial implementation and testing. Allows for E-Mail Receipts to automatically be sent to customers when funds are captured. Requires an Email Account to be set up in Business Central. |
Cash Receipts Enabled | Allows for cash receipts to automatically be created in the cash receipts journal when funds are captured. Pairs well with Post Cash Rcpts While Capture. |
Post Cash Rcpts While Capture | Allows for cash receipt journal lines to automatically be posted while funds are being captured. Pairs well with Cash Receipts Enabled. |
Re-Auth & Capture While Shipping Partially | Allows for orders to be partially shipped and paid for using ePay. Orders will be re-authorized and captured for the partial amount when they are shipped out. |
Automation Settings
6.4.Email Pay
These fields are specific to Email Pay, a paid add-on to the default ePay extension. If you wish to add Email Pay license to your current ePay solution, please contact sales@dynamicseshop.com. See the separate Email Pay User Guide for more information about how ePay can be expanded to send automated payment request emails and accept payment via secure link.
Field Name | Functionality |
E-Mail Pay URL | URL given from eShop to connect to the Email Pay Service. |
Invoice Email Pay Request Template | Allows for selecting a different template for Posted Sales Invoices that have not passed the Due Date when using Email Pay. |
Order Email Pay Template | Allows for selecting a different template for Sales Orders when using Email Pay. |
Invoice Email Pay Attachment Template | Allows for selecting a different report layout that will be attached to the Payment Requests sent on Posted Sales Invoices. |
Overdue Email Pay Template | Allows for selecting a different template for Posted Sales Invoices that have passed the Due Date when using Email Pay. |
Order Email Pay Attachment Template | Allows for selecting a different report layout that will be attached to the Payment Requests sent on Sales Orders. |
Duration For Payment Reminders | This specifies the time required (in days) to have elapsed before sending another Payment Request. |
Default Send-to-Email | Selects whether a payment request is sent to Bill-To email on the Customer Card or the email on the Posted Sales Invoice. |
First Payment Request based on Due Date | Specifies number of days before/after the invoice due date that the first payment request will be sent on. |
Email Pay Settings
7.Payment Method Configuration for ePay
Setting a Payment Method as “ePay Payment Method” enabled will allow ePay functionality to work on sales order using that Payment Method’s code.
Any Sales Order with a specified Payment Method Code that is not “ePay Payment Method” enabled will not have access to ePay functionality. This same restriction does not apply to Posted Sales Invoices as an invoice will work with ePay regardless of Payment Method Code, instead relying on whether the customer has a valid ePay Profile(s).
It is also recommended to use a payment method that is configured with “ePay Payment Method” enabled on customer accounts that are not on terms so that the automation functionality can make sure you have a credit card on file when processing a sales order.
ePay Payment Methods also have optional automations that stack on the previously discussed setup card automations (discussed with links to example scenarios in steps 4 and 5). These Payment Method level automations further ensure your orders are authorized or paid before different milestones of order fulfillment. The below steps outline how to classify an existing Business Central payment method as an “ePay Payment Method” and set up appropriate automations:
1) Head to Business Central. Use the search tool and search “Payment Method”. Select Payment Methods.
2) Click the “ePay Payment Method” box for all payment methods that are to be used by ePay. Ensure that the changes were saved in the top right.
These payment methods should now be ePay enabled.
3) For payments where you require authorization before release, toggle the box for ePay Requires Auth Before Release. See example scenario in section 4.5.
Note: This toggle requires ePay Payment Method enabled on that payment method first (see section 1 for help).
4) To ensure funds are fully captured when the items on an order leave your warehouse/fulfillment center, you can enable ePay Auto Captures while Shipping for the payment method used on the order. On top of this automation, you can also enable ePay Requires Capture to Post Shipment to verify that funds are captured before allowing the posting of a Warehouse Shipment for the order. See example in section 4.4.
Payment Methods List
Field Name | Functionality |
ePay Payment Method | Allows for the payment method to be ePay applicable. If this is enabled, all ePay functionalities are allowed when using this payment method code |
ePay Requires Authorization before Release | Requires authorization of funds before the release of any shipment of product for ePay. Requires ePay Payment Method enabled as a precursor. |
ePay Auto Captures while Shipping | Automatically captures funds (and authorizes if not previously authorized) when a Warehouse Shipment is posted for a Sales Order. ePay will follow this hierarchy of payment profiles when attempting to capture the funds:
1. ePay Account Reference specified on Sales Order. 2. ePay Profile used in a valid authorization if funds have already been authorized for the order. 3. Default ePay Profile on Customer card. If none of the options in the hierarchy above can be used to process payment, ePay will display an error message. Requires ePay Payment Method enabled as a precursor. |
ePay Requires Capture to Post Shipment | Specify whether ePay will check that funds were successfully captured before posting the Warehouse Shipment for an order. This is a safeguard against shipping unpaid items.
Requires ePay Auto Captures while Shipping as a precursor. |
8.Everyday Operations
8.1.Managing Customer Profiles (Create, Update & Make Default)
8.1.1.Creating an ePay Customer Profile
1) In Business Central, locate the Customers List.
2) Locate the corresponding customer and choose the Customer No. to open the Customer Card.
3) Locate and select ePay on the action pane. Click on Profiles. This will display all the customer’s ePay profiles.
4) Select New.
Note: This example is for CardPointe. Other merchants may look different.
5) For Credit Cards:
Fill in the corresponding information required and Save.
For ACH:
Enable the ACH Button. Fill in the corresponding information required and Save.
The customer now should have a completed ePay Customer Profile. Note: If Default was Enabled, that payment profile will then become the default for payments on that customer.
ePay Profile List
Field Name | Functionality |
Default | Has a visual check to display which profile is set to default. Unchecked are not default |
Profile ID | Corresponding ID from Payment Gateway |
Identifier ID | Merchant code from Payment Gateway |
Account ID | Differentiating number for multiple profiles on a customer. |
Type | Payment type (Credit Card, ACH) |
Account No | Saves only the last 4 digits of the credit card. |
Token | This is the unique token that is associated with the credit card info that is stored in the payment gateway. |
The information above should help define what the certain fields in the ePay Profiles are for better understanding.
8.1.2.Updating a Customer Profile
1) Navigate to the Customer’s ePay Profiles (See 2.1 for help)
2) Search for the corresponding customer profile to edit. The arrow shows which customer profile is being selected.
3) Once selected, click Manage, then Edit.
4) From here, edit any necessary fields with new information. Once finished, select Update Profile or check that the changes were saved in the top right.
Profile Card
Field Name | Functionality |
New | Creates a new ePay Customer Profile with the corresponding info |
Update Profile | Updates the customer profile card |
Transactions | Shows the transactions associated with that profile card |
Make Default | Makes the profile card default |
Remove Default | Removes this profile card from being default |
Delete Profile | Deletes the ePay profile |
The above information shows some of the useful functionalities within a profile card for ePay.
8.1.3.Making the Customer Profile default
1) Navigate to the Customer’s ePay Profiles.
2) Select the profile you want to make default. Once selected, click Make Default. Verify that the profile has a checked default box next to it.
3) To remove a profile from being default, select the profile and click Remove Default. Verify that the profile no longer has a checked default box.
8.1.4.Setting a non-default profile for a particular order
Aside from the default profile, another way to have a Customer profile be used with automations is to set an ePay Account Reference on a particular Sales Order. This ePay Account Reference profile will be used for the remainder of the process.
1) Navigate to or create an Open Sales Order.
2) Scroll to the Invoice Details section and click ••• next to ePay Account Reference.
3) Select or create an ePay Profile to be used in subsequent ePay automations on the specific order only.
Click OK.
8.2.How to authorize/capture a sales order
8.2.1.Authorizing a sales order manually
Note: Only applicable to Credit Card. ACH will not allow Authorize at the Sales Order level. You can only capture ACH at the Posted Sales Invoice level.
1) Head over to Business Central and login with your admin account.
2) Click on Sales, then Sales Orders. Select the Order No. you want to authorize.
3) Select ePay. Click on Authorize to authorize the transaction.
4) Select the existing payment profile or insert new card details. If a default profile exists, it will automatically be selected.
Note that the convenience fee established in the ePay Setup Card is applied and added to the total amount. The fee is also editable for user flexibility.
5) Click Submit once all information is added.
The Sales Order should now be authorized.
Payment Card
Field Name | Functionality |
Total Amount | The total amount from the sales order plus the convenience fee |
Convenience/Additional | Convenience fee established in the ePay Setup Card used against the total from the sales order |
Select Existing Profile | Selects a customer payment profile. Establishing one can be found in Section 2: How to Manage Customer Profile |
New Card/ACH Details | Information for a new card/ACH can be inserted here. Clicking Save Profile will establish the info as a new customer payment profile |
8.2.2.Authorizing a sales order automatically
Note: Only applicable to Credit Card. ACH will not allow Authorize at the Sales Order level. You can only capture ACH at the Posted Sales Invoice level.
1) Search for ePay and select ePay Setup
2) Under Automation, select the field for “Auto Authorize while Release”.
Note: If ePay Requires Auth before Release is enabled under the payment method, authorization will still be required before any release. This authorization can be automatically done with Auto Authorize while Release true and a default profile exists for the customer.
3) Release an order to have it Authorize automatically. Ensure that there is a default profile on the customer for the authorization to use.
8.2.3.Capturing a Sales Order
1) You must have completed step 7.2.1 in order to capture at the Sales Order level.
2) Select ePay. Select Transactions.
3) Select the Authorization line. Select Capture and Yes. There authorized amount will now be captured.
The Sales Order has now captured prepayment.
8.2.4.Capturing a Sales Order automatically when items ship
1) Create a sales order (see 7.2.1 for help). Select a payment method with the ePay Auto Captures while Shipping and ePay Requires Capture to Post Shipment automations enabled (see section 6 for help).
2) Manually authorize (see 7.2.1) or automatically authorize (see 7.2.2) funds for the Sales Order.
3) *This step may vary depending on your organization’s Business Central warehousing process. The result of this step should be a Posted Sales Shipment. The below instructions follow the standard Business Central warehousing process. Create Warehouse Shipment then Create Pick in the resulting screen. Access the open pick line from Shipment > Pick Lines in the top action bar, then click into the pick and Register Pick. Back on the Warehouse Shipment screen, click Post. Select Ship in the dialog box and click OK.
4) Back on the Sales Order screen, confirm on the right side info panel that ePay has authorized and captured funds for the order. You can also confirm the transaction details and reference numbers under the ePay > Transactions menu.
8.2.5.Reauthorizing Sales Orders
Note: To Reauthorize you must have completed an authorization in 7.2.1 or 7.2.2 first. Additionally, selecting authorize without voiding will result in this message.
1) Head over to the Sales Order Card. (see 7.2.1 for help)
2) Select ePay. Select Transactions.
3) Select the authorized payment. The arrow will denote which is selected.
4) Select Void.
5) Head back using the arrow key in the top left. Select Authorize. Follow steps #3-5 in section 7.2.1 to finish the authorization.
ALTERNATIVE: If the ePay Requires Authorization Before Release automation is enabled on the payment method used for the order, ePay will attempt to reauthorize automatically using the following hierarchy of payment profile options:
1. ePay Account Reference specified on the Sales Order.
2. Profile ID on previous authorization line.
3. Default ePay Profile on the Customer card.
The Sales Order should now be successfully reauthorized
8.2.6.Multiple captures on a sales order
1) Head over to the sales order card. (see 4.1 for help)
2) Capture a transaction for the order (see 4.3 for help)
3) Add a New Line or edit the existing sales line.
4) Repeat the authorize and capture processes from steps 1 and 2.
*For voiding an authorized transaction, see section 11.
8.2.7.Declined Authorizations/Captures
If ePay returns a response code besides Successful, any details from the payment gateway about the card issue are saved to the ePay Transaction List.
The unfiltered ePay Transaction List can be accessed via the search button from anywhere within BC. If you are still on the Sales Order/Posted Sales Invoice, you can see the transactions specifically for that order via ePay > Transactions in the top action bar.
8.3.How to process a Sales Invoice
Sales Orders may have been authorized already in some cases or may not. The funds can be captured in both cases.
To see if the sales order has been authorized before the order is invoiced, go to the ePay Transactions List will show whether it has been authorized and/or captured.
8.3.1.How to process a Sales Invoice manually
1) Head to Business Central. Select Sales and Sales Orders. Select the No.
2) Click Home, then Post. Select either Invoice or Ship & Invoice.
Note: If ePay Requires Authorization before Release is enabled for the payment method used, and an authorization does not exist, an error message will appear saying that Authorization is needed first. Authorize the Sales Order to proceed. (see Section 1 or 4.2 for help)
3) Head to its Posted Sales Invoice. Select ePay. Select Charge. Insert Payment information and click Submit (see 4.1 for help).
The Posted Sales Invoice should now be processed and closed if Cash Receipts & Post Cash Receipts are enabled. Funds should be authorized and captured.
8.3.2.How to process a Sales Invoice automatically
The method shown has Auto Capture while Post enabled in the Automation section of the ePay Setup Card. (see Section 1 for help)
1) Head to Business Central. Select Sales and Sales Orders. Select the No.
2) Click Posting, then Post. Select either Invoice or Ship & Invoice.
3) Head to the Posted Sales Invoice. The Posted Sales Invoice should automatically have authorized and captured the funds for the Sales Invoice. You can view it in detail in the ePay Transactions List.
Note: If you have Cash Receipts Enabled & Post Cash Receipts While Capture enabled from the ePay Setup Card then the Sales Invoice will be closed.
8.4.How to charge (Authorize & Capture) on a Posted Sales Invoice
This section only applies to Posted Sales Invoices that have not already had their funds authorized and captured.
8.4.1.For Credit Card
1) Head to Business Central. Search Posted Sales Invoice. Select the No. to authorize and capture funds from.
2) Select ePay. Select Charge.
3) Insert the necessary payment information. Select Submit. *Note the added convenience fee that was established in the ePay Setup Card.
The Posted Sales Invoice should now have the funds authorized and captured.
8.4.2.For ACH
1) Head to Business Central. Search Posted Sales Invoice. Select the No. to authorize and capture funds from.
2) Select ePay. Select Charge.
3) Insert the necessary payment information. Select Submit. *Note the convenience fee is removed for ACH
The Posted Sales Invoice should now have the funds captured.
*For refunding an authorized and captured transaction, see section 11.
8.5.How to authorize a Service Order
1) Head to Business Central. Search for Service Orders. Select the No. to authorize.
2) Ensure that the Service Order status is set to Finished. Select Release and Release to Ship.
Note: If Auto Authorize while Release is enabled from the ePay Setup Card and there is a payment method code selected, step 3 will already be completed. Verify this by selecting ePay and then Transactions.
3) If Auto Authorize while Release is disabled in the ePay Setup Card, then this process will have to be done manually.
To manually do this, select ePay. Select Authorize and submit the payment (see 7.2.1 for help).
4) Select Posting. Select Post. Select the posting option.
The service order should now be a Posted Service Invoice.
8.6.How to authorize a Service Invoice
1) Head to Business Central. Search for Service Invoices. Select the No. to authorize.
2) Select ePay. Select Authorize.
3) Insert the necessary payment information. Select Submit.
4) Now that the Service Invoice has been authorized, the Service Invoice should be posted. Select Approve. Select Post.
The service invoice has now been authorized and posted.
8.7.How to charge (Authorize & Capture) Posted Service Invoice
This section only applies to Posted Service Invoices that have not had their funds authorized and captured.
1) Head to Business Central. Search Posted Service Invoices. Select the No. to authorize and capture from.
2) Select ePay. Select Charge.
3) Insert the necessary payment information. Select Submit. *Note the added convenience fee that was established in the ePay Setup Card.
4) Select ePay. Select Transactions. Verify that the funds were authorized and captured.
The Posted Service Invoice should now have the funds authorized and captured.
8.8.How to charge/capture funds from a Cash Receipt Journal
1) Head to Business Central. Search for Cash Receipt Journals.
2) Select the appropriate Batch Name.
3) Select the appropriate Account Number for the customer. Put the Document Type as Payment.
4) Copy the Document No. Select Process. Select Apply Entries.
5) Paste the Document No. into the Applies-to ID section for all applicable Posted Sales Invoices. Select OK.
6) Select ePay. Select Charge. Insert Payment Information and select Submit.
7) Repeat the process for any other lines for the batch.
8) Select Post/Print. Select Post.
9) The Journal Lines have now been posted and the customer account balance should reflect this change in payment.
Verify this by viewing the customer card. Balance should now reflect the amount change. Selecting ePay and Transactions will also display the record.
8.9.How to Void or Refund an Authorize/Capture
8.9.1.Voiding an Authorization Transaction
1) Head to the document that needs to have its Authorization voided.
Note: If the authorization line has already been captured, the funds will no longer be able to be voided and will instead have to be refunded. See section 11.2 for more info.
2) Select ePay. Select Transactions.
3) Select the Authorization line. If there are multiple Authorization lines, find the live one that has the Status of “Approval” and does not have the Captured or Voided checked.
4) Select Void. A new line will appear with Transaction Type of Void.
The authorization has now been voided. Refer to Section 7.2.5 for Re-Authorizing the Sales Order.
8.9.2.Refunding a Capture Transaction
1) Head to the document that needs to have its capture transaction refunded (can be Sales Order, Prepayment Invoice, or Posted Sales Invoice).
2) Select ePay. Select Transactions.
3) Select the Capture Transaction line. Select Refund.
4) A pop-up will open, select Full Refund. Select OK.
The Capture Transaction has now been refunded. If this was on a Posted Sales Invoice with Cash Receipts Enabled, an opposing Cash Receipt Entry will be posted, and the PSI will now be left open to be captured and closed again.
See Section 4.3 or Section 6 for Capturing funds again.
8.9.3.Partially Refunding a Capture Transaction
1) Head to the document that needs to have its capture transaction partially refunded.
2) Select ePay. Select Transactions.
3) Select the Capture Transaction line. Select Refund.
4) A pop-up will open, select Partial Refund. Select OK.
5) A window will open, specify Amount to refund and select Submit.
The Capture Transaction has now been partially refunded. If this was on a Posted Sales Invoice, an opposing Refund Cash Receipt Entry will be posted against the payment, and the PSI will now be left open to be captured and closed again.
See Section 4.3 or Section 6 for Capturing funds again.
8.9.4.Refunding from Cash Receipt Journal
1) Search “Cash Receipt”. Select Cash Receipt Journals.
2) Adjust Batch Name to the desired General Journal Batch then create a line for the refund journal entry.
3) Select “Payment” for Document Type and “Customer” for Account Type then specify the customer under the Account No. field that will receive the refund.
*Note the generated Document No. for verifying the journal entry later.
4) Ensure an ePay enabled Payment type is selected and insert a negative Amount to refund. In the action bar, click ePay > Charge.
5) In the resulting ePay Payment Card screen (see section 7.2.1 step 5 for visual reference), select the ePay Profile or enter new card/ACH details to refund the Amount to. Click Submit.
6) The payment gateway’s response will be shown in a dialog box. If successful, you may click OK and proceed to Home > Post in the action bar to post the refund receipt to the journal.
*In the case of an error returned from the payment gateway, you can navigate to the customer card and click ePay > Transactions in the action bar and find the latest transaction to see more details.
7) To see the posted journal entry, navigate to customer’s card then click Customer > Ledger Entries. In the resulting screen, sort to the newest posting date and observe the refund journal entry.