epay Advantage User s Guide Version 4.0.2 April, 2013
Copyright Copyright 2013 Nodus Technologies, All rights reserved. Your right to copy this documentation is limited by copyright law and the terms of the software license agreement. As the software licensee, you may make a reasonable number of copies or printouts for your own use. Making unauthorized copies, adaptations, compilations, or derivative works for commercial distribution is prohibited and constitutes a punishable violation of the law. Trademarks Nodus estore Solution Stack, Scheduled Payments, epay Advantage, Credit Card Advantage, estore Advantage, esop Advantage and Retail Advantage are either registered trademarks or trademarks of Nodus Technologies, in the United States. The names of actual companies and products mentioned herein may be trademarks or registered marks - in the United States and/or other countries - of their respective owners. The names of companies, products, people, and/or data used in window illustrations and sample output are fictitious and are in no way intended to represent any real individual, company, product, or event, unless otherwise noted. Warranty disclaimer Nodus Technologies, disclaims any warranty regarding the sample code contained in this documentation, including the warranties of merchantability and fitness for a particular purpose. Limitation of liability The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Nodus Technologies, Nodus Technologies, assumes no responsibility or liability for any errors or inaccuracies that may appear in this manual. Neither Nodus Technologies, nor anyone else who has been involved in the creation, production or delivery of this documentation shall be liable for any indirect, incidental, special, exemplary or consequential damages, including but not limited to any loss of anticipated profit or benefits, resulting from the use of this documentation or sample code. License agreement Use of this product is covered by a license agreement provided with the software product. If you have any questions, please call the Nodus Technologies Support at 909-482-4701 2
Revision History: Author Date Version Changes Approved Date Nikki Nguyen 3/4/2013 1.0 Updates with New Changes for 4.0 SP2 NN 4/30/2013 3
Table of Contents 1. Introduction... 10 1.1. PA-DSS Compliance...11 1.2. Tokenization (Optional)...11 1.3. New Features in epay Advantage SP2...13 1.4. Terms and Conventions...14 1.5. Additional Resources...18 2. epay Advantage Installation... 19 SSL Certificate Setup...19 Username & Password Restriction Setup...19 3. Product Configuration Settings... 21 3.1. Administration Settings...21 3.1.1. Default Admin Log-in... 21 3.1.2. Browse to Admin Site... 21 3.1.3. Documentation... 22 3.1.4. Site Settings... 22 3.1.4.1. Company Information Tab... 22 3.1.4.2. Transaction Processing Options... 23 3.1.4.3. Content Management tab... 27 3.1.4.4. E-mail Setup... 28 3.1.4.5. Payment Scheduler Options tab... 29 3.1.4.6. Landing Page Options tab... 30 3.1.5. Back Office Settings... 31 3.1.5.1. Back Office Integration tab... 31 3.1.5.2. Customer Options tab... 32 4
3.1.5.3. Payment Options... 33 3.1.5.4. Card Name Mapping... 35 3.1.6. Feature Settings... 36 3.1.6.1. Payment tab... 36 3.1.6.2. Customer Wallet tab... 38 3.1.6.3. Past Due Invoices Reminder Options tab... 40 3.1.6.4. CAPTCHA tab... 41 3.1.6.5. Grid Column Options... 42 3.1.7. Recurring Billing Settings... 43 3.1.7.1. Recurring Invoice tab... 43 3.1.7.2. AutoPay tab... 47 3.1.8. Installment Payment Settings... 49 3.1.9. Sales Order Entry Settings... 50 3.1.9.1. Sales Order Entry Settings tab... 50 3.1.9.2. Order tab... 52 3.1.9.3. Invoice tab... 53 3.1.10. Manage Contract Class ID... 54 3.1.10.1. Delete or Edit a Manage Contract Class ID... 55 3.1.11. Tax Settings... 56 3.1.11.1. Troubleshooting: Avatax... 58 Disabled Event Viewer... 58 Permission for Event Log... 58 3.1.12. Manage Users... 59 3.1.12.1. Creating New Users... 59 3.1.12.2. Registering CSRs and Customers... 61 3.1.12.2.1. Registering Customers... 61 3.1.12.2.2. Registering CSRs... 63 3.1.12.3. Manage Users... 64 3.1.12.3.1. Delete Admin... 64 3.1.12.3.2. Unregistering or inactivating a CSR or Customer User Account... 64 3.1.12.3.3. Reset User Password... 65 5
3.1.12.3.4. Change Email... 65 3.1.12.3.5. Enabling See All Customers Functionality for CSR... 65 3.1.12.4. User Group Permission... 67 3.1.12.5. User Group Setting... 69 3.1.13. Queues... 70 3.1.13.1. Document Queue... 70 3.1.13.2. Payment Queue... 74 3.1.14. Reports... 75 3.1.14.1. Payments... 75 3.1.14.2. Installment Contracts... 77 3.1.14.3. Recurring Billing Contracts... 78 3.1.14.4. AutoPay Contracts... 80 3.1.14.5. AutoPay Payments... 81 3.1.14.6. Preview Recurring Billing Invoices... 82 3.1.14.7. Audit Payments... 83 3.1.14.8. Credit Card Expiration Report... 84 3.1.14.9. Outstanding Invoices Report... 85 3.1.14.10. System Information... 87 3.1.14.11. Error Logs Report... 90 3.1.15. Email Templates... 91 3.1.15.1. Payment Confirmation Template... 91 3.1.15.2. Payment Declined Template... 92 3.1.15.3. New User Welcome Template... 94 3.1.15.4. New Invoice Import Template... 95 3.1.15.5. New Customer Import Template... 96 3.1.15.6. Confirm Reset Password Template... 98 3.1.15.7. Recurring Billing Invoice Payment Declined Template... 100 3.1.15.8. Past Due Invoices Reminder Template... 101 3.1.15.9. Failed Document Submission to GP Template... 103 3.1.15.10. Key Service Down Template... 104 3.1.15.11. Credit Card Expiration Warning Template... 105 6
3.1.15.12. CCA Transaction Notification Template... 106 3.1.15.13. Express Pay Notification Template... 107 3.1.16. Documentation... 110 4. Product Overview... 110 4.1. epay Functionalities...110 4.1.1. Single Sign-On... 112 4.1.2. Customer Activation... 113 4.1.3. Site Log-in... 116 4.1.3.1. Log-in Using Customer ID... 116 4.1.3.2. Log-in Using E-Mail Address... 117 4.1.3.3. Log-in Using a Customer Chosen User Name... 118 4.1.4. Additional Log-in Management... 119 4.1.4.1. Edit an Account... 120 4.1.4.2. Create a New Account... 120 4.1.5. Accessing epay using Customer or CSR User Accounts... 121 4.1.5.1. Look up Customers Parent/Child Accounts... 121 4.1.5.2. Update CSR Profile... 122 4.1.5.3. Update Customer Profile... 124 4.1.5.4. Update Customer E-Mail Address... 125 4.1.5.5. Update CSR E-Mail Address... 126 4.1.5.6. Reset Password... 126 4.1.8.1 Create New Wallet Item... 128 4.1.8.1 Edit Wallet Items... 128 4.1.5.9. Account Summary... 131 4.1.5.10. View/Filter Posted Account Receivable Invoices (Paid Transactionss)... 131 4.1.5.11. View Outstanding Invoices... 133 4.1.5.13. View and Track Payments (Payment History)... 135 4.1.5.14. Payment Deposits... 138 4.1.5.15. Apply Existing Credit... 139 4.1.6. Processing a Payment with Multicurrency... 141 7
4.1.7. Integrating with PayPal Hosted Payment Page... 143 4.1.8. Payment via Paylink... 144 4.1.8.1 Paylink as Express Pay... 144 4.1.8.2 Paylink with Credit Card Advantage (CCA)... 146 4.2. Make Payment against a Posted AR Document...151 4.2.1. Making a Credit Card Payment... 151 4.2.2. Making an echeck Payment... 156 4.3. Scheduled Payments...158 4.3.1. View Scheduled Payments... 158 4.3.2. New Installment Payment Plan... 160 4.3.3. View/Search for an Installment Payment Contract... 164 4.3.3.1. View Payment Receipt... 164 4.3.3.2. View Amortization Schedule... 166 4.3.4. Edit Installment Payment Contract... 167 4.4. Recurring Invoicing...169 4.4.1. Create a Recurring Invoice Billing Contract... 169 4.4.1.1. Assign Different Start/End Bill Dates to Multiple Items... 176 4.4.2. Edit the Recurring Invoice Billing Contract... 178 4.4.3. View the Recurring Billing Invoice Contract... 181 4.4.4. Place an Existing Recurring Billing Contract on Hold... 182 4.4.5. Cancel an Existing Recurring Billing Invoice Contract... 183 4.4.6. Skipping an Invoice Contract Billing Cycle... 185 4.5. Recurring Payment AutoPay Contracts...187 4.5.1. Setting Up a New Payment Contract... 187 4.5.2. View/Edit an AutoPay Contract... 190 4.5.3. Cancel an Existing Payment Contract... 192 4.6. esop Advantage (Web Sales Order Entry) Overview...193 4.6.1. Using esop Advantage... 193 4.6.2. Viewing the esop Advantage Sales Order... 193 8
4.6.3. esop End of Day Report... 197 4.6.4. esop Order History... 198 4.6.4. CSR Administrative Page Access... 200 4.7. Mobile epay...200 4.7.1. How to Access epay Mobile Site... 201 4.7.2. How to Use epay Mobile Site... 202 4.7.2.1. Account Summary Page... 203 4.7.2.2. Making Payment Against Outstanding Invoice(s)... 204 4.7.2.3. Invoice History... 208 4.7.2.4. Wallet... 209 4.7.2.5. Navigation... 210 4.8. Frequently Asked Questions...211 Appendix A GP Invoice Import Mapping... 213 Appendix B GP Customer Import Mapping... 217 Appendix C Tax Detail Mapping... 218 Appendix D Sales Person Mapping... 219 Appendix E Supported Document Types... 220 End User License Agreement (EULA)... 221 9
1. Introduction F or many companies, handling invoices is still an old-fashioned paper process, despite the fact that the customer experience is becoming more web-based every day. By using Nodus epay Advantage, ERP users can avoid this disjointed method of invoicing, and send the invoices electronically to their customers. The result is a streamlined and automated business process that reduces the billing cycle and collection cost; in addition to improving efficiency, cash flow and communication. epay Advantage supports both Business to Business (B2B) and Business to Consumer (B2C). This means that the company sends invoices directly to the customer and the customer can log-in to the online bill pay web site, browse their invoices, view invoice details, process credit card and electronic check payments, and receive confirmation receipts. The payment transaction will then be automatically applied against the outstanding invoices in the back office accounting system. This introduction covers the following: PA-DSS Compliance New Features in epay Advantage Terms and Conventions Additional Resources 10
1.1. PA-DSS Compliance epay Advantage meets all the security requirements for Payment Application - Data Security Standard (PA-DSS) to help user achieve PCI Compliance for credit card processing. This user s guide describes the features and functionality of epay Advantage. However, all security features that help make this software compliant with credit card industry standards are described in the PA-DSS Implementation Guide for epay Advantage. In order to become and remain PCI Compliant, it is strongly recommended that the PA-DSS Implementation Guide is carefully read and all the recommended best practices are followed. 1.2. Tokenization (Optional) epay Advantage support Tokenization to Allow Off-Premises Secure Storage of Sensitive Credit Card information to simplify PCI Compliance self-assessment process. epay Tokenization is an alternative for merchants who require credit card security measures but are reluctant to invest in the higher levels of cost and maintenance required for internal infrastructure needs. In contrast to the regular epay, the tokenization version does not encrypt or store credit cards on the local database(s) and therefore, does not require additional hardware and software maintenance. The tokenization process starts when a credit card is processed and the information sent to a payment gateway. When this payment request is sent, the following happens: 1. The payment request is sent directly to the gateway 2. The gateway validates the card information, verifying that the account is active 3. If the card is approved, the gateway assigns a token a random series of alphanumeric characters. As opposed to the standard credit card encryption process, this token is assigned to the credit card, which is not encryptable or decryptable. 4. The token is sent back to epay software, where it is stored and used for any future payment processing whenever the credit card is needed. Tokenization Support is controlled by a registration key for epay Advantage. If epay s registration key include support of Tokenization, then from the Setup ID selects on epay Admin Portal (Site Settings > Transaction Processing Options > epay will only list the Setup ID(s) where UseToken flag is set to TRUE on Nodus Connection Manager. 11
Figure 1-1 Tokenization Settings If the registration key for epay Advantage includes Tokenization option, under System Information on Admin Portal (Reports > System Information), Token keyword will also be listed under Modules within Version Information section. Figure 1-2 System Information 12
1.3. New Features in epay Advantage SP2 Change Item # Change-#1 Change-#2 Change-#3 Change-#4 Change-#5 Change-#6 Change-#7 Change Details New Feature to Provide PayPal Hosted Page Support Bundled with Tokenization version, epay helps merchants achieve PCI Compliance much easier by collecting sensitive credit card information on a web form hosted by PayPal and pass them along with transaction data securely to PayPal server. With Hosted Page, the point of entry for credit cards no longer belongs to the epay site; therefore, it will reduce the complexity of PCI Compliance self-assessment process for merchants. New Feature to Provide Credit Card Expiration Report and Email Notification Admin and Customer Support Rep (CSR) users will be able to access the expired card report for a list of expired and to-be-expired credit cards by a specified date range. The expired card email notification can also be manually or automatically sent out to customer(s) to avoid last minute transaction decline. A New Theme with Enhanced User Experience - Update Search Option to allow search transactions by Date Range or by Document Number - Enhance Wallet Entry Selection with List View - Added Optional Prepayment Capability into Outstanding Invoices list - Ability to Display or Hide page columns - Reword Menus and Text Labels - Update All Email Templates with Sample Messages - Removal of Account Summary Graphical Charts Admin Portal Configuration Checklist Wizard Add a Configuration Checklist into Admin Portal to assist with setting up and configuring the epay web portal. New Feature to Support GP Term Discount Synchronized Customer s assigned Payment Term ID from GP Customer Maintenance so term discount is accounted for when payment is paid by a specified discount date. Feature can be enabled or disabled if needed. New Feature to Email Paylink as Express Pay Option epay is able to email a payment link that customers may click and make a one-time payment without having to login to epay. Security Enhancement 13
- Improved Forgot Password & Password Retrieval Process - Added additional level of security for Account Activation - Ability to enforce security restriction for epay s Username and Password Change-#8 Change-#9 New Feature to Support echeck Account Type Ability to define the account type for echeck entry, whether Checking or Savings Ability to Hide On-Hold Customers from Customer Lookup List CSR user may choose to hide GP s on-hold customer accounts from epay s Customer Lookup List. Change-#10 Enhancement of User Management via Admin Portal - Ability to update admin user s email address - Ability to unlock a user login after maximum login attempts have been reached Change-#11 Enhance Processed Payment Report - Add Scheduled tab to list any payment that is still scheduled to be processed - Add Failed Attempt Count to list the number of attempts for reprocessing and the reason why it failed to process. Change-#12 Add Additional Variables into Email Templates [[[ShipToAddress]]]: Ship To Address [[[BillToContact]]]: Bill To Contact [[[PO#]]]: PO# Change-#13 New Feature to Email Paylink Notification Allow CCA (Credit Card Advantage) user to send a payment link to end-customer so payment information can be entered via epay s web page. Since credit card information doesn t have to be entered within Dynamics GP window, this will help simplify PCI requirements. (Available only on Tokenization version of epay) Change-#14 Add Total Balance Due on Account Summary Add Total Balance Due Amount into Account Summary page so user can check the total outstanding amount for his/her account. 1.4. Terms and Conventions This section defines the following terms and conventions used in this users guide. 14
TERMS DESCRIPTION Customer/User Administrator/Admin User ERP users Wallet SOP RM IVC People who browse the epay website to make payments against their outstanding invoice(s). epay Administrator and/or other people who work on behalf of the merchant who operates and maintains the epay website. Enterprise Resource Planning system users, i.e., Dynamics GP customers Users A section of the application where credit card and echeck information is stored Sales Order Processing Receivables Management Invoice Entry CONVENTION http://www.nodus.com epay GP RB RBP SP ESOP AR B2B B2C DESCRIPTION Used to specify file paths and URLs Nodus epay Advantage Microsoft Dynamics Dynamics GP (formerly Great Plains) Recurring Billing Recurring Billing Payment Scheduled Payment Electronic Sales Order Processing Account Receivable Business to Business Business to Consumer 15
CONVENTION Disconnected mode Nodus Synchronizer VAR Network Topology DMZ server MSDTC COM SOAP Customer Master DESCRIPTION This feature ensures that when epay is disconnected to Dynamics GP accounting system, that customer transactions will continue in real-time without interruption. A tool/utility that allows data, documents and records to synchronize between two systems -. specifically Dynamics GP and epay Advantage 4.0 (Value-added Reseller) A company that takes an existing product and adds value, usually in the form of a specific application designed to work with the existing product. The value-added application is resold as a new product, or package. The arrangement or mapping of network elements such as links and nodes. Based on military usage of the term, but more appropriately known as a demarcation zone or perimeter network, DMZ server is a physical or logical subnetwork that contains and exposes an organization's external services to a larger, untrusted network, usually the Internet. The purpose of a DMZ server is to add an additional layer of security to an organization's Local Area Network (LAN); an external attacker only has access to equipment in the DMZ, rather than the whole of the network. The Microsoft "Distributed Transaction Coordinator" manages transactions that are distributed across multiple servers Component Object Model is a Microsoft centric interface standard for software componentry introduced by Microsoft in 1993. It is used to enable interprocess communication and dynamic object creation in any programming language that supports the technology. The term COM is often used in the software development industry as an umbrella term that encompasses the OLE, OLE Automation, ActiveX, COM+ and DCOM technologies. Simple Object Access Protocol and lately Service Oriented Architecture Protocol a protocol for exchanging XML-based messages over computer networks, normally using HTTP/HTTPS. SOAP forms the foundation layer of the Web services stack, providing a basic messaging framework so that more abstract layers can build on it. The customer s master table that stores and maintains all customer records in an Enterprise Resource Planning system like Dynamics GP 16
CONVENTION Failed status Sent(submitted) status Child Account Token/Tokenization DESCRIPTION Occurs when an electronic document or some other form of data fails to be electronically communicated between systems An electronic document or some other form of data that has been successfully transferred to another system A secondary account set up by the main account holder. For example, a company might have several websites under different names, selling different products. Each of these websites could be set up as a child account associated with the main account. A random series of numbers and alpha characters assigned by a payment gateway to a credit card for the purpose of securely processing credit card transactions. 17
1.5. Additional Resources Contact your VAR or Nodus Technologies to ask additional support questions. METHODS E-mail Web Site Telephone ADDRESS/PHONE support@nodus.com http://www.nodus.com (909) 482-4701 and Dial 2 for Support Fax (909) 482-4705 Mail 2099 S. State College Blvd. Suite 250 Anaheim, California 92806 18
2. epay Advantage Installation Instructions regarding how to install epay Advantage and its required components are located in the epay Installation Guide. Please contact Nodus Support for a copy of this manual. SSL Certificate Setup It is highly recommended to configure epay web sites to use Secure Sockets Layer (SSL) connections to ensure that both incoming requests and outbound responses are encrypted prior to transmission. After purchase and install a SSL certificate in IIS, do the following to automatically redirect visitors using HTTP to HTTPS: 1. Log on to IIS server that epay web site is installed 2. Go to installed epay web site folder 3. Open CustomizationUrl.config in notepad or any text editor 4. Add the following lines right above </rewrites> <add name="ssl" virtualurl="http\://(.*)" rewriteurlparameter="excludefromclientquerystring" destinationurl="https://$1" redirectmode="permanent" ignorecase="true" redirect = "Domain" /> 5. Save this file. Username & Password Restriction Setup Username and password length and strength can be enforced for users on epay to lower overall risk of a security breach and provide better protection against customer s financial data. Follow the instruction below to setup a preferred length and strength for both username and password: 1. Go to the web server where epay application is installed. 2. Go to the epay Site folder (Example: C\Program Files\Nodus\ePay\ePay\SiteFiles) 3. From SiteFiles folder, go to Controls folder 4. From Controls folder, choose Registration.ascx file, right-clicked and open with Notepad 19
Modify Username Expression: <td class="fieldvalue"> <asp:textbox SkinID="InputField200" ID="txtUsername" runat="server" MaxLength="50" meta:resourcekey="txtusernameresource1"></asp:textbox> <asp:requiredfieldvalidator Display="Dynamic" ID="valUsername" runat="server" ErrorMessage="User Name is required." Text="*" ControlToValidate="txtUsername" ValidationGroup="reg" meta:resourcekey= "valusernameresource1"></asp:requiredfieldvalidator> <asp:regularexpressionvalidator ValidationGroup="reg" id="val3username" runat="server" ErrorMessage="Username must be between 6 and 20 characters starting with a letter and containing only letters and numbers" Display="Dynamic" ControlToValidate="txtUsername" ValidationExpression="^[a-zA- Z]([\w\d\-\.\@]{5,19})$">*</asp:regularexpressionvalidator> </td> Modify Password Expression: <td class="fieldvalue"> <asp:textbox SkinID="InputField200" ID="txtPassword" runat="server" TextMode="Password" MaxLength="20" meta:resourcekey="txtpasswordresource1"></asp:textbox> <asp:requiredfieldvalidator Display="Dynamic" ID="valPassword" runat="server" ErrorMessage="Password is required." Text="*" ControlToValidate="txtPassword" ValidationGroup="reg" meta:resourcekey="valpasswordresource1"></asp:requiredfieldvalidator> <asp:regularexpressionvalidator ValidationGroup="reg" id="regularexpressionvalidator1" runat="server" ErrorMessage="Password must be between 6 and 20 characters starting with a letter and containing only letters and numbers" Display="Dynamic" ControlToValidate="txtPassword" ValidationExpression="^[a-zA-Z]([\w\d\-\.]{5,19})$">*</asp:regularexpressionvalidator> </td> 20
3. Product Configuration Settings 3.1. Administration Settings 3.1.1. Default Admin Log-in The default log-in credential for Administrator users: User Name: admin Password: password NOTE: For security purpose, please update your admin s default password at initial login from Manage Users > Manage Users > Select Administrator under Display users in role of > Click Reset Password. Figure 3-0 Admin Mandatory Password Reset 3.1.2. Browse to Admin Site Admin users are automatically redirected to the Admin Site upon login. Figure 3-1 Admin Login 21
3.1.3. Documentation epay Advantage documentation can be accessed by choosing the Documentation menu selection from the main menu bar. Documentation available includes the epay Advantage: User s Guide Release Notes Installation Guide 3.1.4. Site Settings Path: Settings > Site Settings All changes in this section are taken into effects by scrolling to the bottom of the Administration home page and clicking the Save button. NOTE: Changes made to the Admin settings might also require the restart of Nodus Scheduler service on the epay web server. User will get a prompt message from epay if that action is required. (To restart the Nodus Scheduler, right-clicked on Nodus Scheduler > Choose option Restart ) Figure 3-2 Restart Nodus Scheduler 3.1.4.1. Company Information Tab 22
Set up company information by filling out the form and clicking the Save button at the bottom of the page. The Upload option allows user to browse to the location of a graphic file and upload the company logo. The Remove option allows user to clear out the existing logo image from Admin Site. Figure 3-3 Company Information 3.1.4.2. Transaction Processing Options On the Admin main page, under the Site Settings menu, select the Transaction Processing Options tab. 23
Figure 3-4 Transaction Processing Options (without Tokenization) Figure 3-5-1 Transaction Processing Options (with Tokenization) 1. Mark any applicable option checkboxes (see table below for a detailed description) 2. From the Credit Card Setup ID drop list, select a setup ID used for credit card processing 3. Check the Accept credit cards box to allow customers to pay with credit card(s) 4. Only with Tokenization version, there is an option to use PayPal Hosted Payment Page if needed. With PayPal Hosted Payment Page, the point of entry for credit cards no longer belongs to the epay 24
site; therefore, it will reduce the complexity of PCI Compliance self-assessment process for merchants. 4.1. By default, the option Use PayPal Hosted Payment Page is unchecked, meaning the feature is disabled. Checkmark the option to enable the PayPal Hosted Payment Page with epay. 4.2. Upon enabled, all the epay controls where user enters credit card information will be replaced with PayPal Hosted Page as an embedded iframe. 4.3. Populate the Currency Code supported for PayPal Payflow Pro gateway account. 4.4. Checkmark PayPal Live Mode Enabled box for Production usage. 5. From the echeck Setup ID drop list, enter a setup ID used for echeck processing. This optional setting is established at installation. If the Set up ID is not available, refer to the steps below to create a new Setup ID from Nodus Connection Manager. 6. Check the Accept echeck box to allow customers to pay with electronic checks NOTE: To add a new entry to both the credit card and echeck setup ID droplists, use the following steps: Create Setup ID from Nodus Connection Manager 1. Navigate to Start > All Programs > Nodus Technologies > Nodus Connection Manager 2. Type the new setup ID in the Setup ID textbox 3. Click Save on the top menu 4. Close the Nodus Connection Manager 5. Navigate to Start > Run 6. Type the following: iisreset 7. Click OK 8. Verify that the new setup ID appears in the appropriate droplist ALTERNATE METHOD: 1. Navigate to Start > All Programs > Nodus Technologies > Nodus Connection Manager 2. Type the new setup ID in the Setup ID textbox 3. Click Save on the top menu 4. Close the Nodus Connection Manager 5. Recycle the App Pool used by the epay website FIELD Credit Card Setup ID Credit Card Transaction Type DESCRIPTION Allows selection of a payment gateway setup ID for credit card transaction. Permits the user to create Book or Sales transactions. Once chosen in Site Settings, all sales transactions will use this option until changed here. NOTE: The Book transaction option is only for epay application that has esop sales order processing module enabled. 25
Accept Credit Cards AVS enabled CVV2 Required echeck Setup ID Accept echeck Activates the option to accept credit card payments. When activated, epay verifies the billing address used by a credit card transaction. The security code on the back of the credit card is required to be entered and will be validated when this option is chosen. Allows selection of a payment gateway setup ID for echeck transaction. Activates the option to accept echeck payments. 26
3.1.4.3. Content Management tab Figure 3-6 Content Management Click on the Current Theme link to bring up a list of out-of-box epay theme options. Figure 3-7-1 Content Management Default Themes A custom look can also be created by making HTML changes described in the following section. To implement a custom theme on the epay Advantage website: 1. Navigate to the Apps_Themes sub-folder located in the: <installed directory>\epay\site Files folder on your web server (or wherever you have installed the application on your web server) 27
2. Open one of the default theme folders and modify the HTML in this location in the.css and/or.skin files RECOMMENDED METHOD: A new theme can also be installed by taking the following steps: 1. Copy one of the existing theme folders 2. Name the folder to help identify the new custom theme 3. Edit the.css and/or.skin file as needed 4. Save the changes 5. Return to the Content Management section on the epay Advantage website and click on the link to view the new custom theme 3.1.4.4. E-mail Setup This section describes how to set up e-mail on your epay Advantage site. 1. Enter e-mail server address in the SMTP Server Address text box 2. Enter e-mail server log-in credential (optional if your e-mail server does not require user authentication) in the SMTP Server Login: text box 3. Enter a valid e-mail address in the Test Email Address text box to test the e-mail setup 4. Click the Send Test Email button. 5. Verify that the e-mail was received by the address entered in the Test Email Address text box NOTE: Port 465 is currently not supported for Google Mail Server. Figure 3-8 E-mail Set-u 28
3.1.4.5. Payment Scheduler Options tab The payment scheduler works in real-time 24 hours a day. The scheduler runs one transaction type (see the list transaction types below) at a time in a measured sequence established by the Scheduler Interval setting. FIELD Stop Processing Payment after DESCRIPTION Enter the number of payment processing attempts. This sets the total number of times the scheduler will try to process a single payment transaction. Example: If transactions failed to process twice, there would be no further attempts made at reprocessing if the option is set to 2. After the number of preset attempts, the payment document status will be set to Failed. Re-Process Payment after Scheduler Interval When a payment is declined or unable to be processed, the user can set the time gap (in minutes) between attempts before the scheduler reprocesses the failed payment transaction. Allows the user to establish a period of time between processing individual payment transactions. The following payment types are run concurrently by the scheduler: Scheduled Payments Recurring Billing Invoices AutoPay contracts Installment Payments Figure 3-9 Payment Scheduler Options 29
3.1.4.6. Landing Page Options tab The option gives the user the ability to select the default landing page for both CSR and Customer users on epay Advantage after the user logs in. To utilize this feature: For the CSR user, select the drop-down list and choose a preferred landing page For the Customer user, select the drop-down list and choose a preferred landing page Figure 3-10 Landing Page Options 30
3.1.5. Back Office Settings Path: Settings > Back Office Settings 3.1.5.1. Back Office Integration tab The Back Office Connection settings facilitate communication between the website and Dynamics GP Back Office. Click the Save button to make any changes permanent. FIELD Back Office Connection Store ID Functional Currency Submit Documents to Back Office in real-time DESCRIPTION This field is filled in by Nodus during the initial installation. Thereafter, if there are any changes to the client s Transact Service back office URL/Domain, the customer must update the URL and click the Save button at the bottom of the page. Click the Reset button to acquire a Nodus Synchronizergenerated Store ID. Click the Import Functional Currency link to import the existing functional currency into epay from Dynamics GP. IMPORTANT: This must be done prior to using epay Advantage. Leave this checkbox marked to allow transactions to be processed in real-time. If unchecked, the Nodus scheduler will submit the documents to Dynamics GP. If the Nodus scheduler service is stopped, all documents will stay in Pending tab until scheduler service is restarted. 31
Figure 3-11 Back Office Integration 3.1.5.2. Customer Options tab The Customer Options section enables the user to configure reference information such as the customer number. Click the Save button at the bottom of the Back Office Settings page to make any changes permanent. FIELD Customer Prefix Customer Number Length Allow Customer Registration DESCRIPTION Allows a unique customer identifier to be associated with a newly created customer. All newly created customer accounts integrates into Dynamics GP will have the predefined customer prefix so user would know these accounts were not generated from Dynamics GP. NOTE: This function is only used with the esop module where CSR user can create new customer account on epay. Allows the length of the customer account to be adjusted as need. Dynamics GP allows maximum length of 15 characters as customer number. NOTE: This function is only used with the esop module where CSR user can create new customer account on epay. Marking this checkbox allows customers to register themselves without administrator or CSR assistance. However, the customer must exist in Dynamics GP before they can selfregister/activate their account. IMPORTANT: If unchecked, the customer will not be able to activate their account. 32
Figure 3-12 Customer Options 3.1.5.3. Payment Options Similar to Customer Options, the Payment Options section sets up the payment document reference identification information. Click the Save button at the bottom of the page to save any changes. FIELD Payment Prefix Payment Number Length Payment Batch Prefix Finance Charge Prefix Unapplied Interest Batch Prefix DESCRIPTION Allows the user to enter a unique prefix to help identify the payment number. Type NEW, PYMT or whatever is appropriate for your company s use. This will be the prefix for the GP payment receipt number. Define a character length for the payment document number, including the prefix. Type 16 in the Payment Number Length box to allow payment document with 16 characters. NOTE: Dynamics GP allows maximum of 17 characters for Cash Receipt Payment document. Allows the user to enter a unique prefix to identify the payment batch. Type EPAY in the Payment Batch Prefix box unless a different batch prefix identifier is desired. NOTE: Payment s Batch Name in GP will have the following format <Specified Batch Prefix + CurrentDate> (ex: EPAY20090101) Allows the user to enter a unique prefix to identify the finance charge document number. In the Finance Charge Prefix box, type FC unless a different finance charge prefix identifier is desired. NOTE: This setting is only used by Installment Payment module. Allows the user to enter a unique prefix to identify unapplied 33
interest batches. Type UNAPP in the Unapplied Interest Batch Prefix box unless a different prefix identifier is desired. NOTE: The Finance Charge settings are only required if you have Installment Payment module where epay would create a finance charge document in order to apply the accrued interest payment. Figure 3-13 Payment Options 34
3.1.5.4. Card Name Mapping This area is where credit card names are mapped for Dynamics GP credit cards. Leaving a credit card field blank will make that card type unavailable to users on the website. These fields will be blank by default after epay Advantage is installed. 1. Type in the credit card name as shown below for each credit card type to be accepted. NOTE: Users who choose not to accept a specific credit card type can leave the text box blank for that credit card. The populated card name must exist and match with Dynamics GP credit card names located in GP under Tools > Setup > Company > Credit Cards 2. Click the Save button at the bottom of the page NOTE: Once the card name has been used on a payment transaction, it will be grayed out and user will no longer be able to update. Figure 3-14 Card Name Mapping 35
3.1.6. Feature Settings 3.1.6.1. Payment tab This page contains configuration options related to payment features. NOTE: These configuration options are global options and once they are enabled, the settings will apply to all epay users (both CSR & Customers). OPTIONS Allow partial payment Allow deposit payment Allow Pay Later Allow Apply AR Documents Allow Term Discount DESCRIPTION Permits a partial payment amount against an outstanding invoice. Enabling this feature allows epay to accept deposits from customers for payment deposit. Deposit payments are not associated with any outstanding invoices. These payments integrate into Dynamics GP as unapplied payment receipt(s). Enabling this feature lets epay allows user to schedule the payment for a future date. Enabling this feature will enable users to apply any existing credits/payments/returns (if available on their account) to outstanding invoice(s). Enabling this feature will enable epay to support Dynamics GP Term Discount (if applicable). Once enabled, term discount related information such as Discount Available, Discount Date, Discount Taken will be available to users on Outstanding Invoices page. 36
Figure 3-15 Payment options 37
3.1.6.2. Customer Wallet tab This page contains options for customer wallet maintenance. OPTIONS Validate on new Wallet Entry Credit Card Expiration Warning DESCRIPTION This option is to ensure the credit card information entered by user is valid prior to save the information into epay database. If enabled (checked), the credit card validation option causes a transaction of type "Authorization" to be processed for a small amount (typically $0.01) against the customer's account when a new Wallet entry is added by a customer. No money will actually be taken out of the customer's account. IMPORTANT: Please be aware that there will be Payment Gateway transaction fee associated with this transaction. Checkmark the option Automatic Credit Card Expiration to enable epay to send out email notification automatically if there are expired card(s). By default, this option is unchecked. Once enabled, user can choose the date(s) for the system to send out Credit Card Expiration Notification email. Select the number of months prior to expiration to send out advanced notification to avoid last minute credit card decline for customers. Checkmark the box Send for Credit Cards on Contracts only to ONLY notify users with existing (inactive and active) recurring contracts with expired card. 38
Figure 3-16 Customer Wallet 39
3.1.6.3. Past Due Invoices Reminder Options tab This option gives the user the ability to send out automated payment reminders via e-mail (to view the email template, see Past Due Invoices Reminder in the Email Templates menu). The user can specify the day or date when the payment reminders are sent. To utilize this feature: 1. Check/uncheck the Enable Payment Reminders box to enable/disable the feature. 2. Select the Weekly or Monthly option. 3. For Weekly, select the preferred day(s) to send out the payment reminder 4. For Monthly, select the preferred date(s) to send out the payment reminder 5. Click the Save button at the bottom of the page NOTE: Users can select either Weekly OR Monthly - not both. Once weekly or monthly is chosen, the user can pick which day of the week or date of the month to send out the reminder e-mail. Figure 3-15 Past Due Invoices Reminder Options 40
3.1.6.4. CAPTCHA tab This option gives an extra security feature for epay site. It enables the tool to verify whether an actual human user or computer bot is using the site in order to block internet spam programs. Nodus is using the recaptcha from Google, with the following needed to enable CAPTCHA with epay: The User would need to register for recaptcha from the following link to get two keys: http://www.google.com/recaptcha/whyrecaptcha ReCaptcha Public Key ReCaptcha Private Key ReCaptcha Theme: user can apply a theme against the Captcha by select from the drop-down. OPTIONS Enable CAPTCHA for user login Enable CAPTCHA for user registration Enable CAPTCHA for Forgot Password Sign up for free recaptcha Public Key recaptcha Private Key recaptcha Theme Tester DESCRIPTION If enabled, the CAPTCHA box will be displayed on the user login page. If enabled, the CAPTCHA box will be displayed on the account activation page. If enabled, CAPTCHA is enabled for the Forgot Password page Click on the link to be routed to Google recaptcha account registration. Populate the public key provided from Google recaptcha account Populate the private key provided from Google recaptcha account The preferred theme or layout for recaptcha from the dropdown list. After the recaptcha public and private keys are entered, clicking the Refresh button will validate the keys. 41
Figure 3-16 CAPTCHA Setup Options Figure 3-17 recaptcha Sample 3.1.6.5. Grid Column Options This option provides admin user the flexibility to control the display columns against Outstanding Invoices and Paid Transaction pages on epay. 42
Checkmark any checkbox(es)under Hide will hide that column from the Oustanding Invoices grid and/or the Paid Transactions grid. OPTIONS Customer PO# Discount Taken Source Last Payment Date DESCRIPTION GP s Customer Purchase Order Number populated on the invoice document. Discount Amount Applied against the Invoice Document if term discount is applicable. GP s Document Creation Source to identify the sales module the document was created from. (ie: SOP, RM) If there are multiple payments processed against an invoice, this represents the date of the last processed payment. 3.1.7. Recurring Billing Settings Path: Settings > Recurring Billing Settings This section allows the user to configure settings needed to successfully run the Recurring Billing module of epay Advantage. Recurring Billing Settings consist of 2 sub-modules: Recurring Invoice and AutoPay (Recurring Payment). NOTE: Recurring Billing (with both Recurring Invoice & Payment) is an optional add-on module in epay Advantage. 3.1.7.1. Recurring Invoice tab If company supports subscription model, Recurring Invoice module enables company to generate Recurring Invoice Contract for their customer(s). Based on the pre-defined frequency of the contract, Sales invoice/order document will be created automatically on a periodic basis. The created invoice/order document will be seamlessly integrated into Microsoft Dynamics GP without any further user intervention. The Invoice/Order document can be created with/without payment transaction. (See section 4.4.1 for more details) Fill out the fields indicated in the accompanying table. 43
FIELD Contract Number prefix Contract Number Length Invoice Number Prefix Invoice Number Length Invoice Back Office Document Type Order Number Prefix Order Number Length Order Back Office Document Type Default Site ID DESCRIPTION Allows the user to enter a unique prefix to help identify the type of contract within epay. Enter the number of digits used in the contract number. The maximum number allowed is 16. Allows the user to enter a unique prefix to help identify the epay s recurring invoice in the accounting system. Enter the number of digits used in the invoice number. The maximum number allowed is 16. Specify the type of invoice for newly-generated invoice documents from epay. IMPORTANT: The invoice type MUST already exist in Dynamics GP Allows the user to enter a unique prefix to help identify the epay s recurring order in the accounting system. Establish the number of digits used in the order number. The maximum number allowed is 16. Specify the type of order for newly-generated order documents from epay. IMPORTANT: The order type MUST already exist in Dynamics GP The specified site ID will be the default site ID on the RB Contract header for New Invoice Contract form. Markdown Type Specify the type of markdown on the Recurring Billing Contract, whether by: Amount: Currency amount off of unit price Percentage: Percentage off of unit price Reactivate On-hold Contract If checked, user needs to provide the preferred method of handling the missing billing cycle during the on-hold period. There are two options: 1. Skip the missing billing cycles 2. Reprocess the missing billing cycles 44
Use Current Item Price Generates Invoices if Payment Failed Required Contract Class ID for RB Contract If checked, the contract item price will be calculated based on the current item price imported from Dynamics GP. If unchecked, the contract item price is always the contracted original price. If checked, invoice with failed payment transaction (declined by the gateway) will post to GP with no payment line. If unchecked, the invoice won t be generated if failed payment is detected while running the RB Contract. User can view the error message and reprocess from contract view. If unchecked, the contract class ID is not a required field and does not need to be populated before a user can save the Recurring Invoice contract. If checked, the contract class ID is a required field and needs to be populated before a user can save the Recurring Invoice contract. 45
Figure 3-17 Recurring Invoice Settings 46
3.1.7.2. AutoPay tab AutoPay (Recurring Payment) module enables company to generate Recurring Payment Contract for their customer(s). Based on the pre-defined frequency of the contract, payment (Cash Receipt) document will be created automatically on a periodic basis. The created payment document will be seamlessly integrated into Microsoft Dynamics GP without any further user intervention. The AutoPay contract can also be used by customers themselves if they would like to schedule their own automatic payment. Fill out the fields described in the accompanying table. FIELD Contract Number Prefix Contract Number Length Payment Applying Rule Allowed Payment Amount Options DESCRIPTION Allows the user to enter a unique prefix to help identify the type of contract within epay. Establish the number of digits used in the contract number. The maximum allowed is 16. When a payment is received, this setting establishes how payment receipts are applied against customer account in GP. EXAMPLE: Choose OldestFirst to apply payments to the oldest outstanding invoice document first. Other choices include: Unapplied the generated payment will integrate into Dynamics GP as an unapplied payment (Cash Receipt). LatestFirst apply generated payment to latest invoice first. SmallestAmountFirst apply generated payment to invoice with smallest amount first. LargestAmountFirst apply generated payment to invoice with largest amount first. Permits several options for accepting payments for AutoPay. This will be the global option available on AutoPay across all users (both CSR and Customer). NOTE: At least 1 option must be checked. Admin user can check more than 1 options. Fixed Amount: If a user selects this option, then Nodus AutoPay will process the specified payment amount based on the defined frequency basis of the contract. 47
Based on Invoice Due Date: If a user selects this option, then Nodus AutoPay determines the payment amount based on the invoice due date. If the due date is less than or equal to the system date, then the invoice s payment will be processed. Based on Invoice Document Date: If a user selects this option, then Nodus AutoPay determines the payment amount based on the invoice document date. If the document date is less than or equal to the processed system date, then the invoice s payment will be processed. Based on All Outstanding Invoices: If a user selects this option, then Nodus AutoPay determines the payment amount based on all existing posted outstanding invoices (including invoices with future document date) Figure 3-18 AutoPay Settings 48
3.1.8. Installment Payment Settings Installment Payment module enables company to generate Installment Contract for their customer(s) to provide financed plans & options. Based on the pre-defined frequency of the contract, payment (Cash Receipt) document will be created automatically on a periodic basis. The created payment document will be seamlessly integrated into Microsoft Dynamics GP without any further user intervention. The Allow CSR to select Setup ID option permits a different Setup ID to be chosen for specific payment gateways such as Verisign, USA epay, Authorize.Net on installment payment contracts. If the option is unchecked, then CSR user will not be able to pick a Setup ID during installment contract creation and update. NOTE: This is an optional add-on module in epay Advantage. Figure 3-19 Installment Payment Options 49
3.1.9. Sales Order Entry Settings Path: Settings > Sales Order Settings esop (web-based Sales Order Entry) module enables company to generate invoice and order document for their customer(s) from the web. The created invoice/order document will be seamlessly integrated into Microsoft Dynamics GP without any further user intervention. Enable the settings according to the information on the accompanying table. To make changes permanent, click the Save button at the bottom of the Sales Order Settings page. NOTE: This is an optional add-on module in epay Advantage. 3.1.9.1. Sales Order Entry Settings tab FIELD Default Site ID Filter Items by Site ID Batch Prefix Submit Newly Created Customer to Back Office Default Document Type Show Cost DESCRIPTION The default site ID information can be entered here. Once populated, the esop form will always have this site ID as a default value when the form loads. If no changes made, this is the warehouse site where inventory item will be allocated from. This option allows items in product lookup list to be filtered according to the selected Site ID. If unchecked, product lookup list will display all items that have been imported from Dynamics GP. Allows entry of a prefix identifier for Sales batches for all generated esop documents. With this option, newly created customer information is either sent directly to GP right after creation or the customer data is sent together when the first order document is created and submitted to Dynamics GP. An initial document type on the esop form, such as an invoice or order, is loaded when a user logs into epay. Displays the cost (determined by the cost type) for a line item on the sales order form. 50
Show Cost Type Default Class ID This setting establishes the cost type for an item as available in Dynamics GP. There are two options: Current current cost value of the item in GP Standard standard cost value of the item in GP Sets the GP class ID for new customers created in the sales order entry area. Figure 3-21 Sales Order Entry 51
3.1.9.2. Order tab FIELD Order Number Prefix Order Number Length Order Back Office Document Type DESCRIPTION Allows the user to enter a unique prefix to help identify the order number in Dynamics GP. Establish the number of digits used in the order document number. The maximum number allowed is 16. Specify the Order Type ID for newly generated orders from epay. IMPORTANT: The document type ID MUST already existed in Dynamics GP. Figure 3-20 Order Options 52
3.1.9.3. Invoice tab FIELD Invoice Number Prefix Invoice Number Length Invoice Back Office Document Type DESCRIPTION Allows the user to enter a unique prefix to help identify the invoice number in Dynamics GP. Establish the number of digits used in the order document number. The maximum number allowed is 16. Specify the Invoice Type ID for newly generated invoices from epay. IMPORTANT: The document type ID MUST already existed in Dynamics GP. Figure 3-213 Sales Order Entry Settings 53
3.1.10. Manage Contract Class ID Allows the user to create and manage contract class ID in the epay Recurring Invoice Contract module. The purpose of Contract Class ID is to group the different types of Recurring Invoice contracts. To create a contract class ID, follow the steps below: 1. Click on Create Class 2. Populate a preferred class description into Class Name field 3. Populate a preferred format for Batch ID for all recurring invoice contract Examples: FORMAT TYPE ENTRY FORMAT DISPLAY Prefix format for Batch ID for the recurring Invoices in GP RB [mm/yy] RB 09/11 Postfix format for Batch ID for the recurring Invoices in GP RB [mm/yy] AUTO RB 09/11 AUTO Basic format RBCONTRACT RBCONTRACT 4. Populate a preferred format for GL Reference Format for all recurring billing contract. Format should be based on your firm s business logic. This will be integrated into Dynamics GP s GL Reference field under SOP s Sales Document Detail Entry. 54
Figure 3-22 Manage Contract Class ID 3.1.10.1.Delete or Edit a Manage Contract Class ID To edit or delete a contact class ID, select a contract class ID from the list and click either Delete or Edit as shown in the Action column of the table displayed above. When editing a contract class ID, the page shown above will appear as shown with the selected contract ID properties populating the Class, Batch and GL Reference format textboxes. Make changes as needed in those textboxes and click the Save button. 55
3.1.11. Tax Settings Tax information can be either handled by GP or AvaTax, an add-on 3 rd party tax service from Avalara, Inc that is supported by epay. This third party software communicates directly to epay and supplies tax data information as needed. Tax settings already established in Dynamics GP can be used by selecting the Standard GP Tax Setup option from the Tax Setup checklist. When choosing AvaTax, the page displays required AvaTax setup information. This configuration detail must be gathered from AvaTax prior to filling out the form displayed on the AvaTax setup page. Figure 3-23 Tax Settings 56
Figure 3-24 Tax Settings AvaTax SETTING Allow Checkout when AvaTax web service is unavailable Charge Tax on Shipping Charge Tax on Handling AvaTax AccountID AvaTax LicenseKey AvaTax Username AvaTax Password DESCRIPTION Allows the order/invoice process to be completed, even if there are problems gathering tax amount calculation from AvaTax web service. NOTE: The order/invoice created on epay at this point will not include any tax amount. Enables tax to be added to shipping charges. Enables tax to be added to handling charges. Enter Account ID provided by AvaTax. Enter License Key provided by AvaTax. Enter the AvaTax-assigned user name. Enter the AvaTax-assigned password. 57
AvaTax ServiceURL AvaTax CompanyCode Default AvaTaxScheduleID for new User AvaTax Shipping ItemCode AvaTax Misc. ItemCode AvaTax Customized Error Message Send e-mail if AvaTax integration encounters error(s) E-mail Address Subject Provided by Avatax, enter the AvaTax URL needed to access AvaTax service. Enter the company code assigned by AvaTax. The default schedule ID received from Avatax for new customers. Provided by Avatax, this entry is used to calculate shipping/freight tax. Provided by Avatax, this entry is used to calculate miscellaneous tax. Allows a customized error message to be entered to handle error conditions such as a communication failure with AvaTax web services. Mark this checkbox to send an e-mail notification when an AvaTax error occurs. Enter an e-mail address for AvaTax error notification. Enter a subject line for AvaTax error e-mails. 3.1.11.1. Troubleshooting: Avatax NOTE: These settings only needed if Avatax SDK is installed on epay s Web Server. Avatax SDK is NOT required to be installed on epay s Web Server in order for epay to work with Avatax web service. Disabled Event Viewer Since Avatax writes to EventLog, if Event Viewer is disabled, user would probably need to remove the path to the log so that Avatax will not try to access and write to EventLog which might error out. For Windows Server 2008, if Event Viewer is disabled, you have to delete the Parameters key under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog. Permission for Event Log 58
Since Avatax writes to EventLog, user would probably need to grant permission for Avatax to write to the log so Avatax does not error out due to insufficient privileges. For Windows Server 2003, just need to add Network Service with Full Control to EventLog key (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog), it will affect Security key under EventLog key. For Windows OS other than Windows Server 2003, need to add Network Service with Full Control to EventLog Key (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog) and Network Service with Read to Security key. (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\Security) 3.1.12. Manage Users 3.1.12.1. Creating New Users There are three types of users in epay Advantage: Administrator CSR Customer Customers can only be created in GP. Their account can be activated and assigned a user name/password from the Register Customers section of the Manage Users menu. CSRs can be created in either epay or Dynamics GP if created in GP, see the Registering CSRs section of this user s guide for instructions on how to activate those CSR accounts. The process for creating a new CSR or Admin user is similar: choose New Admin User or New CSR User from the Manage Users menu and fill out the form. Once created, the user will have log-in access to epay. 59
Figure 3-25 Create Admin User Figure 3-268 Create CSR user NOTES ON CREATING A CSR: After being created, the CSR is automatically registered with a user name and password CSR account created directly from epay portal is called Local CSR Administrators can reset a CSR s password from the Manage Users window by: 1. Choosing CSR from the Display Users in role drop-down list 2. Clicking Reset Password By default, local CSRs are given permission to access all Dynamics GP s customer accounts. This access cannot be deactivated. 60
Local CSRs can be de-activated by the site administrator by: 1. Navigating to Manage Users 2. Choosing CSR from the Display Users in role drop-down list 3. Unmarking the Active checkbox 3.1.12.2. Registering CSRs and Customers Path: Manage Users > Manage Users When CSRs and Customers are created in Dynamics GP, they must be registered in epay Advantage before a user name and password can be assigned to them. This can be done in the Register CSR and Register Customer pages, or from the Manage Users page. NOTE: CSRs can also be created in epay. See the Creating New Users section of this user s guide. 3.1.12.2.1. Registering Customers Once created in Dynamics GP, the customer is imported (this is done automatically by the Nodus Synchronizer) to a customer registration list in epay. When activated in epay, Customers can assign themselves a user name and password (described in the Customer Activation section of this user s guide) or the Administrator can set up a Customer as shown in the steps below. 1. To register a customer, navigate to Manage Users > Register Customers 2. Click on the Register link 3. The form opens up with additional fields as shown below. Enter the required information in the provided fields 4. Click the Register link. The assigned user name appears in the Username column NOTE: Customer users can be registered multiple times to support additional logins per customer account as needed. When multiple log-ins are established for a customer, these log-ins can be managed by epay Advantage as described in the Log-in Account Management section of this user s guide. 61
Figure 3-279 Register Customer 62
3.1.12.2.2. Registering CSRs When CSRs are imported into epay Site from Dynamics GP, they need to be registered before a user name and password can be assigned to them. This registration can be done from the Register CSR page or the Manage Users page. 1. From the main menu, navigate to Manage Users > Register CSR 2. Click on the Register link under the Username column, next to the corresponding Sales Person Number 3. Enter the Username, Password and Email address into the respective text boxes 4. Click Register to save changes. 5. The CSR is activated on epay 6. Otherwise, click Cancel to leave the current page and go back to previous CSR list Figure 3-30 CSR Registration 63
3.1.12.3. Manage Users There are several common functions available from the Manage Users sub-menu as described in the following sections. 3.1.12.3.1. Delete Admin This function allows the deletion of an administrator. From the main menu, navigate to Manage Users > Manage Users. 1. Choose the user type from the user list 2. Click the Delete link and the user will be deleted from the list IMPORTANT: Always have a spare admin user established in the system before deleting any admin users from epay to prevent being locked out of the system. Figure 3-31 Manage Users 3.1.12.3.2. Unregistering or inactivating a CSR or Customer User Account 1. Choose the user type from the user list 2. Unmark the Active checkbox (conversely, unmarking this box will activate the user) 3. To unregister the user, click the Unregister link and the user name will be removed from the user list 64
3.1.12.3.3. Reset User Password To reset a password for an administrator, CSR or customer: 1. Choose the type of user from the Display users drop list 2. When the table populates with names, click the Reset Password link for the user you wish to reset the password 3. Type the new password in the New Password and Confirm Password boxes 4. Click the Reset Password link. The window will refresh and display a Password reset message 3.1.12.3.4. Change Email To change email address for an administrator: 1. Choose the type of user from the Display users drop list 2. When the table populates with names, click the Change link for the user you wish to update the email address 3. Type the new email address into Email field 4. Click the Save link. The window will refresh and confirm the change. 3.1.12.3.5. Enabling See All Customers Functionality for CSR This functionality allows the selected CSR to view all customer accounts in Dynamics GP. If the checkbox isn t marked, CSRs can only view customers assigned to them. To enable this functionality: 1. Click on the Display users in role of drop list and choose CSR 2. Check the See All Customers box for a specific CSR. This allows the CSR to see all the customers registered in Dynamics GP that have been imported into epay portal. NOTE: Having the See all Customers checkbox unchecked will prevent customers from viewing all the customers registered in Dynamics GP. However, this would allow the CSR to view only the customers assigned to him/her in Customer Maintenance from Dynamics GP. 3. Log in to the epay site as the CSR click the Customer Lookup icon 4. A new window opens that is populated with all Dynamics GP s customers. 65
Figure 3-32 See All Customers CSR Setup 66
3.1.12.4. User Group Permission User group permissions give the administrator the ability to create groups of users and assign them permission to control certain website functionalities. Users can be assigned to the group through the User Group Control Setting described in this user s guide. To set up a group: Figure 3-33 Group Permissions Page 1. From the Group Permission page, click the Create New Group link 2. When the Group Permission Edit page opens, enter a group name in the textbox 3. Mark the checkboxes for the permissions to be granted to this new group 4. Click the Save button and the group name appears on the Group Permission list NOTE: To edit group permissions, click the Edit Permission button and change the permissions as needed by marking the checkbox by the listed function. Click the Delete link in the Group Permission window to remove the group permission. 67
Figure 3-28 Group Permissions Edit The following Group and Administrative permission areas are available: Group Permissions Allow to override credit limit: user can override the credit limit for a customer account Allow to change item price: user can change item unit price for a line item Allow to change item description: user can change the item description for a line item Allow to create customer: user can create new customer Allow to change discount: user can adjust the discount for a line item Administrative Settings: grant administrative rights and permission to the page(s) within the admin portal to a CSR user. o Settings o Manage Users o Queues o Reports o E-mail Templates 68
3.1.12.5. User Group Setting User Group Setting establishes user rights in epay Advantage by assigning users to an existing group. As described in the User Group Permission section of this user s guide, the group is then granted specific permissions to control functionality on the website. To assign a user to a group: 1. Highlight a user in the CSR box. The list of groups associated with that specific user appears in the Current User Group box. 2. To associate the user with another group, select the group name in the Available Groups section and click the arrow button to move that group to the Current User box. 3. Click the Save button Remove a user from a group: 1. Highlight a user in the CSR box 2. Highlight a group in the Current User Group box 3. Click the arrow to move the group back to the Available Groups box 4. Click the Save button NOTE: To create a new group, click the Create New Group link and follow the directions displayed in the User Group Permission section of this user s guide. Figure 3-29 Inserting User into a User s Group 69
3.1.13. Queues 3.1.13.1. Document Queue This page lists the details of transactions that have reached the following status: All Failed Pending Sent To access this page, user can navigate to Queues > Document Queue. The table below describes components of the document queue. OPTION Search Reset All tab Failed tab DESCRIPTION Enter a document number in the text and click the Search button. Select the maximum allowed number of records to be displayed on search result using Max Results drop-down list. Reset will clear out all the previous Search results and brings user back to the selected tab. Lists all documents available in the queue across all document status. Transactions with Failed status are listed here. Clicking the Resubmit All button will retry sending all previously failed transactions into Dynamics GP. Document details can be viewed in HTML format by clicking on the link under the Doc Number column. Failure details can be accessed by clicking on the Details link for a document. When the page loads, scroll to the bottom of the page to the error box where the error string is displayed. 70
OPTION DESCRIPTION Once the issue is corrected, the document can be resubmitted by clicking on the Re- Submit link on the top right hand corner. (see screenshot below) 71
OPTION DESCRIPTION Pending tab Sent tab Date Transactions in Pending status. All listed document in this tab are pending submission into Dynamics GP. Transactions that have been successfully submitted into Dynamics GP. Date the document was created 72
OPTION Status Type Doc Number #Tries Details Clear All button Resubmit All DESCRIPTION Current document submission status Type of the document: Invoice, Order, Payment, Finance Charge, Customer. Identifying document number that will be created in Dynamics GP, whether a Sales document or Payment document. The number of attempts to resubmit the document into Dynamics GP. Clicking on this link loads a page that provides XML data details for the document. Although this XML data can be changed, Nodus strongly recommends this only be done after consulting Nodus Support staff. Located in the Sent tab, this button will remove/purge all successfully submitted documents from the list. From the Failed tab, this button resubmits all failed documents into Dynamics GP. Figure 3-36 Document Queue 73
3.1.13.2. Payment Queue The Payment Queue lists the details of all the payment transactions that have failed to be processed at the gateway. Failed payments can be reprocessed individually or all at the same time. Types of payments in the queue including: Regular Payments Scheduled payments not associated with an installment payment plan or recurring payment plan Installment Payments Installment payment plan set up with a specific number of payments Recurring Payments Payments made under a recurring plan NOTE: All failed payments can be retry again by clicking the Re-process all failed button. If only one payment needs to be sent again, click the Reprocess link in the row belong to the desired payment document. Figure 3-30 Payment Queue 74
3.1.14. Reports A series of reports are available from epay Advantage, including: Payments Installment Contracts Installment Payments Recurring Billing Contracts AutoPay Contracts AutoPay Payments Preview Recurring Billing Invoices Credit Card Expiration Report Outstanding Invoices Report Audit Payments System Information Error Logs 3.1.14.1. Payments This report creates a list of all payment documents. The list is can be filter by customer or date range. The payment documents are categorized into different tabs for user to view payments group by status. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the page bottom 75
Figure 3-31 Reports - Payments 76
3.1.14.2. Installment Contracts This report displays a list of active and on-hold installment contracts. The contracts are searchable and the report can be filtered by customer number or date range. In addition to standard data such as customer and contract IDs, this report features summary information such as invoice Balance Due and Contract Remaining Balance. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. Figure 3-32 Reports - Installment ContractsInstallment Payments Use the search function to display all payments across all installment contracts from a specific customer. Features in this table include a listing of all payments made to specific installment contracts and whether the payments were successfully processed. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. 77
Figure 3-40 Reports - Installment Payments 3.1.14.3. Recurring Billing Contracts All current recurring billing contracts are listed in this report. The contracts are searchable and report can be filtered by Contract Status and Failed Payment and On-Hold Contract Only. In addition to standard data such as customer and contract IDs, this report features information such as Contract Status and Last Processed Date of the Recurring Billing contract. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. 78
Figure 3-41 Reports - Recurring Billing Contracts 79
3.1.14.4. AutoPay Contracts This report displays high level summary details for Recurring Payment (AutoPay) contract. The report can be further filtered by Contract Status drop-down list. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. Figure 3-42 Reports - AutoPay Contracts 80
3.1.14.5. AutoPay Payments This report displays payment details associated with AutoPay contracts. User can search for contracts by Customer Number or Date Range. The report can be further filtered by checkmark the box Display Failed Payments Only to only display the failed payment documents for AutoPay contracts. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. Figure 3-43 Reports AutoPay Payments 81
3.1.14.6. Preview Recurring Billing Invoices This report allows future billing cycles to be viewed in advance. In addition to a standard search, the search can allow the user to choose only those dates where recurring billing invoice contracts are due next. To apply this option: 1. Mark the By Available Billing Date checkbox 2. Click the drop-down list and select an available billing date 3. The table will display future billing contracts After the report is created, the user can filter the table in the following ways: FEATURE Last Billing Cycle only Contract Class DESCRIPTION Marking this checkbox will display only those contracts that are in their final billing period. This drop-down list allows the user to filter by contract class. If no contract class is chosen, contracts for all classes will be displayed. To assist in inventory management, the preview report will also include a summary of the item quantities that will be needed during the billing cycle chosen. These items are a cumulative total of all items on all invoices displayed on the table for the selected billing date. NOTES: Only one billing cycle can be viewed ahead of the current date. As shown in the accompanying figure, the recurring billing invoice contract or item reports can be downloaded to an Excel spreadsheet by clicking the link below either table. 82
Figure 3-33 Reports - Preview Recurring Billing Invoices 3.1.14.7. Audit Payments The payment audit trail report allows the user to track payments created by user & user role. The report lists all payments made by Customers, CSRs and Scheduler with a created date and timestamp. NOTE: This report can be downloaded as an Excel spreadsheet by clicking the link at the bottom of the table. 83
Figure 3-34 Reports - Audit Payments 3.1.14.8. Credit Card Expiration Report This report lists all the expired credit card(s) based on a specified range of expiration dates. User can filter expired credit card entries that are associated with recurring contracts only by checkmark the box Include Credit Cards Associated with Contracts Only. User can also choose to send an email notification to customer(s) with expired cards. 84
Figure 3-35 Reports Credit Card Expiration Information To send manual email notification for expired credit card(s): Pre-Conditions: STEPS: Under Settings > Make sure Email Setup has been configured Under Email Templates > Make sure the Credit Card Expiration Warning email template is setup and enabled. 1. Check mark the box(es) under Email for the preferred expired credit card record(s) 2. The Email button will be enabled 3. Click on Email button to manually send out Credit Card Expiration Warning email to customers with expired card entries. 4. A confirmation message will be displayed if the email was sent out successfully 3.1.14.9. Outstanding Invoices Report ** This feature is ONLY available on epay with Tokenization By default, this report lists all the outstanding invoices across all customers. User can search for outstanding invoice(s) by customer number. Outstanding invoices can also be filtered by transaction date or transaction number. Using this report, admin/csr user can email a payment link that customers may click and make a onetime payment without having to login to epay. 85
Figure 3-364 Reports Oustanding Invoices Report To send paylink email notification for Express Pay: Pre-Conditions: STEPS: Under Settings > Make sure Email Setup has been configured Under Email Templates > Make sure the Express Pay Notification email template is setup and enabled. 1. Check mark the box(es) under Select for the preferred outstanding invoices 2. The Send Email button will be enabled 3. The email address column will be pre-populated if the customer has an existin g email on file. User can modify the default email address (if needed) before sending out the notification. 4. Click on Send Email button to send out Express Pay Notification email to customers to provide a one-time payment capability. 5. A confirmation message will be displayed if the email was sent out successfully 86
Figure 3-35 Reports Send Express Pay Notification Email 3.1.14.10. System Information This page contains the summary of epay s system information, product version, purchased modules, status of scheduler windows service and document queue s high level overview. 87
Figure 3-36 Reports System Information Please refer to the chart below for description of each of the field for the system information: Section Field Name Description Version Information Assembly File The version number of epay s development version and build. Modules Currently enabled modules within epay. These modules are optional within epay and can be purchased with additional cost. SP: Installment Payments RB: Recurring Invoicing 88
RBP: Recurring Payments (AutoPay) esop: Sales Order Entry (esop) Avatax: Avatax tax service Token: Tokenization Option Database Information Connection String epay database connection information Schema Version Database schema version number for epay. Nodus Services Encryption Service Display current status of Nodus Key Encryption Service. This service is used to encrypt/decrypt credit card data on epay. Transact Service Scheduler Service Display the current status of Nodus Transact Service. This service provides the communicate between epay and Back Office Dynamics GP Display the current status of epay Scheduler Service. This service contains multiple scheduler worker to process documents/transactions on epay on a scheduled basis. SPCPayment Scheduler: Installment Payment scheduler to process installment payment contract. RBPCPayment Scheduler: Recurring Payment scheduler to process recurring payment (AutoPay) contract. Payment Scheduler: Payment scheduler to process regular scheduled payment on epay. Past Due Reminder Scheduler: Scheduler to check and sends out past due reminder email for past due invoices. Queue Scheduler: Scheduler to handle documents from the document/payment queue. RBC Invoice Scheduler: Recurring 89
Failed/On-Hold Documents Document Queue Payment Queue RB Invoice Contract RB Payment Contract Installment Contract Invoice scheduler to process recurring invoice contract. Display document status summary count from Document Queue Display document status summary count from Payment Queue Display contract status summary count for Recurring Billing Invoice contracts. Display contract status summary count for Recurring Billing Payment (AutoPay) contracts. Display contract status summary count for Installment Payment contracts. 3.1.14.11. Error Logs Report This page displays the error(s) that was logged for epay website for any exception happens behind the scene. This is meant for Support to easily troubleshoot the problems without accessing SQL database to view the ErrorLog table. The error report can be searched by error number or date range. 90
Figure 3-37 Reports Error Logs 3.1.15. Email Templates 3.1.15.1. Payment Confirmation Template This template is used for generating confirmation e-mails for all payment transactions. From the main menu, navigate to Email Templates > Payment Confirmation Template. 1. Enter the e-mail address of the default sender of the payment confirmation in the From box. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the confirmation payment e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed. 4. In the Main Message Body, the administrator can keep the existing format or create a different Payment Confirmation Email Template 5. The Message Invoice List provides code that sets up an Invoice Details for the customer to view 6. Click the Save button at the bottom of the page 91
Figure 3-38 Payment Confirmation Template 3.1.15.2. Payment Declined Template This template is used for generating a standard e-mail for credit card and echeck payments that have been declined. From the main menu, navigate to Email Templates > Payment Declined. 1. Enter the e-mail address of the default sender of the payment declined in the From box. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the declined payment e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed if desired. 4. In the Main Message Body, the administrator can alter the message for Payment Declined Email Template as needed 5. The Message Invoice List provides code that sets up an Invoice Details format for the customer to view 6. Click the Save button at the bottom of the page 92
Figure 3-39 Payment Declined Template 93
3.1.15.3. New User Welcome Template This template is aimed at welcoming new customers to the site after they have registered/activated their account. Information in this template can point new customers to featured areas in the website or show them where help information can be obtained. From the main menu, navigate to Email Templates > New User Welcome. 1. Enter the e-mail address in the From box to set the default sender of the Welcome e-mail. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter an e-mail address of any additional recipient(s) to blind carbon copy (bcc) the Welcome e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed if needed. 4. In the Main Message Body, the administrator can alter the message for the New User Welcome Email Template as needed 5. Click the Save button at the end of the page Figure 3-40 New Customer Registered E-Mail Template 94
3.1.15.4. New Invoice Import Template This template is sent to customers when a new invoice has been imported to the epay website from Dynamics GP. From the main menu, navigate to Email Templates > New Invoice Import 1. Enter the e-mail address in the From box to set the default sender of the New Invoice Import e- mail. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the New Invoice Import e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed if needed. 4. In the Main Message Body, the administrator can alter the message for the New Invoice Import e- mail template as needed. 5. Click the Save button at the bottom of the page NOTE: Substitute the actual epay website address for the existing URL shown in the accompanying figure. Figure 3-41 New Invoice Import Template 95
3.1.15.5. New Customer Import Template This template is used when a new customer is imported from Dynamics GP into the epay website. Customers can be notified that their account has been imported onto epay and informed about using the provided user name and phone number to log onto epay to activate their account. From the website top menu, navigate to Email Templates > New Customer Import. 1. Enter the e-mail address in the From box to set the default sender of the New Customer Import e-mail. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the New Customer Import e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed as needed. 4. In the Main Message Body, the customers can create their own New Customer Import e-mail. 5. Click the Save button at the bottom of the page NOTE: Substitute the actual epay website s address for the location shown in the accompanying figure. 96
Figure 3-42 New Customer Import Template 97
3.1.15.6. Confirm Reset Password Template This template is used for generating a standard e-mail to notify customers with a link to reset their passwordto set up the template: 1. From the website top menu, navigate to Email Templates > Reset Password 2. Enter the e-mail address in the From box to set the default sender of the Confirm Reset Password e- mail NOTE: If this field is blank, this e-mail notification is disabled. 3. Enter the e-mail address of any additional recipient(s) to carbon copy the Confirm Reset Password e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 4. Enter a default Subject heading in the Subject field. This can be changed if needed. 5. In the Main Message Body, user can create custom Reset Password Email Template if desired. 6. Click the Save button at the bottom of the page 98
Figure 3-43 Confirm Reset Password 99
3.1.15.7. Recurring Billing Invoice Payment Declined Template This template is sent when a payment by echeck or credit card for a recurring invoice contract has been declined. To use this template: 1. From the website top menu, navigate to Email Templates > Recurring Billing Invoice Payment Declined Enter the e-mail address in the From box to set the default sender of the Recurring Billing Invoice Payment Declined e-mail. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to carbon copy the Recurring Billing Invoice Payment Declined e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 3. In the Main Message Body, user can create their own custom Recurring Billing Invoice Payment Declined e-mail 4. Enter a default Subject heading in the Subject field. This can be changed if desired. 5. Click the Save button at the bottom of the page Figure 3-44 Recurring Billing Invoice Payment Declined Template 100
3.1.15.8. Past Due Invoices Reminder Template This option enables users to send automated payment reminders via e-mail twice per month. The user can specify the date when the payment reminders are sent. epay sends a past due notice based on the invoice due date set up in Dynamics GP. For example: If a customer s GP due date is 30 th of the month, epay will consider an invoice to be past due on the 31st. The e-mail reminder will not specify past due amounts or invoices, but will display the total balance due for the customer. To set up e-mail reminders: 1. Navigate to Settings > Feature Settings 2. Click the Past Due Invoices Reminder Options tab 3. Mark the Enable Payment Reminders checkbox 4. There are two scheduling options: Weekly or Monthly. Mark the radio button by the scheduling option desired 5. Choose a specific billing day For weekly, choose a day of the week For monthly, select a date (can be more than one) or Last for the last day of the month 6. Click the Save button Figure 3-45 E-Mail Reminder Settings 101
To use the E-Mail Reminder template: 1. From the website top menu, navigate to Email Templates > Past Due Invoices Reminder 2. Enter the e-mail address in the From box to set the default sender of the Past Due Invoices Reminder e-mail. NOTE: If this field is blank, this e-mail notification is disabled. 3. Enter the e-mail address of any additional recipient(s) to carbon copy the Past Due Invoices Reminder e-mail. To enter more than 1 email address(s), separate them by semicolon (;) 4. In the Main Message Body, user can create custom Past Due Invoices Reminder e-mail 5. Enter a default Subject heading in the Subject field. This can be changed as needed. 6. Click the Save button at the bottom of the page Figure 3-46 Past Due Invoices Reminder 102
3.1.15.9. Failed Document Submission to GP Template When an epay document is sent to GP but fails to integrate into GP, if the template is enabled, the system will send a notification to a person designated in the To textbox of the e-mail template. Enter the e-mail address in the From box to set the default sender of the Failed Document Submission to GP Notification e-mail. NOTE: If this field is blank, this e-mail notification is disabled. Figure 3-47 Failed Document Submission to GP 103
3.1.15.10. Key Service Down Template ** This email template is only available for epay with DSS. When the Key Service server is not accessible by epay, the Nodus Encryption service is unable to encrypt or decrypt credit card data. When this condition exists, a notification is sent to the person designated in the To textbox on the Key Service Down template so the key services from the encryption key server can be checked accordingly. Enter the e-mail address in the From box to set the default sender of the Key Service Down Notification email. NOTE: If this field is blank, this e-mail notification is disabled. Enter the email address in the To box to set the default recipient of the Key Service down Notification email. Figure 3-48 Failed Document Submission to GP 104
3.1.15.11. Credit Card Expiration Warning Template This template is used for generating a standard e-mail for credit card that has been expired or to-beexpired. From the main menu, navigate to Email Templates > Credit Card Expiration Warning. 1. Enter the e-mail address of the default sender of the payment declined in the From box. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the email. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed if desired. 4. In the Main Message Body, the administrator can alter the message for Credit Card Expiration Warning Email Template as needed 5. Click the Save button at the bottom of the page Figure 3-49 Failed Document Submission to GP 105
3.1.15.12. CCA Transaction Notification Template ** This email template is only available for epay with Tokenization. This template is used for sending a payment link from epay for Credit Card Advantage (CCA) to allow customers to enter their credit card information from the web via epay so the credit card information does not have to be entered directly into Dynamics GP. From the main menu, navigate to Email Templates > CCA TransactionNotification Warning. 1. Enter the e-mail address of the default sender of the payment declined in the From box. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the email. To enter more than 1 email address(s), separate them by semicolon (;) 3. Enter a default Subject heading in the Subject field. This can be changed if desired. 4. In the Main Message Body, the administrator can alter the message CCA Tranaction Notification Email Template as needed 5. Click the Save button at the bottom of the page 106
Figure 3-50 CCA Transaction Notification 3.1.15.13. Express Pay Notification Template ** This email template is only available for epay with Tokenization. This template is used for sending a payment link from epay to allow customers to make a one-time payment without having to login to epay portal. From the main menu, navigate to Email Templates > Express Pay Notification Warning. 1. Enter the e-mail address of the default sender of the payment declined in the From box. NOTE: If this field is blank, this e-mail notification is disabled. 2. Enter the e-mail address of any additional recipient(s) to blind carbon copy (bcc) the email. To enter more than 1 email address(s), separate them by semicolon (;) 107
3. Enter a default Subject heading in the Subject field. This can be changed if desired. 4. In the Main Message Body, the administrator can alter the message for Express Pay Notification Email Template as needed 5. Click the Save button at the bottom of the page Figure 3-51 Express Pay Notification 108
Figure 3-52 Key Service Down Email 109
3.1.16. Documentation Nodus epay documentation such as: User s Guide, Release Notes and Installation Guide can be accessed from this menu. User can click on any of the document above to view them in PDF format. NOTE: PDF reader software must be installed in order to view these documents. Figure 3-53 epay Documentation 4. Product Overview 4.1. epay Functionalities Most epay functionalities can be used by both CSRs and customers. The main exceptions include: 110
CSRs can set up installment payment contracts while customers cannot. The difference between an installment payment contract and a recurring payment (AutoPay) contract (which customers can set up for themselves) is an installment payment contract involves other financial factors such as establishing an interest rate that is specifically tied to an outstanding invoice in GP A CSR can create/edit a recurring invoice contract. Customers cannot create/edit this type of contract. Customer can only update the credit card information associated with the contract. While customers can view main or assigned Child accounts (if their account is set up as a parent account in GP), CSRs can view all customers or only assigned customers. CSR cannot view parent/child relationship, it has to be viewed as individual account. CSRs cannot be activated using the Log-in page Activation button. Only Administrators can activate a CSR through the Admin portal. CSRs can use esop Sales Order Entry to generate a sales order document. Customers cannot create this type of document. 111
4.1.1. Single Sign-On epay Advantage allows customers to seamlessly link their existing sites and web applications to the epay website via the Single Sign-on page so the customers do not have to login multiple times across all sites. To utilize this feature, generate a link in your application. Using Http Post is highly recommended. NOTE: To redirect visitors to the portal site when visitors go to epay page directly, please enter the login page URL into ReturnUrl in Web.config. Otherwise leave it blank. For Logout, to redirect visitors to a different web page, please enter the designated page URL into LogoutReturnURL in Web.config. Otherwise, leave it blank. FIELD a1 DESCRIPTION CustomerNumber. Encrypted epay encrypts the username (parameter a1) using a Triple DES algorithm. Enter the initial vector (InitializationVector) and encryption key (EncryptionKey) in Web.config located in the epay site root. To test encryption or description using an entered initial vector and encryption key, go to: [YourEpayURL]/admin/ssosetup.aspx var3 var4 var5(optional) Store ID. This can be found at Back Office Integration If the Store ID is 00000000-0000-0000-0000- 000000000000, please click the Reset button to display the encrypted Store ID. User role in EPay. 'CUS' for customers. 'CSR' for Customer Service Representatives Customer Number. A CSR will be allowed to conduct transactions on behalf of this customer. var4 must be 'CSR'. 112
4.1.2. Customer Activation Before customers can be granted access to epay Advantage, they must first be created in Dynamics GP and imported to epay Advantage (through Nodus Synchronizer). Once the import has been completed, the Customer can assign themselves a user name and password as shown below. PRE-REQUISITES: The customer record inside GP must have the following information populated prior to the import: 1. Phone Number: Customer Account in GP must have a phone number since Nodus uses customer s registered phone number as one of the criteria to activate the account. 2. Email Address: Customer Account in GP must have an email address assigned under the Primary Address record. NOTE: If there is more than one email addresses needed, they can be separated by either comma or semicolon. 3. Activation Code: An automatically generated code from epay as the customer record is imported from GP into epay. It is used to activate an existing customer account on epay. By default, the activation code is embedded into the Activation URL variable on the New Customer Import email template. Upon clicking on the Activation URL, the activation code will auto-populated onto the Customer Activation page on epay. 113
Steps to Activate an epay account: 1. Go to the main epay User site log-in page 2. Click the Activate button. A registration window appears 3. Fill out the requested information. The Customer Number must be the same as the Customer ID used by the Dynamics GP Customer Maintenance window. 4. The username can be in the following forms: email address, Customer Number/ID, standard web user name. 5. Click the Submit button to activate the user account NOTE: The Registered Phone Number field only accepts numbers no special characters. 114
Figure 4-1 Activate Button Figure 4-2 Customer Registration 115
4.1.3. Site Log-in There are three types of User IDs that can be used by the customer as a log-in. In each case, the Customer home page will initially load. Customer ID Customer e-mail address Customer chosen user name 4.1.3.1. Log-in Using Customer ID During account activation, if the User Name field is populated with the Dynamics GP CustomerID, then the user must log-in to epay site with the same CustomerID. Figure 4-3 Dynamics GP Log-in 116
4.1.3.2. Log-in Using E-Mail Address The customer can also use their e-mail address to log-in. To do this: 1. Click the Activate button 2. When filling out the Registration form shown in the accompanying figure, type the e-mail address in the User Name field 3. When finished, click the Submit button This field can also be set by an Admin in the Manage Users or Register Customer sections. Figure 4-4 Logging in with e-mail Address 117
4.1.3.3. Log-in Using a Customer Chosen User Name The customer can also use custom user chosen name to log-in. To do this: 1. Click the Activate button 2. When filling out the Registration form shown in the accompanying figure, type the custom user name in the User Name field 3. When finished, click the Submit button This field can also be set by an Admin in the Manage Users or Register Customer sections. Figure 4-5 Log-in with Customer Chosen User Name 118
4.1.4. Additional Log-in Management To help manage log-in information for a customer account with many users who need to sign onto epay, the Manage Additional Logins page provides functionality to look-up, edit and delete login accounts. Inputting a name into the search field will display a list of all accounts with that name. NOTE: This page can only be accessed by logging on as a primary user. The primary user is the first user that got registered on epay. From Admin Portal, the primary user is marked with an asterisk next to the registered username. 4-6 Manage Additional Log-ins 119
4.1.4.1.Edit an Account To edit an account, click on the Edit name in the row with the account name, then make any changes when the form appears with the account information. NOTE: Users are not able to edit the Username field. If it needs to be changed, delete the account and create a new account for the user. 4.1.4.2.Create a New Account To create a new log-in account, click the Create a New Account link. When the Create Additional Log-ins window opens, fill out the account information and click Save. When the form is saved, verify that the account was created in the Manage Users area of the Administration section of epay Advantage. NOTE: To delete an account, click the Delete link in the display box. 4-7 Create Additional Logins 120
4.1.5. Accessing epay using Customer or CSR User Accounts This section shows how to look up customer accounts and change/update customer information. The processes described in this section are the same for CSRs and customers with one exception: CSRs must choose a customer by clicking the Lookup icon while Customers are automatically logged onto their home page (a Parent account does have the option of clicking an icon to locate related child accounts). 4.1.5.1. Look up Customers Parent/Child Accounts If a customer has more than one account, a list of associated child accounts can be viewed by clicking on the Lookup icon. NOTE: Parent accounts have the ability to perform all customer functions on a child account, including making payments, updating profile information, and setting up payment plans. Figure 4-8 Lookup Customers - Child Accounts #1 1. Once the icon is clicked, the Lookup Customer page opens = Parent Account 121
= Child Account 2. Choose an account by clicking anywhere in the row where the account is located 3. The home page will change to represent the account chosen NOTES: If a customer has several accounts, typing a full or partial customer number or name and clicking the Search button will find a specific account. To return to the original list of accounts, clear the Keyword box and click the Refresh button. A Customer will see only the main account and child accounts, if any exist. A CSR will see all Customer/Assigned accounts. The lookup customer list automatically filtered all inactive customer(s) from Dynamics GP. To filter on-hold customer(s) as well, checkmark the box Hide On-hold. 4.1.5.2. Update CSR Profile CSR > Profile To update an e-mail address: after logging in as a CSR, navigate to this location and change the existing address and click the Save button To change a password: 1. Type the current password in the appropriate field 2. Type the new password in the New Password field 3. Re-type the new password in the Confirm New Password field 4. Click the Save button NOTE: Changing a CSR user name requires an Administrator to delete or update the current CSR account and replace it with an account that has the desired new user name. 122
Figure 4-9 Update CSR Profile 123
4.1.5.3. Update Customer Profile Your Account > Profile 1. After logging in, navigate to the Profile page 2. Fill out the form and click the Save button NOTE: the CSR can also change a customer profile. The CSR must first select the customer from the lookup icon, then use the steps listed above. Figure 4-10 Update Profile 124
4.1.5.4. Update Customer E-Mail Address Your Account > Profile 1. From the main menu, navigate to the customer Profile page 2. To make the update, type the new address in the Email Address box and click the Save button NOTE: the CSR can also update the customer e-mail address. The CSR must first select the customer from the lookup icon, and then follow the instructions listed above. Figure 4-11 Update Customer/CSR E-mail Address 125
4.1.5.5. Update CSR E-Mail Address CSR > Profile 1. Log in as a CSR 2. From the main menu, navigate to the CSR Profile page 3. Type the new e-mail address in the Email Address text box and click the Save button 4.1.5.6. Reset Password Your Account > Profile To access the reset password functionality, sign on as a Customer and navigate to the Profile page, then scroll down to the bottom of the page. Fill out the password form shown in the accompanying figure and click the Save button. The new password is also e-mailed to your registered e-mail address NOTE: CSRs can also reset the customer password. The CSR must first select the customer from the lookup icon, and then follow the instructions listed above. 126
Figure 4-12 Reset Password 127
4.1.8.1 Create New Wallet Item Your Account > Wallet A wallet is a location where echeck or credit card information is held to make payments when needed. Multiple wallet items can be created. To create a new wallet item: 1. Log-in as a CSR or Customer and navigate off the main menu to the Wallet page 2. Click on Add New Entry option 3. The Wallet Entry/Edit Information form will clear out 4. Mark the Credit Card or echeck button 5. Enter a Wallet ID description 6. If credit card is chosen, add the card information see the figure below 7. If echeck is chosen, new bank information fields will appear. Enter the appropriate bank details 8. Fill out the remaining fields as needed 9. Click the Submit button 10. The new wallet item appears at the top of the page in the Wallet section 4.1.8.1 Edit Wallet Items Your Account > Wallet 1. To update credit card information, navigate to the Wallet page 2. From the list of Wallet Items, click the Edit icon ( ) for the card or echeck that requires editing 3. The wallet information will be populated into the Wallet Entry/Edit Information n 4. Update the appropriate information 5. Click the Save button to save the information. 6. The credit card information can be deleted by clicking the Delete icon ( ). NOTES: IMPORTANT: A credit card number cannot be changed once saved in the wallet, a new wallet entry should be created with the new credit card number. User can still edit the expiration date and card holder s information. 128
4-13 Add to Wallet 129
4-14 User Wallet 130
4.1.5.9. Account Summary This is the opening page for epay Advantage. It gives at-a-glance convenience by providing summary information such as an overall Outstanding Balance. tables displaying partial list of existing outstanding invoices and payment activities.. User can also view a list of payments that are scheduled to be processed in a future date. 4-15 Account Summary 4.1.5.10. View/Filter Posted Account Receivable Invoices (Paid Transactionss) 131
Your Account > Invoices > Paid Transactions If looking for a history of paid invoices, navigate to the Paid Transactionss page. A list of paid invoices is displayed The entire grid can be sorted by its column titles, e.g., the amount column can be sorted by highest to lowest or vice versa 1. User can search for paid transactions by Transaction Date or Transaction Number by selecting an option from the drop-down menu. 2. Choose All radio button to search for all or enter specific value range From date and To date to filter documents range. 3. Select a Max Results value to display a preset number of documents. Figure 4-16 View Paid Invoice Documents 132
4.1.5.11. View Outstanding Invoices Your Account > Invoices > Outstanding Invoices 1. Navigate to the Outstanding Invoices page 2. User can search for paid transactions by Transaction Date or Transaction Number by selecting an option from the drop-down menu. 3. Choose All radio button to search for all or enter specific value range From date and To date to filter documents range. 4. Select a max results value to display a pre-set number of documents 5. Click on an invoice number to display the invoice detail 6. The grid can be sorted by its column titles NOTES: A full list of outstanding invoices can be exported to an Excel spreadsheet by clicking the Export link at the bottom of the invoice list. Click Select All to pay for all invoices at once. Clicking Clear Selected unchecks all selected invoices. The invoice can be displayed in PDF format by clicking the PDF button on the invoice details page. Figure 4-17 Outstanding Invoices 133
Figure 4-18 Invoice Details 134
4.1.5.13. View and Track Payments (Payment History) Your Account > Payment History 1. To view a list of payments, navigate from the main menu to the Payment History page 2. A searchable list of payments can be filtered for several conditions, including: Payment number Type of Payment (cash receipt, credit memo, Return etc.) Created Date Amount. 135
Figure 4-19 Recent Activities 3. User can search for payments by Transaction Date or Transaction Number by selecting an option from the drop-down menu. 4. Choose All radio button to search for all or enter specific value range From date and To date to filter documents range. 5. Select a Max Results value to display a specific number of documents 6. Clicking on any Payment Number link shows the payment receipt for a particular Invoice 7. Click on a receipt link and a receipt copy window opens NOTE: A copy of the payment receipt as shown in the figure below - is automatically sent to the customer s registered e-mail when the transaction is completed. 136
Figure 4-20 Payment Confirmation 137
4.1.5.14. Payment Deposits Your Account > Invoices > Process Prepayment epay can take advanced payment from customers in order to handle customer activities such as preordering items. These prepayments will be created as unapplied cash receipts to Dynamics GP and displayed in epay on the Payment History page. NOTE: This feature can be disabled in the administrative section of epay Advantage. Figure 4-21 Process Prepayment 138
4.1.5.15. Apply Existing Credit Your Account > Invoices > Apply Existing Credit To apply an existing credit to an open balance, open the Apply Existing Credit page to view a list of documents where an existing credit exists. Figure 4-22 Apply Existing Credit 1. Click the Select this button to choose a document to be used to apply against an outstanding invoice. 2. The Outstanding Invoices page opens to display current open invoices 139
Figure 4-23 Apply Existing Credit - Outstanding Invoices 3. If the credit balance is the same amount or larger than the open invoice to be chosen, mark the Pay in full checkbox -OR- Enter the amount of the existing credit to be applied towards the open invoice in the Amount textbox NOTE: Multiple invoices can be selected if the total is not larger than the credit to be applied. 4. Click the Pay button 140
Figure 4-24 Apply Existing Credit - Confirmation 5. A confirmation page opens that will show two elements: The selected invoice(s) with their original balance and the amount to be applied towards that balance The original existing credit and the amount being applied towards the invoice and the remaining credit balance from the credit document 6. If the information is correct, click the Confirm button 7. An Applied Credit Receipt window will open and the user is returned to the Existing Credit page if more credit transactions need to be processed. Figure 4-25 Apply Existing Credit - Applied Credit Receipt 4.1.6. Processing a Payment with Multicurrency If your company s functional currency is different from the payment transaction s currency itself, then you are processing the payment in multicurrency mode. 141
To enable processing a payment in different currencies on epay, please login to epay s web portal as an admin user. From the Web URL under the Address bar, change the page to point to 'Admin/MultiCurrencySettings.aspx Admin Page will reload and bring you to the Multicurrency Setup page below: Figure 4-267 Admin Multicurrency Settings If all existing currency types from Dynamics GP have not been imported into epay website, please click on the link Import currency information from back office. Depend on the foreign currency your company is accepting from the customer, the Setup ID to be used to process with that particular currency needs to be assigned. Steps to assign Setup ID to a currency ID 1. Ensure that the Setup ID has been created from Nodus Connection Manager. (Refer to Create Setup ID from Nodus Connection Manager under Transaction Processing Options section above for more details) 2. Using the Credit Card Setup ID drop-down box next to that currency, select the intended Setup ID from the drop-down list. NOTE: Nodus currently supports 1 setup ID per payment gateway account. 3. Do the same with echeck Setup ID if your company also accepts echeck/ach with foreign currency. 4. Click Save to save changes. How It Works 142
With epay, depends on the assigned currency on the GP Sales document of the customer, epay will determine which Setup ID to use to process the payment transaction. IMPORTANT NOTE: Existing Dynamics GP (9.0, 10.0 and 2010) has a limitation when it comes to processing payment with multicurrency. The limitation is the Cash Receipt Payment document cannot be applied against customer s outstanding invoice(s) unless the Payment Cash Receipt document has already been posted. Due to this limitation of GP as well as econnect, all payment documents generated from epay will not be automatically apply against the invoice(s) selected by user once the payment document integrated back to Dynamics GP. GP user must first post the payment document, then using the Apply Sales Documents window to manually apply the payment to the corresponding invoice in GP. Quick Tip: All payment documents created from epay will have the Invoice Document Numbers(s) populated on the Comment field. That is the invoice document(s) that epay user has chosen to apply the payment against on epay. Using this information, GP user would know which invoice(s) this payment needs to be applied against later. 4.1.7. Integrating with PayPal Hosted Payment Page ** This feature is only available with epay Tokenization for PayPal Payflow Pro gateway. Tokenization reduces the scope of PCI Compliance Requirements when it comes to credit card storage. With Tokenization, epay will no longer stores encrypted credit card data since credit card data are now being stored at the gateway level. Therefore, merchant no longer needs to worry about protecting stored sensitive credit card information. However, the credit card s point-of-entry still resides on the application level so technically merchants still touches credit card data. Bundled with Tokenization version, epay helps merchants achieve PCI Compliance much easier by collecting sensitive credit card information on a web form hosted by PayPal and pass them along with transaction data securely to PayPal server. With PayPal Hosted Payment Page, the point of entry for credit cards will longer belongs to the epay site; therefore, it will reduce the complexity of PCI Compliance self-assessment process for merchants. On epay, all the controls on web forms where the credit card is being accepted from users will be replaced with PayPal Hosted Payment Page. Accepted credit card displayed on the embedded PayPal Hosted page can be configured at the PayPal Payflow Pro gateway account level. 143
Figure 4-278 PayPal Hosted Payment Page 4.1.8. Payment via Paylink ** This feature is only available with epay Tokenization for PayPal Payflow Pro gateway. epay is able to generate and email a payment link to customers. Customers may click and make a payment against the outstanding invoice associated with the provided link without having to login to epay. There are couple methods available for Paylink. 4.1.8.1 Paylink as Express Pay Using Outstanding Invoices Report from Admin Portal, both CSR and Admin user can generate an Express Pay Notification email on-the-fly to send out to designated email address. Paylink will be included as a payment URL on the email notification where customer can click through to be redirect to a payment page prepopulated with invoice information. CSR and/or Admin user can embed Paylink into an epay email template that support the variable [[[PaylinkURL]]]. Figure 4-289 Sample Express Pay Notification Email 144
Customer can view the invoice details, verify and/or the billing information and enter payment information to submit the payment without having to login to the epay portal. Figure 4-30 Express Pay Details and Payment Once the payment has been processed successfully, customer is presented with payment confirmation page. The payment will be integrated into Dynamics GP normally as a Cash Receipt document and will be applied against the same invoice in GP. NOTE: Express Pay currently does not support partial payment and multiple tenders against the same transaction. NOTE: One Paylink will be assigned per Invoice document per email notification. 145
Figure 4-31 Payment Confirmation from Express Pay 4.1.8.2 Paylink with Credit Card Advantage (CCA) **Using Paylink in conjunction with Nodus CCA product. CCA only supports Paylink with GP SOP module. At times, due to PCI Compliance complexity, merchants might not even want to allow their internal users to enter credit card information directly into GP. Using Paylink feature, merchant can have their customer enters credit card payment information against epay web form themselves. Paylink will be embedded into the CCA Transaction Notification email to be sent out to designated customer s and sales representative s email address. Below are the steps to setup & initiate Paylink from CCA. 1. Select an existing PayPal Setup ID from CCA 2. Click on Options button 3. Checkmark PayPalHostedCheckOutSetup checkbox to enable the feature 146
4. Click on PayPal Hosted Checkout Settings button to configure connection to epay portal Figure 4-32 Configure CCA to use epay s Paylink 5. Enter the required information into the fields below and click OK a. Store ID: epay site s Store ID (epay Admin portal > Settings > Back Office Settings > Back Office tab > Store ID field) b. Client URL: <epaysiteurl>/api/ccatranxservice.sv c. User Name: local administrator user of the machine d. Password: password of the user Figure 4-33 Configure epay Web Service Connection with CCA 147
6. Create a Sales Order or Invoice from SOP Sales Transaction Entry in Dynamics GP. 7. Initialize CCA Transaction Entry window 8. From etransaction Entry window, checkmark Send Payment Link. Figure 4-34 Enable Paylink on CCA etransaction Entry window 9. From etransaction Entry window, checkmark Send Payment Link checkbox. 10. Enter both email address for customer and CSR. Click Confirm button. Note: Both emails are required. Figure 4-35 Enter required email addresses 11. Receive a confirmation message once email sent successfully. 148
Figure 4-36 Sample CCA Transaction Notification Email Customer can view the invoice information, verify and/or update the billing information and enter payment information to submit the payment without having to login to the epay portal. Figure 4-36 CCA Transaction Details Page Once the payment has been processed successfully, customer is presented with a confirmation page. 149
Figure 4-37 CCA Transaction Confirmation Page IMPORTANT NOTE: The transaction is processed as a Book (Pre-authorize) transaction on epay and will be integrated back into CCA Transaction table (MS273505). The payment can be finalized and captured from GP using native Ship transaction from CCA. For further details on CCA s supported functionalities, please also check Nodus Credit Card Advantage User s Guide. 150
4.2. Make Payment against a Posted AR Document 4.2.1. Making a Credit Card Payment Your Account > Invoices > Outstanding Invoices 1. Navigate to the Outstanding Invoices page 2. Check the box in the Pay In Full column by the invoice(s) to be paid in full. As invoices are marked for payment or partial payment, a running total is kept in the Selected Invoice List at the bottom of the page 3. If making a partial payment, enter the payment in the Amount text box NOTE: Click Select All to pay for all invoices at once. Clicking Clear Selected unchecks all selected invoices. 151
Figure 4-29 Outstanding Invoice List 152
4. Verify the total amount being paid in the Review & Pay page 5. Click the Pay button to pay the designated amount and a Payment Options page loads Figure 4-30 Payment Options 6. Under Payment Options, select an existing credit card from the list 153
7. Use a new credit card entry New Entry - Click the Add New Entry option a) Choose Credit Card radio button as payment type b) Give this payment method a name in the Wallet ID: field. (something that identifies the name of an account) c) Fill out the applicable information to create a new credit card entry d) Checkmark Save to Wallet to save for future use e) Checkmark Set as Default to save as a default entry NOTE: A payment can be made using an existing or saved credit card or a new card (not saved in Wallet) can also be used for payment. 8. Select either Pay Now or Pay Later option Pay Now submits the credit card information for immediate payment Pay Later allows a date to be set for submission of the card. Click on the calendar icon, click a date and it will populate the Pay Later box 9. Click the Submit button to process the credit card payment information 154
Figure 4-31 Payment Options 155
4.2.2. Making an echeck Payment Your Account > Invoices > Outstanding Invoices 1. Navigate to the Outstanding Invoices page 2. A list of invoices opens 3. To pay an invoice, check the box in the Pay In Full column by the invoice(s) to be paid in full or enter a partial payment amount. As invoices are marked for payment or partial payment, a running total is kept in the Selected Invoice List at the bottom of the page 4. When finished adding invoices, click the Pay button and the Review & Pay window opens 5. Under Payment Options, select an existing echeck from the list 6. Use a new echeck entry New Entry - Click the Add New Entry option a) Choose echeck radio button as payment type b) Give this payment method a name in the Wallet ID: field. (something that identifies the name of an account) c) Fill out the applicable information to create a new echeck entry d) Checkmark Save to Wallet to save for future use e) Checkmark Set as Default to save as a default entry NOTE: A payment can be made using an existing or saved echeck or a new echeck (not saved in Wallet) can also be used for payment. 7. Select either Pay Now or Pay Later option Pay Now submits the echeck information for immediate payment Pay Later allows a date to be set for submission of the echeck. Click on the calendar icon, click a date and it will populate the Pay Later box. 10. Click the Submit button to process the echeck information 156
Figure 4-32 echeck Payment Form 157
4.3. Scheduled Payments 4.3.1. View Scheduled Payments Your Account > Scheduled Payments 1. Navigate to the Scheduled Payments page 2. Scheduled Payments shows the list of all payments scheduled for future dates (if Pay Later is chosen) Figure 4-33 Scheduled Payments 3. Clicking on any Payment Number in the Payment Number column opens the Payment Receipt window showing all the details of a particular payment that has been scheduled (see figure 4-32 below) 4. Customer can cancel a Scheduled Payment by clicking the Cancel button in the same row 5. Click the Reprocess button if a previous transaction attempt was not successful NOTE: Installment Payment Plans cannot be cancelled and so they are deactivated/grayed out whereas a Regular Payment can be cancelled at any time. 158
Figure 4-34 Paid Invoice List 159
4.3.2. New Installment Payment Plan Pay by Installments > New Payment Plan Log onto epay User Site as a CSR and create a new installment plan. Fill out the form according to the details described in the table below. NOTE: Only a CSR can create an Installment Payment Contract. Installment Payment is the optional module that needs to be purchased additional from epay. FIELD Memo Customer # Customer Name Invoice # Down Pymt Date First Installment Date Invoice Total Invoice Balance Down Pymt Amount Annual Interest Rate DESCRIPTION Fill out the memo field with a description of the payment contract The Customer Number field is automatically populated when a customer is chosen by the CSR The Customer Name field is automatically populated when a customer is chosen by the CSR After a customer is chosen, the CSR clicks this icon to choose a specific invoice to be assigned an installment payment contract. Once chosen, the invoice number populates this field. List the date the down payment was received NOTE: This is automatically set but can be changed by the CSR Day that the first installment payment is due. NOTE: This is automatically set but can be changed by the CSR The Invoice Total field is automatically populated when an invoice is chosen by the CSR The Invoice Balance field is automatically populated when an invoice is chosen by the CSR If needed, this amount is manually entered The interest rate is manually entered by the CSR # of Payments The number of payments is manually entered by the CSR 160
FIELD Payment Frequency Interest Type Wallet ID Payment Setup ID DESCRIPTION The frequency of installment payments is selected from the droplist options The Interest Type is chosen from droplist options Clicking the Wallet ID Lookup icon brings up a list of payment sources (credit card, echeck) available Choosing a payment source will automatically populate the card number and expiration (or bank routing number and account fields if echeck is used) NOTE: If a payment source is chosen and the CSR decides to use a different pay type, click the Wallet ID icon. Then, chose the new payment type and the previous pay source will be updated on the form. Click the icon to select a Payment Setup ID. Each Setup ID is associated to a payment gateway account. 1. Navigate to the Installment Payment Plan page 2. Chose a custom description in the Memo field, if desired 3. Click the Customer ID Lookup icon and select a customer. The Customer Name and Number fields will be automatically populated 4. Click the Invoice # Lookup icon to select an outstanding invoice. Several fields will be automatically populated, including: Invoice # Invoice Total Invoice Balance 5. Fill in values for all fields where appropriate, including: Annual Interest Rate Interest Type Frequency Number of Payments Down Payment Amount 6. Choose a payment method by clicking Wallet ID 7. Click Save to create a new Installment Payment Contract 8. A new Installment Payment Contract is generated. If there is a deposit amount, it is automatically processed against the customer s credit card/echeck account 9. An Installment Payment Plan detail opens. If any changes are needed, click the Edit button 161
Figure 4-35 Installment Payment Form NOTE: The amortization schedule can be viewed before the payment plan is finalized. Click the View Amortization button to display the schedule. Figure 4-36 Amortization Schedule 162
4-37 Newly Created Installment Pay Plan 163
4.3.3. View/Search for an Installment Payment Contract Pay By Installments > View Installments 4.3.3.1. View Payment Receipt 1. Navigate to the View Installments page 2. All installment payments no matter active, closed or on hold are displayed 3. To view a list of payments for a contract, select Payments from the last column. This will take you to a new window called Installment Payments. 4. To view a specific payment receipt, click on the displayed payment number 5. To view the details of a particular Payment Plan, click on the details link and it will take you to a new window displaying the Installment Payment Plan Figure 4-38 Existing Installment Payments 164
Figure 4-39 Active Installment Payment Details 165
4.3.3.2. View Amortization Schedule Pay by Installments > View Installments 1. Navigate to the View Installments page 2. Click on Details for a specific contract Figure 4-40 View Installments 3. When the Installment Plan details page opens, click the View Amortization button to view the amortization schedule 4-41 Installment Amortization Schedule 166
4.3.4. Edit Installment Payment Contract Pay by Installments > View Installments NOTE: An installment payment contract cannot be edited if the contract is in a closed status. Once a contract has been closed, it cannot be re-opened. This feature is applicable only for a CSR. 1. Log-into epay as a CSR 2. Navigate to the View Installments page 3. Click on the Details link for a specific contract 4. Scroll down the Installment Payment Plan screen and click on the Edit button 5. Click on the Lookup icon next to the Wallet ID field to select a different Credit Card/eCheck for the corresponding contract 6. Click Save to complete the update Figure 4-42 Edit Installment Payment Plan #1 167
168
4.4. Recurring Invoicing Recurring Invoicing > New Invoice Contract 4.4.1. Create a Recurring Invoice Billing Contract Setting up a recurring billing invoice contract allows the CSR (and only the CSR) to create a Recurring Invoice Contract for products that can be edited at the retail website owner s convenience. This is an optional feature. To open a new recurring billing invoice contract: 1. Log onto the site as a CSR and navigate to the New Invoice Contract page 2. Fill in the appropriate fields as detailed in the accompanying table DOCUMENT OPTIONS TAB FIELDS Customer ID Memo Line items have different dates and frequencies First Invoice Date End Date Frequency DESCRIPTION Click the Select a Customer Lookup Icon on the upper right (just below the page title) and choose the customer that signed up for the recurring billing. Choosing a customer will automatically populate both Customer fields This text box permits a brief description of the transaction ID Mark the checkbox if line items have different billing dates and/or frequencies. See the section on Assign Different Start/End Bill Dates to Multiple Items for more information. Click the calendar icon to set the beginning date for the invoice. NOTE: This field will not be available if the Line Items have different start dates and frequencies checkbox is marked. If desired, choose an end date NOTE: If the recurring billing contract is to extend indefinitely, leave this field blank Choose a time period for the customer to be billed NOTE: This field will not be available if the Line Items have different start dates and frequencies 169
checkbox is marked. Contract Class ID Default Site ID DOCUMENT OPTIONS TAB Customer # Doc Type Type ID Shipping Method Payment Terms Tax Schedule Shipping Address Billing Address LINE ITEMS TAB Line Items tab Select a contract class as established in GP The default identification number associated with the website INPUT Customer name and identification number The droplist provides an option to choose between and order or invoice for the document type Non-editable, this display shows the type ID associated with a type of ID established in GP Choose a shipping method from the drop list Choose a payment term from the drop list From the drop list, choose a Tax Schedule ID. This list is populated from Dynamics GP. If the products on the invoice are tax exempt, mark the Tax exempt checkbox Click the Shipping icon to choose from shipping addresses established in Dynamics GP Click the Billing icon to choose from billing addresses established in Dynamics GP INPUT In the Line Items tab, most of the fields are editable. For example, the unit price or description can be changed on the form. 1. Click the Line Items tab 2. Click the Lookup icon 3. Click on the line for item to be added 4. Enter the amount of product in the Quantity text box 5. Repeat for each item Item Code Click the Item Code icon to open an inventory list. Clicking on an inventory amount in the Total Quantity column opens an Inventory Detail 170
window that breaks down the amount of inventory available at each site. In the Lookup Inventory Item window, click on the icon next to the desired item to load it onto the contract page Quantity Description UofM (Unit of Measure) Unit Price Ext Price Site ID Enter the amount of the item desired Provides a brief summary of the product item. This description is changeable in the Description textbox. Allows the CSR to choose a unit of measure, such as a single item or a case. The U of M type is established in Dynamics GP. The price level for a customer set in Dynamics GP. The price can be changed in the Unit Price textbox. The sub-total amount for each item. This figure (and the Total amount) changes as the price, markdown or quantity is changed. Choose a site ID based on the distribution 171
warehouse site that the inventory item is released from. Price Level Mark Down PAYMENT DETAILS SECTION Select an item price level established in GP. By default, the price level is pulled from the Customer Master s Price Level field for the selected customer. Permits the user to add a price reduction per each item. The markdown can be entered as a set amount or as a percentage. This setting is located under the Settings > Recurring Billing Settings in the Admin section. INPUT 1. From the Payment Details droplist, choose either On Account or E-Payment On Account option allows the customer to be billed at a later time and the invoice will be integrated into Dynamics as an unpaid, outstanding invoice. E-Payment sets up payment with the customer s echeck or credit card account. When E-Payment is chosen, a look-up icon appears next to the droplist that allows a payment method to be chosen from the customer wallet. 2. Enter Trade discounts if any 3. Enter Miscellaneous charges if any 4. Enter Freight charges, if any 5. Click the Save button at the bottom of the page to create the invoice contract An editable View Invoice Contract page displays. NOTE: If the End Date is not entered, the contract will display 12/31/9999 to indicate that the contract is open-ended 172
` Figure 4-43 New Recurring Contract - Document Options Tab 173
174
Figure 4-44 New Recurring Contract - Line Items Tab 175
4.4.1.1. Assign Different Start/End Bill Dates to Multiple Items Recurring Invoicing > New Invoice Contract This feature gives the user different invoice/billing options for individual items in the same order. This order flexibility allows customers to: Create different start and end times for billing for each item in the order Establish a billing frequency, such as daily, weekly or monthly for each item in the order NOTES: When all items have the same invoice billing dates, make sure the checkbox called Line items have different start dates and frequencies is NOT marked. The ability to assign different start and end dates cannot be enabled after an order has already been started. If different billing dates are needed, delete the existing items and start over. To enable this feature: 1. Mark the Line items have different start dates and frequencies checkbox 2. Click the Line Items tab 3. User the lookup icon to choose an item from inventory and make any adjustments needed in the associated fields in the line item row, such as Markdown 4. Enter a Start Date directly in the Start Date textbox or use the calendar 5. Enter an End Date directly in the End Date textbox or use the calendar. 6. Choose a billing frequency from the Frequency droplist NOTE: In addition to scheduled billing frequencies, the user can also choose a one-time billing. 7. Repeat for as many items as needed. Each item can have different start and end dates 8. Complete the rest of the form as described in the Create a Recurring Billing Contract section and click the Save button Payments processed successfully will be in the Documents Queue (Admin > Document Queue > Sent tab). To see payments that were unsuccessfully transferred to GP, click the Failed tab. Contracts are processed according to the time established in the next bill date. Invoices show up in the epay document queue when the scheduler has completed payment processing for the scheduled time period it is currently working on. Payments can also be viewed in the Payment Gateway website. 176
Figure 4-45 Setting Different Start/End Dates for Order Items 177
4.4.2. Edit the Recurring Invoice Billing Contract Recurring Invoicing > View Invoice Contracts NOTES: Only the CSR can edit a Recurring Invoice Billing Contract. NOTE: Customers cannot make changes to an existing invoice contract. However, customers can change payment details for an existing contract if that contract is not in Closed status. The Recurring Invoicing tab gives a list of invoices associated with the Recurring Invoice Billing Contract. Recurring Invoice Billing Contracts cannot be edited after their status is changed to Closed. Once closed, they cannot be re-opened. View Invoice Contract tabs Document Options Line Item tab Invoices tab DESCRIPTION Allows a view of the fields in the document options section of the original document. Allows products to be added or deleted customer that signed up for the recurring billing. Makes available a clickable invoice link that opens a window that displays details for each line item. To edit a recurring invoice billing contract: 1. Navigate to the View Invoice Contracts page 2. A list of recurring billing contracts appears 3. In the Contract header column, click a contract number 4. When the invoice contract opens, click the Edit button at the bottom of the page Figure 4-46 View Invoice Contracts 178
Figure 4-47 Edit Recurring Payment Invoice Contract 5. A contract detail page loads 6. Click the Edit button at the bottom of the page 7. Make any changes, if required. Click the Line Items tab to change line item information 8. When done, click the Save button at the bottom of the page NOTES: All existing recurring billing contracts can be viewed from this page by clicking the View Existing Invoice Contracts button. Clicking the Invoices or Recurring Invoices tab allows the following to be changed: Payment Details 179
Trade Discount Miscellaneous Freight 180
4.4.3. View the Recurring Billing Invoice Contract Recurring Invoicing > View Invoice Contracts Both customers and CSRs can view Recurring Billing Invoice Contracts by navigating to the View Invoice Contracts page. All columns can be filtered for new data views. CSR: all customer invoice contracts can be viewed if the proper Admin settings have been enabled. Customers: a parent account can view all invoice contracts for the parent company and any associated child accounts. A child account can only view its own invoice contracts. Figure 4-48 View Invoice Contracts 181
4.4.4. Place an Existing Recurring Billing Contract on Hold Recurring Invoicing > View Invoice Contracts NOTE: Only a CSR can place an existing Recurring Billing Invoice Contract on hold 1. From the main menu, navigate to the View Invoice Contracts page 2. Click on the Contract number of the invoice contract to be placed on hold 3. A detailed view page opens 4. Click on the Edit button at the bottom right of the page 5. From the Contract Status drop list, choose On Hold 6. At the bottom right of the page, click the Save button 7. A new view detail page appears. The Contract Status field should now indicate that the invoice contract is On Hold 182
Figure 4-49 Place RB Contract on Hold 4.4.5. Cancel an Existing Recurring Billing Invoice Contract Recurring Invoicing > View Invoice Contracts NOTE: Only a CSR can cancel an existing Recurring Billing Invoice Contract 8. From the main menu, navigate to Recurring Billing > Recurring Invoicing > View Invoice Contracts 183
9. Click on the Contract number of the invoice contract to be cancelled 10. A detailed view page opens 11. Click on the Edit button at the bottom right of the page 12. From the Contract Status drop list, choose Closed 13. At the bottom right of the page, click the Save button 14. A new view detail page appears. The Contract Status field should now indicate that the invoice contract is Closed Figure 4-50 Cancel an Existing Recurring Billing Invoice Contract 184
4.4.6. Skipping an Invoice Contract Billing Cycle Recurring Invoicing > View Invoice Contracts epay s Recurring Billing module provides users the ability to skip a billing cycle without having to cancel the contract and create a new one. For example, if a contract is set up for monthly billing on the 30 th of every month and on March 15, the skip functionality was used, the next billing date would be April 30. To skip a billing cycle: 1. Navigate to the View Invoice Contracts page 2. Select a contract from the Contract column 3. In the Line Items tab, click the Skip link (adjacent to the Next Invoice Date) 4. A pop-up window opens asking to verify if the billing cycle should be skipped. Click OK to verify. 5. The contract page will refresh. When it finishing refreshing, verify that the Next Billing Date in the Line Items tab has been updated NOTE: The following screenshots show 2 scenarios with skipping billing cycle. The first one was for contracts with line items having different billing date. The second was for contract where line items have the same billing date. 185
4-51 Line Items - Skip Link 186
4.5. Recurring Payment AutoPay Contracts Recurring Payment > New AutoPay Contract Recurring Payment AutoPay Contracts can be used when an alternative method of setting up a payment plan is needed for example, when setting up a charitable pledge on time or a temporary maintenance contract.both CSRs and Customers can set up new Payment Contracts or view/make changes to existing contracts. This is an optional feature. 4.5.1. Setting Up a New Payment Contract For both CSRs and Customers, navigate off the main menu to the New AutoPay Contract page. CSRs must select a customer from the Customer Lookup. Fill out the contract form as described in the accompanying table. When finished, click the Save button and a contract detail window opens. After the contract is created, an Edit button is generated on the contract form to enable and changes, if needed. DOCUMENT OPTIONS Memo Amount (Fixed) Based on invoice due date Based on document date Based on All Outstanding Invoices DESCRIPTION Fill out the memo field with a description of the payment contract Add the contract amount in the Amount field to establish the fixed amount for generated (recurring) payment documents. If a user selects this option, then Nodus AutoPay determines the payment amount based on the invoice due date. If the due date is less than or equal to the system date, then the invoice s payment will be processed. If a user selects this option, then Nodus AutoPay determines the payment amount based on the invoice document date. If the document date is less than or equal to the processed system date, then the invoice s payment will be processed. If a user selects this option, then Nodus AutoPay determines the payment amount based on all existing posted outstanding invoices (including invoices with future document date) 187
First Payment Date End Date Frequency Wallet ID Schedule the initial date for processing the payment by clicking the calendar icon and choosing a date There are 3 available options: No End Date: this contract will be evergreen End after # of defined occurrences End on the specified future date using the calendar lookup Choose a payment frequency from the Frequency drop-down list Click the Wallet icon and choose an existing credit card or echeck wallet entry to be used with this contract. Figure 4-52 New Payment Contract 188
Figure 4-53 New AutoPay Contract Detail 189
4.5.2. View/Edit an AutoPay Contract Recurring Billing > Recurring Payments > View AutoPay Contracts NOTE: A payment contract cannot be edited if its status is closed. Also, once closed, a payment contract cannot be re-opened. 1. For both CSRs and Customers, navigate off the main menu to the View AutoPay Contracts page 2. A page loads with a list of payment contracts 3. Click on the Contract number of the contract to be viewed/edited 4. If a data field needs to be changed, click the Edit button 5. Make any changes and click the Save button 6. The detail view page returns 7. Click the Back button to see the list of contracts again Figure 4-54 View AutoPay Contracts 190
Figure 4-55 AutoPay Contract - Edit 191
4.5.3. Cancel an Existing Payment Contract Recurring Billing > Recurring Payment > View AutoPay Contracts 1. Both CSRs and Customers can cancel an existing Payment contract by navigating to the View AutoPay Contracts page 2. A page loads with a list of Payment Contracts 3. Click the Contract number of the contract to be viewed/edited 4. Click the Edit button 5. From the Status drop list, change the status from Active to Closed 6. Click the Save button 7. The view/edit detail page returns. The Status field should now indicate that the payment contract is Closed Figure 4-56 Cancel Payment Contract 192
4.6. esop Advantage (Web Sales Order Entry) Overview CSR > esop Advantage esop Advantage provides a quick method of creating orders that are placed on account or are paid immediately. This solution integrates with Microsoft Dynamics GP to automate sales order processing. Because esop Advantage is a web-based sales order entry form, any company s Sales representative can enter a sales order. The process involves logging into the portal, and creating a transaction for an existing customer. The generated transaction will automatically sync back to Dynamics GP. This can be done without taking up a Microsoft Dynamics user license. 4.6.1. Using esop Advantage Only a Customer Service Representative (CSR) is able to create a Sales Order Entry for customer(s). The generated document will be integrated over into the Dynamics Dynamics GP SOP (Sales Order Processing) module. NOTE: Currently esop Advantage supports Invoice and Order type documents. To use esop Advantage: 1. Log onto the esop application as a CSR and navigate to the esop Advantage page 2. Click on the lookup icon next to the Customer Number box to open an existing customer or type the customerid directly into the Customer Number textbox. If the customer exists in GP, esop Advantage will populate the customer s name and customer ID in the Sales Order Entry form. 3. Fill in the appropriate fields as detailed in the accompanying table. All non-editable fields are automatically generated. 4. When fields have been completed, click the Submit button to generate the sales order 5. After submitting the order, the application will automatically display a receipt 6. Press the Ctrl and P keys at the same time to print a receipt 4.6.2. Viewing the esop Advantage Sales Order A historical record of sales orders can be viewed in Dynamics GP. 193
esop Advantage Fields Table esop Advantage FIELDS Type/Type ID Date Document number Batch ID Customer ID Default Site ID Customer name Customer PO Number Ship To Currency ID Shipping Method Tax Schedule DESCRIPTION Choose the type of transaction from the droplist: Invoice or Order. Date document is created Identification number assigned to the document by the system This setting is automatically generated, but is editable. When submitted, the populated Batch ID is sent to Dynamics GP along with the transaction. Customer identification number This is the location for inventory. Choose the location where product items are located. Additional locations can be added through Dynamics GP. Name for the customer entered in the system An optional field for reference purposes Choose a pre-set shipping location from the droplist, including Warehouse, Primary or Office. Additional locations can be added through Dynamics GP. Currency identification established in Dynamics GP Choose a shipping method from the drop list From the drop list, choose a Tax Schedule ID. This list is populated from Dynamics GP. NOTE: If customer is viewed as Tax Exempt if: 1. Tax Exempt 1 and Tax Exempt 2 fields in Dynamics GP > Customer Maintenance are populated with any type of values. 2. Customer is assigned a tax exempt Tax Schedule ID in Dynamics GP, meaning the Tax Schedule ID has a 0.00% tax rate. 194
esop Advantage FIELDS Bill To DESCRIPTION Select a bill to entity Payment Details Choose a payment term from the drop list. If E- Payment is chosen, a Wallet lookup icon appears. Clicking on the Wallet icon allows the user to choose a type of E-Payment. The wallet can be updated as described in the Create a New Wallet Item section of this user s guide. Trade Discount Freight Miscellaneous LINE ITEM SECTION Item Code Enter a trade discount amount Enter a charge amount for freight costs Enter any miscellaneous charges in this textbox DESCRIPTION Click on the Lookup icon to open a list of product items. Click on a product item to add it to the Sales Order form. NOTE: If the item is not in stock, esop will open a notification window, indicating that the item is backordered. The item can still be placed on order, even if back-ordered. The product item code can also be added manually in the Item Code textbox. Another option is to type in the item number into the Item Code field. 195
esop Advantage FIELDS Quantity Description Unit of Measurement (U of M) Unit Price Ext Price SHIPPING Site ID Qty Fulfilled Ship to Mark Down Qty to Back Order Shipping Method DESCRIPTION Enter an item quantity. The Ext Price field will update Default description of the item as entered in Dynamics GP. The description can be changed by clicking in the textbox. The droplist provides quantity options (when available) such as order products by the case or individually. Price and quantity variables associated with options such as case quantities, are generated by Dynamics GP. Item pricing pulls from GP based on the customer s assigned Price Level. Item pricing pulls from GP based on the customer s assigned Price Level. DESCRIPTION The identification number for the location of the inventory item. The amount currently in inventory to be shipped Droplist gives a choice of Ship to locations. These locations are established in Dynamics GP. New locations can also be created in esop: 1. Click on the Ship To icon located in the top portion of the sales form 2. When the Look up Customer Addresses window opens, click on the Create New Address link 3. A new window opens. Fill out the Create New Customer Address form 4. Click Save and a new customer address is created This field allows the user to apply an immediate discount on the product item. Amount of the order item not in stock Droplist provides a choice of shipping methods, such as local delivery, ground delivery, etc. 196
esop Advantage FIELDS Base Cost Price Level Requested Ship Date DESCRIPTION Standard or base cost as set up in GP. The user can hide the due date in the Administration section under esop Settings. Choose from customer price levels established in Dynamics GP. Enter the requested shipping date or select from calendar. esop Advantage Sales Order Entry Form 4.6.3. esop End of Day Report 197
CSR > esop End of Day The End of Day Report gives the user the ability to view and structure sales information in any timerelated format desired, such as daily, monthly or annual. End of Day functionality allows the user to review the various transaction types, including: Cash Credit Card On Account activities To view the End of Day report: 1. Choose a single day or a date range 2. Select a payment type or choose All to view all transactions for the time period selected 3. If desired, choose a CSR and the page will automatically update with transaction information for the CSR selected NOTE: Clicking on the document heading will return the user to the Receipt confirmation page. Figure 4-57 esop End of Day Report 4.6.4. esop Order History Your Account > Order History NOTE: This page is only viewable by the CSR and it is only available with esop module. The order history page allows the user to view a filterable list of esop orders and/or invoices. When opened, the list is populated by orders associated with the selected customer. If the original esop order document has been converted to an invoice within Dynamics GP, the original Order document number will be listed under the Invoice Number. This order list can be searched in several ways: 198
By date By document number By PO number The order list can be sorted by clicking on a column header Clicking on a document number will open a details window Figure 4-58 Order History 199
4.6.4. CSR Administrative Page Access CSR > Administrative Pages This feature gives the CSR the ability to work with administrative settings without having to: Establish a separate administrator ID for that CSR Require an administrator to make changes that could be assigned to a CSR CSRs allowed administration access have the same ability to work with epay functionality as an administrator. To allow CSRs access to the administrative section: 1. If using epay for the first time, create CSR users 2. In the administration section, navigate to Manage Users > User Group Settings 3. Create a CSR group and add all CSRs that need to be given access to the Administration section NOTE: For CSRs that are NOT to be granted access, it is not required to do anything else. Simply leave them off the user group that is granted access. 4. Navigate to Manager Users > Group Permissions 5. Click Edit Permissions 6. In the Administrative Permissions section, click Select All or mark the administrative permissions to be granted the CSR group 7. Click the Save button 8. The CSRs will now be able to access administration settings by logging on as a CSR and navigating from CSR > Administrative Pages NOTE: When navigating to the administration settings section, the CSR remains logged on as a CSR and has continual access to the CSR menu. When finished with an administrative functionality, the CSR must again navigate to CSR > Administrative Pages to access additional administration settings. Figure 4-17 CSR Administrative Pages 4.7. Mobile epay 200
This feature gives the customer the ability to pay for their outstanding invoices via their mobile devices. Currently, epay supports 2 types of mobile phone: iphone and Android Phone. For tablet devices such as ipad, epay will always default user to desktop version instead of mobile version. To switch from desktop version to mobile version, please see the section How to access epay Mobile site below. Mobile epay is installed as a different site folder with the name m under the main epay web site folder. Figure 4-59 epay Mobile Site folder 4.7.1. How to Access epay Mobile Site From a Desktop Computer/Tablet Device: In order to access the epay s mobile site, on the address bar, type in the regular epay website address, then add m into the URL right before the actual landing ASPX page. Example: Regular epay site: http://epaysiteurl/login.aspx epay s Mobile site: http://epaysiteurl/m/login.aspx 201
From a Mobile device: In order to access the epay s mobile site, on the address bar, type in the regular epay website address, epay will automatically redirect the user to the mobile site if user is using the mobile device that is currently supported by epay. Example: Regular epay site: http://epaysiteurl/login.aspx epay s Mobile site: http://epaysiteurl/m/login.aspx Figure 4-60 epay Mobile Site - Login page (view from iphone) 4.7.2. How to Use epay Mobile Site 202
Mobile epay is currently supported only customer user, not admin or CSR user. Customer can use their existing username from the desktop version to login to the mobile version of epay. NOTE: User can choose to save their username for future login by sliding the bar from left to right under Save My User ID to turn on the option. 4.7.2.1. Account Summary Page Once user has logged in to epay, the landing page will be the Account Summary page where it displays the summary of the customer s account. a. Outstanding Invoices: displays the number of existing outstanding invoices & the total outstanding balance for the account. b. Past Due Invoices: displays the number of past due invoices and the total past due balance for the account c. Scheduled Payments: displays the number of payments scheduled to be paid in the future and the total scheduled balance for the account. d. Express Pay: clicking this button will allow user to proceed to pay a lump sum for all existing outstanding invoices. e. Invoice History: clicking this button will allow user to search for paid invoice(s). f. Wallet: user can maintain his/her existing wallet for credit card NOTE: Mobile epay currently does not support echeck wallet entry. g. Profile: user can view his/her default billing address under Profile Figure 4-61 epay Mobile Site Account Summary page 203
4.7.2.2. Making Payment Against Outstanding Invoice(s) Account Summary > Outstanding Invoices Once user clicks on Outstanding Invoices option from Account Summary page, user will see the list of all existing outstanding invoices for the account. The list could expand to several pages as each page can only display up to 10 invoices. Figure 4-60 epay Mobile Site Outstanding Invoices page To view the details of each outstanding invoice from the list, user can click on the view the details of the invoice. The following details will be available for user: icon to 1. Date: Invoice s document date 2. Invoice #: Invoice s document number 3. Original Amount: the original balance for the invoice document 4. Due Date: the due date for the invoice document 5. Balance Due: the amount due or remaining balance for the invoice 6. Comment: additional information (if available) for the invoice 204
Figure 4-61 epay Mobile Site Invoice Details page After viewing the details of each outstanding invoice from the list, user can click on the button Add to Pay List to add the selected invoice to the to be pay list. The amount to be paid for can be adjusted (if partial payment is allowed by the site admin). Figure 4-62 epay Mobile Site Add to Pay List 205
Once adding the invoice to the to be pay list, user will be brought back to the Outstanding Invoices list. Here, user can add additional invoice(s) to the list using the same steps above or click Check Out to proceed making the payment. Figure 4-63 epay Mobile Site Check Out Payment After clicking on Check Out, user will be brought to the Payment page. Here, user can review the to be pay invoice selection list. User can click Continue button when ready to proceed to enter the payment information. Figure 4-64 epay Mobile Site Payment Review 206
From the Payment Options page, user can select an existing wallet entry from the Wallet or enter new payment information by choosing the option Enter Credit Card from Select from Wallet drop-down list. Then, click on Continue button. NOTE: If preferred, user can checkmark Pay Later to schedule the payment to be processed on a future date by selecting Pay Date from the calendar picker. Click on Continue button to proceed to next step. Figure 4-65 epay Mobile Site Payment Schedule Once user clicks on Continue from the Payment Options page, user can review or enter the card holder s information for the credit card entry in used. If all the information is correct, user can click on the Submit button to either: 1. Submit the payment transaction to be processed immediately in real-time. 2. Submit the scheduled payment transaction to be processed in the future date. 207
Figure 4-66 epay Mobile Site Card Information 4.7.2.3. Invoice History Account Summary > Invoice History Invoice History page allows user to search for invoice(s) that have been paid in full. User can search for the paid invoice by invoice document # or by date range using invoice document date. 208
Figure 4-67 epay Mobile Site Invoice History 4.7.2.4. Wallet Account Management > Wallet Wallet page allows user to modify existing wallet entry or enter a new wallet entry. 1. To view the details of existing wallet entry from the list, user can click on the icon to view the details of the wallet. User can click on the Edit button at the bottom of the page to edit the entry. NOTE: User can only edit the account information and expiration date, not the credit card number. 2. To create a new wallet entry, user can click on the Create New button and enter all the card details and card holder s information. Click Submit to save the new wallet entry. 209
Figure 4-68 epay Mobile Site Wallet 4.7.2.5. Navigation Back button: To go back to previous page, user can click on the Back button. Sign Off button: To log out of epay, user can click Sign Off button. Figure 4-69 epay Mobile Site Navigation 210
4.8. Frequently Asked Questions Customers Can an existing Installment Payment contract be cancelled? Yes, that functionality exists in the CSR section What transactions can be undertaken with a brand new customer? New customers must be entered in Dynamics GP before any of their epay transactions can take place Can an existing Installment Payment Plan be changed? Yes, existing Installment Payment Plans can be changed by the CSR When are payments processed? Payments are processed as soon as they are electronically submitted to the Gateway CSR Do CSRs have access to the customer wallet? A CSR can add, delete and modify credit card data as well as echeck information in the customer wallet Can a CSR pay invoices on a child account? epay allows a CSR to make child account payments 211
What if incorrect payment details are entered in epay? Payment corrections must be made in the Dynamics GP database. For example, an overpayment would require a credit memo or Return issued to the customer from Dynamics GP. How long are invoice records stored? Invoice records are not deleted, so a full history is available 212
Appendix A GP Invoice Import Mapping GP Object GP Field epay Object epay Field SOP30200 SOPNUMBE Invoice InvoiceNumber SOP30200 SOPTYPE Invoice InvoiceType SOP30200 SUBTOTAL Invoice Subtotal SOP30200 FRTAMNT Invoice Freight SOP30200 MISCAMNT Invoice Misc SOP30200 TAXAMNT Invoice Tax SOP30200 TRDISAMT Invoice Discount SOP30200 DOCAMNT Invoice Amount SOP30200 CURTRXAM Invoice BalanceDue SOP30200 CSTPONBR Invoice PONumber SOP30200 BACHNUMB Invoice BatchNumber SOP30200 DOCDATE Invoice CreatedOn IVC30101 INVCNMBR Invoice InvoiceNumber IVC30101 DOCTYPE Invoice InvoiceType IVC30101 SUBTOTAL Invoice Subtotal IVC30101 FRTAMNT Invoice Freight IVC30101 MISCAMNT Invoice Misc IVC30101 TAXAMNT Invoice Tax IVC30101 TRDISAMT Invoice Discount IVC30101 DOCAMNT Invoice Amount IVC30101 CURTRXAM Invoice BalanceDue 213
GP Object GP Field epay Object epay Field IVC30101 CSTPONBR Invoice PONumber IVC30101 BACHNUMB Invoice BatchNumber IVC30101 DOCDATE Invoice CreatedOn RM20101 DOCNUMBR Invoice InvoiceNumber RM20101 RMDTYPAL Invoice InvoiceType RM20101 SLSAMNT Invoice Subtotal RM20101 FRTAMNT Invoice Freight RM20101 MISCAMNT Invoice Misc RM20101 TAXAMNT Invoice Tax RM20101 TRDISAMT Invoice Discount RM20101 ORTRXAMT Invoice Amount RM20101 CURTRXAM Invoice BalanceDue RM20101 CSTPONBR Invoice PONumber RM20101 BACHNUMB Invoice BatchNumber RM20101 DOCDATE Invoice CreatedOn RM30101 DOCNUMBR Invoice InvoiceNumber RM30101 RMDTYPAL Invoice InvoiceType RM30101 SLSAMNT Invoice Subtotal RM30101 FRTAMNT Invoice Freight RM30101 MISCAMNT Invoice Misc RM30101 TAXAMNT Invoice Tax RM30101 TRDISAMT Invoice Discount RM30101 ORTRXAMT Invoice Amount 214
GP Object GP Field epay Object epay Field RM30101 CURTRXAM Invoice BalanceDue RM30101 CSTPONBR Invoice PONumber RM30101 BACHNUMB Invoice BatchNumber RM30101 DOCDATE Invoice CreatedOn SOP30300 LNITMSEQ InvoiceEntry Sequence SOP30300 ITEMNMBR InvoiceEntry ItemCode SOP30300 ITEMDESC InvoiceEntry Description SOP30300 UNITPRCE InvoiceEntry UnitPrice SOP30300 QUANTITY InvoiceEntry Quantity SOP30300 UOFM InvoiceEntry UnitOfMeasure SOP30300 MRKDNAMT InvoiceEntry Markdown SOP30300 IVITMTXB InvoiceEntry Taxable SOP30300 TAXAMNT InvoiceEntry TaxAmount SOP30300 XTNDPRCE InvoiceEntry ExtendedPrice SOP30300 NONINVEN InvoiceEntry NonInventory IVC30102 LNITMSEQ InvoiceEntry Sequence IVC30102 ITEMNMBR InvoiceEntry ItemCode IVC30102 ITEMDESC InvoiceEntry Description IVC30102 UNITPRCE InvoiceEntry UnitPrice IVC30102 QUANTITY InvoiceEntry Quantity IVC30102 UOFM InvoiceEntry UnitOfMeasure IVC30102 MRKDNAMT InvoiceEntry Markdown IVC30102 IVITMTXB InvoiceEntry Taxable 215
GP Object GP Field epay Object epay Field IVC30102 TAXAMNT InvoiceEntry TaxAmount IVC30102 XTNDPRCE InvoiceEntry ExtendedPrice IVC30102 NONINVEN InvoiceEntry NonInventory 216
Appendix B GP Customer Import Mapping GP Object GP Field epay Object epay Field RM00101 CustomerNumber Customer CustomerNumber RM00101 CUSTNAME Customer Name RM00101 INACTIVE Customer Inactive RM00101 HOLD Customer OnHold SY01200 INET1 Customer EMailAddress 217
Appendix C Tax Detail Mapping GP Object GP Field epay Object epay Field Notes TX00102 TAXSCHID Tax TaxScheduleID TX00201 TAXDTLID TaxRate TaxDetail TX00201 TXDTLDSC TaxRate Description TX00201 TXDTLTYP TaxRate TaxType TX00201 TXDTLBSE TaxRate TaxRateType TX00201 TXDTLPCT TaxPercentage TX00201 TXDTLAMT TaxAmount TX00201 TDTAXTAX TaxAbleTax 218
Appendix D Sales Person Mapping GP Object GP Field epay Object epay Field Notes RM00301 SLPRSNID SalesPerson SalesPersonNumber RM00301 SALSTERR SalesPerson SalesTerritoryID RM00301 SLPRSNFN SalesPerson FirstName RM00301 SPRSNSMN SalesPerson MiddleName TX00201 SPRSNSLN SalesPerson LastName TX00201 INACTIVE SalesPerson Inactive 219
Appendix E Supported Document Types Module Document Type epay Location Sales Order Processing (SOP) Module Invoice Type 3 Return Type 4 Outstanding Recent Activities Invoice Entry Module IVC Type 1 as invoices Invoice Type 1 Return Type 2 Invoices Outstanding Recent Activities Receivable Management Module RM Type 1,3-6 Sales/Invoice Type 1 Debit Memo Type 3 Finance Charge Type 4 Service/Repair Type 5 Warranty Type 6 Outstanding Outstanding Outstanding Outstanding Invoice History Receivable Management Module RM Type 7-9 Credit Memo Type 7 Return Type 8 Cash Receipt Type 9 Recent Activities Recent Activities Recent Activities SOP Sales Order Processing RM Receivables Management 220
End User License Agreement (EULA) Important Read Carefully. This Nodus End-User License Agreement ( Agreement ) is a legal agreement between you (on the one hand) and Nodus, Technologies, ( Nodus ) and its OEM partner(s). ( OEM ) (on the other hand), for the software product identified above (the Product ), which includes computer software and may include associated media, printed materials, and online or electronic documentation. By installing, copying, other otherwise using this Product, you agree to be bound by the terms of this Agreement. If you, the End-User, do not agree to the terms of this Agreement, do not install or use this Product; may, however, return it to your place of purchase for a refund. This license is not a sale. Title and copyrights to the Product remain with Nodus and its OEM partner (s). Unauthorized copying of the data, or failure to comply with the provisions of this License Agreement, will result in automatic termination of this license and will make available to Nodus and its OEM partner(s), other legal remedies. IN THE EVENT OF LICENSE TERMINATION, ALL MATERIALS, DATABASES, AND DOCUMENTATION MUST BE IMMEDIATELY RETURNED TO NODUS TECHNOLOGIES, INC. WITH THE ADDRESS LISTED AT THE END OF THIS AGREEMENT. 1. End-User represents and warrants that it is authorized and empowered to enter into this Agreement. Nodus represents and warrants that it is authorized and empowered to grant the rights hereinafter set forth. 2. Nodus and its OEM partner(s) hereby grants End-User a non-exclusive, non-transferable right to use the Product, subject to the use restrictions and limitations set forth in Section 5 and Section 6 below. 3. Nodus shall provide End-User with one (1) machine-readable copy of the Product. 4. End-User acknowledges that the Product is confidential, proprietary material owned and copyrighted by Nodus. End-User agrees that Nodus and its OEM partner(s) shall retain exclusive ownership of the Product, including all literary property rights, patents, copyrights, trademarks, trade secrets, trade names, or service marks, including goodwill and that Nodus may enforce such rights directly against End-User in the event the terms of this Agreement are violated. 5. The Product is intended for use solely by End-User for their own internal purposes as an alternative electronic information source of data. The Product may only be used at the location(s) licensed and paid for by End-User to the Nodus. End-User agrees not to copy, modify, sub-license, assign, transfer or resell the Product, in whole or in part. End-User agrees not to translate, reverse engineer, decompile, disassemble, or make any attempt to discover the source code of the Product (except and only to the extent applicable law prohibits such restrictions). End-User further agrees not to download/upload the Product, in whole or in part, or to establish a network, place data on the Internet, or offer a service bureau utilizing the Product. End-User agrees to restrict access to the Product to designated employees and to use its best efforts to prevent violation of these restrictions by agents, employees and others, taking such steps and reasonable security precautions as may be necessary. End-User shall permit Nodus and/or its representative access to its premises during normal business hours to verify compliance with the provisions of this Agreement. 221
6. This license authorizes use of the Product at a single location, which shall mean a single location which uses or accesses the Product either from a computer or terminal on site or through a computer or terminal at a supporting location. 7. This Agreement shall remain in force as long as the End-User using the Product is paying the periodic maintenance fee. Failure to pay the periodic maintenance fee shall cause this agreement to expire. Nodus or End-User may terminate use of the Product and this Agreement by written notice, at least thirty (30) days prior to the termination. Within thirty (30) days after expiration or notice of termination of the Agreement, End-User shall return to Nodus, postage prepaid, all copies of the Product. Continued use of the Product or any information contained therein or supplied under this Agreement after termination, or expiration of this Agreement is expressly prohibited. 8. All UPDATES provided by Nodus and its affiliates shall be considered part of the Product and subject to the terms and conditions of this Agreement. Additional license terms may accompany UPDATES. By installing, copying, or otherwise using any UPDATE, End-User agrees to be bound by this Agreement and any terms accompanying each such UPDATE. If End-User does not agree to the additional license terms accompanying such UPDATES, do not install, copy, or otherwise use such UPDATES. 9. End-User agrees that Nodus and its affiliates may collect and use technical information End-User provide as a part of support services related to the Product. 10. End-User acknowledges that the Product is of U.S. origin and agrees to comply with all applicable international and national laws that apply to the Product, including the U.S. Export Administration Regulations, as well as end-user, end-use and destination restrictions issued by U.S. and other governments. 11. NODUS REPRESENTS THAT THE PRODUCT DOES NOT VIOLATE OR INFRINGE ANY PATENT, TRADEMARK, TRADE SECRET, COPYRIGHT, OR SIMILAR RIGHT. IN THE EVENT THE PRODUCT IS HELD TO INFRINGE THE RIGHTS OF ANY THIRD PARTY, NODUS SHALL HAVE THE OPTION EITHER TO PROCURE THE RIGHT FOR THE END-USER TO CONTINUE USING THE PRODUCT OR AT NODUS'S EXPENSE, TO REPLACE OR MODIFY THE PRODUCT SO THAT IT BECOMES NON-INFRINGING. NODUS AND ITS OEM PARTNER(S) MAKE NO OTHER WARRANTY, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE ACCURACY OF THE PRODUCT, THE MERCHANTABILITY AND FITNESS OF THE PRODUCT FOR A PARTICULAR PURPOSE. FURTHER, NODUS DOES NOT WARRANT THE COMPATIBILITY OF THE PRODUCT WITH END-USER'S COMPUTER HARDWARE AND/OR SOFTWARE SYSTEM. 12. End-User's sole and exclusive remedy for any damage or loss in any way connected with the Product furnished herein, whether by breach of warranty, negligence, or any breach of any other duty, shall be, at Nodus option, replacement of the Product or return or credit of an appropriate portion of any payment made by End-User with respect to such Product. Under no circumstances shall Nodus or its OEM Partner(s) be liable to End-User or any other person for any indirect, special or consequential damages of any kind, including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction or any and all other commercial damages or losses. Additionally, Nodus assumes no liability for damages caused by incorrect parts usage and has no responsibility to verify that the parts are correct for a customer's vehicle in accordance with the manufacturers' specifications. 13. Nodus may cancel this license at any time if End-User fails to comply with the terms and conditions of this Agreement; and Nodus may obtain injunctive relief and may enforce any other rights and remedies 222
to which it may be entitled in order to protect and preserve its proprietary rights. 14. This Agreement is the complete and exclusive statement of the understanding between the parties, with respect to the subject matter, superseding all prior agreements, representations, statements and proposals, oral or written. 15. No term or provision hereof shall be deemed waived and no breach excused, unless such waiver or consent shall be in writing and signed by the party claimed to have waived or consented. Any consent by any party to, or waiver of, a breach by the other, whether express or implied, shall not constitute consent to, waiver of, or excuse for any other different or subsequent breach. Limitation of Liability IN NO EVENT WILL NODUS OR ITS OEM PARTNER(S) BE LIABLE FOR ANY DAMAGES, INCLUDING LOSS OF DATA, LOST PROFITS, COST OF COVER, OR OTHER SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR INDIRECT DAMAGES ARISING FROM THE USE OF THE PROGRAM OR ACCOMPANYING DOCUMENTATION, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY. THIS LIMITATION WILL APPLY EVEN IF NODUS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. YOU ACKNOWLEDGE THAT THE LICENSE FEE REFLECTS THIS ALLOCATION OF RISK. General The laws of the State of California shall govern this Agreement. This Agreement is the entire agreement between Nodus and End-User concerning the Product and supersedes any other communications or advertising with respect to the program and accompanying documentation. If any provision of the Agreement is held invalid, the remainder of the Agreement shall continue in full force and effect. If you have any questions, please contact in writing: Nodus Technologies,, 2099 S. State College Blvd., Suite 250, Anaheim, CA 92806, Tel: (909) 482-4701. 223