Preview only show first 10 pages with watermark. For full document please download

A Printable Version Of The Credit Card Processing With Element

Rating
Date

July 2018
Size

839.5KB
Views

3,090
Categories

computers & electronics computers POS terminals

Transcript

Credit Card Processing with Element Payment Services Release 9.0.2 Disclaimer This document is for informational purposes only and is subject to change without notice. This document and its contents, including the viewpoints, dates and functional content expressed herein are believed to be accurate as of its date of publication. However, Epicor Software Corporation makes no guarantee, representations or warranties with regard to the enclosed information and specifically disclaims any applicable implied warranties, such as fitness for a particular purpose, merchantability, satisfactory quality or reasonable skill and care. As each user of Epicor software is likely to be unique in their requirements in the use of such software and their business processes, users of this document are always advised to discuss the content of this document with their Epicor account manager. All information contained herein is subject to change without notice and changes to this document since printing and other important information about the software product are made or published in release notes, and you are urged to obtain the current release notes for the software product. We welcome user comments and reserve the right to revise this publication and/or make improvements or changes to the products or programs described in this publication at any time, without notice. The usage of any Epicor software shall be pursuant to an Epicor end user license agreement and the performance of any consulting services by Epicor personnel shall be pursuant to Epicor's standard services terms and conditions. Usage of the solution(s) described in this document with other Epicor software or third party products may require the purchase of licenses for such other products. Where any software is expressed to be compliant with local laws or requirements in this document, such compliance is not a warranty and is based solely on Epicor's current understanding of such laws and requirements. All laws and requirements are subject to varying interpretations as well as to change and accordingly Epicor cannot guarantee that the software will be compliant and up to date with such changes. All statements of platform and product compatibility in this document shall be considered individually in relation to the products referred to in the relevant statement, i.e., where any Epicor software is stated to be compatible with one product and also stated to be compatible with another product, it should not be interpreted that such Epicor software is compatible with both of the products running at the same time on the same platform or environment. Additionally platform or product compatibility may require the application of Epicor or third-party updates, patches and/or service packs and Epicor has no responsibility for compatibility issues which may be caused by updates, patches and/or service packs released by third parties after the date of publication of this document. Epicor® is a registered trademark and/or trademark of Epicor Software Corporation in the United States, certain other countries and/or the EU. All other trademarks mentioned are the property of their respective owners. Copyright © Epicor Software Corporation. All rights reserved. No part of this publication may be reproduced in any form without the prior written consent of Epicor Software Corporation. Publication Date: March 29, 2016 Table of Contents Credit Card Processing with Element Payment Services Overview ............................................................. 1 How the Integration with Element Payment Services is Different ............................................................... 2 Card Numbers and PASS Accounts .......................................................................................................... 2 Hosted Web Pages for Card Number Capture .......................................................................................... 2 Swipe Devices........................................................................................................................................... 2 Element Processor Setup........................................................................................................................... 2 Settlements ................................................................................................................................................ 2 Terminology Changes ............................................................................................................................... 3 New Control Record to Disable Authorizations (pre-auths) ..................................................................... 4 Element Payment Services and Your Credit Card Transactions ................................................................... 5 Qualification Costs.................................................................................................................................... 5 Payment Accounts and Card Storage Costs .............................................................................................. 5 Credit Card Level 3 Processing .................................................................................................................... 7 Summary Data Sent in Element Fields ..................................................................................................... 8 Line Item Detail Data Sent in Element Fields .......................................................................................... 9 Credit Card Processing with Element Setup Overview .............................................................................. 10 Setup Requirements for Credit Card Processing with Element Payment Services ..................................... 11 Control Maintenance Records................................................................................................................. 11 Web Commerce Control Maintenance Records...................................................................................... 11 Authorization Keys ................................................................................................................................. 11 Other Required Setup .............................................................................................................................. 11 Configuring the Element Credit Card Processor at Your Branches ............................................................ 13 Entering URL Addresses for Element Credit Card Processing .................................................................. 15 Testing the Connection to the Element Credit Card Processing Site .......................................................... 16 Assigning Credit Card Authorization Upcharges to Ship Vias ................................................................... 17 Defining Prompts for Additional Credit Card Information......................................................................... 18 Collecting Order Payments Using Credit Cards Overview......................................................................... 19 Accepting Credit Card Payments for Orders .............................................................................................. 20 Saving Credit Cards on Orders for Future Payments .................................................................................. 24 Defining Default Customer and Contact Credit Cards ............................................................................... 26 Manually Entering Credit Card Authorization Codes................................................................................. 29 Authorizing Credit Cards Overview (Formerly known as "pre-authorizing" credit cards) ........................ 31 i Table of Contents Authorizing Credit Card Sales Amounts on Orders.................................................................................... 32 Completing Credit Card Payment Authorizations (Authorizing is formerly known as "pre-authorizing") 33 Authorized Credit Card Payment Example ................................................................................................. 35 Running the Credit Card Summary Report ................................................................................................. 36 Reviewing and Processing Failed and Declined Credit Card Charges ....................................................... 38 Reconciling Customer Credit Card Payments............................................................................................. 40 Creating Miscellaneous Cash Receipts for Credit Card Payments ......................................................... 41 Applying Credits to Credit Cards for Returns ............................................................................................ 43 Voiding Credit Card Transactions .............................................................................................................. 45 Returns at a Different Branch than Purchase Branch Guidelines ............................................................... 46 Managing Element Payments Accounts Overview ..................................................................................... 47 Viewing and Manually Deleting Element Payment Accounts .................................................................... 48 Scheduling Element Payment Account Deletions....................................................................................... 52 Converting to the Element Payment Services Solution Overview.............................................................. 53 Converting Customer and Contact Data for Element ................................................................................. 54 Converting Transactions for Element ......................................................................................................... 55 Purging Unconverted Credit Card Data for Element .................................................................................. 56 Chip & PIN Overview ................................................................................................................................ 57 Chip & PIN Installation .............................................................................................................................. 59 Software Prerequisites ............................................................................................................................ 59 Downloading triPOS for Element ........................................................................................................... 60 Considerations for Windows Environments ........................................................................................... 61 Considerations for UNIX and LINUX Environments ............................................................................ 63 Using the triPOS Automatic Installation .................................................................................................... 64 TriPOS Configurations for Automatic Installs ........................................................................................... 65 APPLICATION ...................................................................................................................................... 65 EXPRESS ............................................................................................................................................... 65 HOST ...................................................................................................................................................... 65 MERCHANT .......................................................................................................................................... 65 PINPAD .................................................................................................................................................. 66 TRANSACTION .................................................................................................................................... 66 RESTARTING ........................................................................................................................................ 66 Configuring Signatures for Chip & PIN ..................................................................................................... 67 Setting Up Chip & PIN ............................................................................................................................... 69 Using the Chip & PIN Interface.................................................................................................................. 70 ii Rel. 9.0.2 Credit Card Processing with Element Payment Services Running the Chip & PIN Verification .................................................................................................... 70 Canceling Transactions ........................................................................................................................... 71 Who to Contact About Errors ................................................................................................................. 71 How the System Handles Transaction Receipts...................................................................................... 71 Reviewing triPOS Transaction Responses .................................................................................................. 73 Troubleshooting Credit Cards and Element ................................................................................................ 74 Transaction Not Found Message......................................................................................................... 74 Duplicate Decline Message ................................................................................................................. 74 Internet Explorer 8.0 ........................................................................................................................... 74 404 Page Not Found Errors................................................................................................................. 75 Using the PASS Reconciliation Utility ....................................................................................................... 76 Index ........................................................................................................................................................... 77 iii Credit Card Processing with Element Payment Services Overview To accept payments using credit cards, Eclipse integrates with Element Payment Services to offer you a solution that does not store customer credit card data on your Eclipse server. The credit card payment industry has evolved from the days of stand-alone terminals and clunky carbon copy devices that exposed cardholder data to hackers. Eclipse Credit Card Processing with Element is a fully integrated solution that provides highly increased security regarding your customer's credit card data. Using the Credit Card Processing with Element companion product, you can collect credit card payments on orders as you did before, including the following functionality: • Accepting credit card payments at the time of sale • Authorizing (or pre-authorizing) an amount on an order for charging at time of shipment • Reviewing and processing failed and declined credit card charges • Applying credits to cards for returns • Voiding credit card transactions Important: If you are still running the Credit Card Authorization companion product, some of your windows and procedures might vary slightly from what is described in this documentation. Click here to use the Credit Card Authorization documentation. © 2016 Epicor Software Corporation. All rights reserved. 1 How the Integration with Element Payment Services is Different Rel. 9.0.2 How the Integration with Element Payment Services is Different As you move from the Credit Card Authorization companion product to the Credit Card Processing with Element solution, consider the following changes to how your company collects and processes credit card payments. Card Numbers and PASS Accounts To provide increased security, saved credit card information for customers and orders, including web orders, is now stored on the Element Payment Services secure server in Payment Account Secure Storage (PASS) accounts, and is no longer stored in Eclipse. When you convert to the Credit Card Processing with Element solution, your stored card information is masked in places in Eclipse such as order change logs, and PASS accounts are created for existing information where applicable. For more information about PASS accounts and how they are used, see Element Payment Services and Your Credit Card Transactions. Hosted Web Pages for Card Number Capture In addition, when you enter credit card information or swipe a card to gather and save information, the system opens a web browser window with an Element page where you manually enter or swipe the credit card instead of entering it in an Eclipse window. Eterm launches your default browser, Solar embeds the browser window in a Solar Frame. Because of this process, each computer that you use to collect payments using credit cards must have a web browser installed and have internet access. For more information, see Setup Requirements for Credit Card Processing with Element Payment Services. Important: Your customers entering orders through your web site also see the Element page to enter their card information and need Javascript enabled in their web browsers. Swipe Devices Element Payment Services requires that you upgrade to specific swipe devices that encrypt credit card information prior to sending it to the Element Payment Services server. You must purchase your swipe devices through Epicor Software Corporation, as the devices are specifically configured with an encryption key that works with your implementation of the Credit Card Processing with Element solution. The devices connect directly to your computer using a standard or mini USB connection. Element Processor Setup To route credit card information to a credit card company, such as Visa, \you must set up each branch that takes credit card orders and processes them through Element Payment Services. For more information, see Configuring the Element Credit Card Processor at Each Branch. Settlements Because you enter credit card information and send it to Element Payment Services during the payment collection process, you no longer need to run the Credit Card End of Day Settlement Report to send 2 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services transaction information through your company's processor to the credit card companies. Element handles the settlement process of any authorized transactions for you. If you select Element as your service provider, you have online access to view all your transactions through an Element web site. If you select Element as a gateway service and work with another service provider, your reporting comes through your chosen service processor. You can still use the Credit Card Summary Report to list all the approved credit card transactions and compare it to your bank statements or service provider reports for reconciliation purposes. Terminology Changes Throughout the system, the credit card terminology has been updated to more accurately reflect the action you are taking with the card. Was... Is now... Auth or Authorize Sale In the Credit Card Processing with Element solution, when you are accepting a payment for a credit card transaction, typically when a customer is present with their card or using a customer's saved card information, you now complete a credit card sale. When you select the Sale option in sales order entry the payment information is sent for processing. When dealing with retail customers, you typically process the credit card sale at the time you enter the order. A sale transaction is the most common type of credit card transaction. Pre-auth or Pre-Authorize Authorize In the Credit Card Processing with Element solution, when you are collecting credit card information to charge later, such as waiting to charge the customer for an order until you ship it from your warehouse, you can authorize a credit card sale to ensure that the customer has enough credit available, but without actually charging the customer's account. These transactions are now called authorizations. The second event to actually charge the customer's card is now called an authorization completion. In addition, Element Payment Services uses the terms that might be new to you: Term Definition Acceptor ID Much like a merchant number, Element assigns you unique acceptor IDs to identify you as an Element customer. Depending on your business relationship with Element, you might have a different acceptor ID for each branch, or you might have a single acceptor ID that encompasses more than one branch. When payment accounts are created as you save credit card information, they are assigned to the acceptor ID assigned for the branch. Transaction ID When you create an authorization or a sale, Element assigns an ID to the payment transaction. When you complete voids or returns, or are investigating disputes, Element uses this transaction ID to identify the transaction in their system. © 2016 Epicor Software Corporation. All rights reserved. 3 How the Integration with Element Payment Services is Different Term Definition Payment Account ID Credit Card numbers stored on the Element server are termed Payment Accounts and have an ID (also known as a token) associated with them that is stored in Eclipse. The Payment Account ID is a long string of random characters and likely has little meaning to those outside of Element. When you select a stored card based on the card's last 4 digits, card brand and expiration date, Eclipse uses the Payment Account ID in its communication with Element to indicate which card to charge or credit. Rel. 9.0.2 Note: Orders placed through your web site that are paid for using a credit card send a PASS ID to Eclipse for credit card process. New Control Record to Disable Authorizations (pre-auths) If your business does not initially authorize cards to hold funds and confirm available credit before charging the card at a later date, you now have the ability to disable the function from being accidentally selected by your users using the Disable Auth Only Option For Credit Card Authorizations control maintenance record. 4 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Element Payment Services and Your Credit Card Transactions How you enter and accept credit cards within Eclipse can affect charges that you incur. Credit card transaction fees can get complicated and many factors contribute to your total cost of accepting payment using credit cards The Credit Card Processing with Element solution is designed to offer you flexibility in how you want to implement credit card process at your company. As you are implementing processes for accepting credit card payments, consider how you want to accept and store credit cards to help alleviate any unneeded fees. Qualification Costs Each transaction “qualifies” for an interchange rate based on such things as the card brand, card type, card presence, information sent -- your merchant service provider might detail this to you by transaction on your statements or might bucket the transactions and simplify what you see on your statements. Regardless, the timing and process of charging the card through Eclipse can affect the qualification. As a general rule, card-present, “swipe” transactions qualify for a lower interchange fee than card notpresent transactions. When processing through Element Payment Services, the swipe must be directly captured in the Element hosted page while charging the card. In this process, Eclipse has a transaction ID (a token for the specific charge) for handling voids and credits; but Eclipse cannot charge the swiped card for backorder fulfillment. Payment Accounts and Card Storage Costs Payment Account Secure Storage (PASS) transactions, are credit card transactions that you make using credit card information that you have on file in Eclipse. Element charges a fee, which you negotiate with them, and is based on the volume of payment accounts stored in their data centers each month. For each card number stored in a customer or contact record in Eclipse, a payment account is created with Element. Additionally, cards captured on sales orders (not saved to the customer record) in the CC Info screen generates a payment account with Element. Saving credit card numbers gives you the flexibility to charge the card at any time during the order cycle with the customer. However, saving credit card numbers with Element does not necessarily qualify you for the best interchange rate. Note: Orders placed through your web site that are paid for using a credit card send a Payment Account ID to Eclipse for credit card process. Consider the following examples. A customer walks up to your counter and orders two items: one is available for the customer to take with them, one is backordered. The customer presents their credit card for payment. You can do any of the following and be charged different rates: • Scenario 1: Best rates, but two swipes - Charge the card for the one item that is available using a swipe transaction and also swipe the card again in the CC Info screen in order entry to create a payment account for charging the card when the backordered item ships. • Scenario 2: One swipe, but not optimal rates - Capture the card in the CC Info screen in order entry to establish a payment account. Select the payment account to charge the card for the available item. This qualifies for a card-not-present interchange rate. However, the payment account is available for charging when the backordered item ships © 2016 Epicor Software Corporation. All rights reserved. 5 Element Payment Services and Your Credit Card Transactions Rel. 9.0.2 • Scenario 3: Charge the card for both items using a swipe transaction - This may or may not be permissible based on your agreement with your merchant service provider and how you document your card-charging policies to your customer. To qualify for the best per transaction process rate, swipe or manually enter a customer's credit card for immediate payment for an order, without saving the card information. Use the PASS Account Utility to help manage the payment accounts your operations generate with Element Payment Services. The utility provides you the tools to minimize the volume of payment accounts to those required for your business. For more information, see Managing Element Payments Accounts Overview. 6 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Credit Card Level 3 Processing Credit Card Processing with Element includes Level 3 credit card processing. Using Level 3 processing can result in lower qualification costs by sending more detailed transaction information for commercial and government transactions. Level 1 data includes the merchant name, amount, and date for each transaction. Level 2 includes: • Tax Amount • Customer Code • Merchant Postal Code • Tax Identification • Merchant Minority Code • Merchant State Code For each branch that is enabled for Level 3 credit card data in the Allow Sending Credit Card Level 3 Data control maintenance record, the system sends the following additional data for each credit card transaction. If necessary, you can override the branch setting at the customer level using the Allow Sending Credit Card Level 3 Data for Customer field in the Credit Control Parameters in Customer Maintenance. • Item Product Code • Item Description • Item Quantity • Item Unit of Measure • Item Extended Amount • Item Net/Gross Indicator • Item Tax Amount • Item Tax Rate • Item Tax Identifier • Item Discount Indicator • Ship from Postal Code • Freight Amount • Duty Amount • Destination Postal Code • Destination Country Code • Alternate Tax Amount © 2016 Epicor Software Corporation. All rights reserved. 7 Credit Card Level 3 Processing Rel. 9.0.2 Summary Data Sent in Element Fields The following summary information is sent to Element Payment Services for each credit card transaction: Element Field Data Sent Eclipse File and Attribute Alternate Tax Amount 0 N/A Customer VAT Registration Number Ship-to customer entity tax exempt number for the state in which the ship-to customer resides ENTITY, attribute 34 and 4 Destination Country 8 840 Destination Zip Code The zip code of the ship-to address LEDGER 75, ENTITY attribute 5 if LEDGER is blank; '-' changed to ' ' Discount Amount Discount total that the SOE.CALC.DISC program calculates N/A Duty Amount Duty charges for those items that go through customs If LEDGER 48, line item duty stored in attribute 78 Freight Amount The total freight for the order generation LEDGER 57, 0 if blank Line Item Count The number of line items included on the order, excluding comments and subtotals N/A Merchant VAT Registration Number Ship branch entity tax exempt number for the state in which the ship branch resides ENTITY, attribute 34 and 4 National Tax 0 N/A Order Date The date the order is entered LEDGER, attribute 4 ShipFrom Zip Code Branch entity's zip code ENTITY, attribute 5; "-" changed to ' ' Summary Commodity Code Dist N/A Unique VAT Invoice Reference Number Sales order number with the generation information N/A VAT Amount Tax amount that the OE.TAX.CALC.AMTS program calculates N/A VAT Rate Tax rate that the OE.TAX.CAL.AMOUNTS program uses to calculate the tax N/A © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Line Item Detail Data Sent in Element Fields The following line item detail information is sent to Element Payment Services for each credit card transaction: Element Field Data Sent Eclipse File and Attribute Alternate Tax Identifier Blank N/A Debit Credit Code 2 if the extended price is greater than or equal to 0; otherwise, 1 Discount Code 1 if Discount Amount is not zero or is blank; otherwise 2 N/A Extended Item Amount Sell Price * Quantity N/A Item Commodity Code Product file commodity code, "Merchandise" if product file is blank PRODUCT, attribute 14 Item Description The first 35 letters of the product's description N/A Line Item Discount Amount The proportion of the total discount that applies to each line item, calculated as: Extended Price/Generation Total (Sum of Ledger attribute 15) * Total Discount (Cash + Web Commerce discount calculated by SOE.CALC.DISC) N/A Line Item Total Amount The total amount for the line item calculated as: Extended Price + Tax Amount Discount Amount N/A Line Item VAT Amount Line item tax that the GET.LDID.TAX.AMT program calculates N/A Line Item VAT Rate Line item tax rate that the GET.LDID.TAX.AMT program uses to calculate the line item tax N/A Net Gross Code 1 N/A Product Code The internal Eclipse product ID. LEDGER.DET, attribute 1 Quantity Total quantity of the item ordered. LEDGER.DET, attribute 4 Rate Discount Amount / Extended Price * 100; 0 if extended price is blank or 0 N/A Unit Cost The selling price of the product out to two decimal places LEDGER.DET, attribute 8 Unit of Measure The units, such as ea or box, in which the product was ordered LEDGER.DET attribute 23 VAT Type Blank N/A © 2016 Epicor Software Corporation. All rights reserved. 9 Credit Card Processing with Element Setup Overview Rel. 9.0.2 Credit Card Processing with Element Setup Overview Prior to processing credit card transactions, complete the following setup tasks: • Set the appropriate control maintenance records and authorization keys to configure how the credit card process works for your site and your users • Configure the Element credit card processor at each branch • Enter the appropriate URL addresses for Element credit card processing • Test the connection to the Element Credit Card Processing Site • Define default customer and contact credit cards • Assign credit card authorization upcharges to your shipping methods If you use the Credit Card Authorization companion product, the weekend of your Element Payment Services solution go live, you must run the credit card conversion utilities to prep your system for Monday morning. 10 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Setup Requirements for Credit Card Processing with Element Payment Services Following are the control maintenance records, authorization keys, and additional setup requirements for Credit Card Processing with Element. Control Maintenance Records • Allow Sending Credit Card Level 3 Data • Credit Card: Default Reference Number • Credit Card Administrator • Credit Card Collection Approval Mode • Default Auth Method For New Credit Cards • Disable Auth Only Option For Credit Card Authorizations • Disallow Auto Apply Of Credit Card Payments • Notification Method When Credit Card Auth Fails • Override Print Status On Credit Card Denial • Require CVV ID On Keyed Element Credit Card Sales/Authorizations • Sales Order Entry Return Setup • User To Be Messaged With Credit Card Communication Errors Web Commerce Control Maintenance Records • Credit Card: WOE Authorization Method • Display The Credit Care Information Page In WOE • Force Information To Be Entered On The WOE Credit Card Page Authorization Keys • CREDIT.CARD.ACCT • CREDIT.CARD.SETUP • OVERRIDE.RETURN.PAYMENT Users must have this authorization key assigned to select a credit card from the selection list if a card is already saved to the order. Other Required Setup Prior to using Element Payment Services, you need to also ensure that you have done the following: © 2016 Epicor Software Corporation. All rights reserved. 11 Setup Requirements for Credit Card Processing with Element Payment Services Rel. 9.0.2 • Worked with your Element representative to determine how your account is set up. For example, are you using Element as your credit card processor, or as a location to store credit card data and a as a gateway to another processor. • Purchased swipe devices for computers at which you swipe credit cards. You must purchase your swipe devices through Epicor Eclipse, as they are configured specifically with an encryption key that works with your implementation of the Credit Card Processing with Element solution. The devices connect directly into your computer using a standard or mini USB connection. • If you are running Internet Explorer 8.0 on the Windows 7.0 or Windows Vista operating system, there is a known display error when launching Internet Explorer from Eclipse. To correct this problem, leave an Internet Explorer 8.0 browser window open while you are entering orders and accepting payments using credit cards in Eclipse. Or, set Mozilla Firefox as your default browser. The system uses your default browser when you swipe or manually enter card information. Using Firefox does not require that you leave a browser window open. • Configure the Element payment processor at each branch that collects credit card payments. For more information, see Configuring the Element Credit Card Processor at Each Branch. 12 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Configuring the Element Credit Card Processor at Your Branches Eclipse is certified with Element Payment Services (a credit card processor) that enables your company to route credit card information to a credit card company, such as Visa, when your customers place credit card orders. Set up each branch that takes credit card orders and processes them through Element Payment Services To edit the credit card information for a branch, you must be assigned the CREDIT.CARD.SETUP authorization key. If you are using Element Payment Services, test the connection to the Element processing site after you configure the card processor. Note: If you are not using the Element credit card processor, the procedure to configure the card processor at each branch differs from the one provided below. You need to enter merchant, device, and terminal ID information for your card setup, along with additional information that your processing bank provides to you. To configure the Element credit card processor at each branch: 1. From the Maintenance > Branch menu, select Branch to display the Branch Maintenance window. 2. In the Branch field, enter the branch to display the branch record, and select Maintenance > Credit Card Branch Setup to display the Credit Card Branch Setup window. 3. In the Processor field, enter Element to indicate that you are setting up the Element credit card processor. If you are using a different processor, select that processor and enter the Merchant ID, Device ID, and Terminal ID for the branch. For information on setting up those processors, see Configuring Branch Credit Card Processors in the Entity Maintenance documentation. 4. From the Additional menu, select Additional Credit Card Information to display Additional Credit Card Information window and complete the following additional information that Element Payment Services provides to you regarding your account. Note: Eclipse technical support typically enters this for you when setting up your credit card functionality. Field Description Account ID Your account identification number with Element Payment Services. Account Token The number used for authentication with Element Payment Services' web sites. Terminal ID The number the credit card processor assigns to you. This number can vary by merchant. Acceptor ID Your merchant identification number. As an "acceptor," you are a business that is qualified to accept a credit or debit card as payment for an order. © 2016 Epicor Software Corporation. All rights reserved. 13 Configuring the Element Credit Card Processor at Your Branches Field Description PIN Debit Enabled Activates the PIN debit acceptance for the current branch. Rel. 9.0.2 Note: If the Connect to TriPOS when Card Present Selected option is set at the Terminal Setup level, the system ignores this field setting at the branch level. Encrypted Key Entry Required Activates the system requirement for encrypted key processing for credit cards. 5. Use Health Check option to verify connectivity and authentication to Element. 6. Click the Edit URLs button and enter the web site addresses that Element Payment Services has provided you for transactions, reporting, and services. The Services URL is the Payment Account transactions. For more information, see Entering URL Addresses for Element Credit Card Processing. The URLs are the same for all of your branches. If you have already set up a branch and entered the URLs, you do not need to do it again for a different branch. 7. Test the connection to the Element processing site. 8. Save your changes and save the branch record. 14 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Entering URL Addresses for Element Credit Card Processing Eclipse is certified with Element Payment Services (a credit card processor) that enables your company to route credit card information to a credit card company, such as Visa, when your customers place credit card orders. The URLs that Element Payment Services provides you are the same for each branch. Note: After you set up one branch for Element credit card processing, each subsequent branch uses the same URLs, and you do not need to enter them again. The URLs are located at the branch level, because the system requires the branch-level information to complete the test connection (health check). To edit the credit card information for a branch, you must be assigned the CREDIT.CARD.SETUP authorization key. After defining the URLs, test the connection to the Element processing site. To enter URL addresses for Element processing: 1. From the Maintenance > Branch menu, select Branch to display the Branch Maintenance window. 2. In the Branch field, enter the branch to display the branch record, and select Maintenance > Credit Card Branch Setup to display the Credit Card Branch Setup window. 3. Select the Element processor in the list, and select Additional Credit Card Information from the Additional menu to display Additional Credit Card Information window. 4. Click the Edit URLs button and enter the web site addresses that Element Payment Services has provided you for transactions, reporting, and services. The Services URL is the Payment Account transactions. 5. Test the connection to the Element processing site. 6. Save your changes and save the branch record. © 2016 Epicor Software Corporation. All rights reserved. 15 Testing the Connection to the Element Credit Card Processing Site Rel. 9.0.2 Testing the Connection to the Element Credit Card Processing Site For each branch, test the connection to Element Payment Services to verify that the account information you entered for the branch is correct, and that you have access to the web site addresses you entered for reporting, transactions, and services . If you update the account information, or add a new branch, retest the connections to ensure that your system has access to what it needs to complete credit card processing with Element. You must set the URLs for the transaction, reporting, and service connections for a branch prior to testing the connection. To test the connection to the Element processing site: 1. From the Maintenance > Branch menu, select Branch to display the Branch Maintenance window. 2. In the Branch field, enter the branch to display the branch record, and select Maintenance > Credit Card Branch Setup to display the Credit Card Branch Setup window. 3. Select the Element credit card processor, or set up a new processor for Element, and click the Health Check button. The system checks the account information you have entered, and whether you can access the web sites for transactions, reporting, and services. If the test is unsuccessful, verify that you have entered the account information and URLs for the web sites correctly, and repeat step 3. You can also run a test from the window where you enter URLs. 16 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Assigning Credit Card Authorization Upcharges to Ship Vias When you are authorizing a credit card payment for an order, you might not know what the final order total is going to be due to freight and handling charges. For each shipping method you have defined in your sysem, assign a default upcharge to add to the order total that you are authorizing on the customer's credit card to estimate and cover freight and handling charges. During credit card authorizations, the system adds this amount to the total order amount. This additional amount ensures that there are enough authorized funds available on the card to pay for the goods and potential shipping and handling fees. To assign credit card authorization upcharges to a ship via: 1. From the Maintenance menu, select Ship Via to display the Ship Via Maintenance window . 2. In the Ship Via field, enter the shipping method to which you want to assign the information. 3. Click the Additional Information tab to display the Credit Card Information area. 4. In the Percent Upcharge % field, enter the percentage of the total order amount to add to the authorization amount to cover any freight or handling fees. 5. In the Minimum Upcharge field, enter the minimum upcharge to add to the total if the upcharge determined by the percent in the Percent Upcharge field is less than this amount. 6. Save your changes and exit the window. © 2016 Epicor Software Corporation. All rights reserved. 17 Defining Prompts for Additional Credit Card Information Rel. 9.0.2 Defining Prompts for Additional Credit Card Information You can define a security level to customer credit card information. For example, you can have the system prompt the order writer to ask the customer for additional credit card information during order entry. Note: If you use Element Credit Card Processing and a PIN pad device, those processes supersede this setup. To define prompts for additional credit card information: 1. From the Maintenance menu, select Customer to display the Customer Maintenance window. 2. In the Customer field, type the name of a customer and press Enter. 3. From the Pricing menu, select Credit Controls to display the Credit Control Parameters window. 4. Click the Additional Info tab to display the Additional Customer Credit Data area. For more information about this area, see Entering Additional Customer Credit Data. 5. In the Credit Card Information field, select which level of credit card information is required for this customer in order entry: • None - Requires no additional information to save the order. • Prompt - Prompts the user to enter credit card information for the order. • Required - Requires credit card information to save the order, unless you are assigned the CREDIT.CARD.REQD.OVR authorization key. 6. Save your changes and exit the window. 18 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Collecting Order Payments Using Credit Cards Overview How you collect a credit card payment on an order is determined by the policies that your company has established. You can accept payments on credit cards using the following methods: • Using a new card or saved card at the time a sale is made. • By authorizing a payment on a new or saved card, but not charging the card at the time you enter the sales order. How you enter and accept credit cards within Eclipse can affect charges that your company incurs. For more information, see Element Payment Services and Your Credit Card Transactions. © 2016 Epicor Software Corporation. All rights reserved. 19 Accepting Credit Card Payments for Orders Rel. 9.0.2 Accepting Credit Card Payments for Orders The Credit Card Processing with Element solution is designed to offer you flexibility in how your company implements its procedures for accepting credit card payments for orders. Check with your supervisor if you are unsure about whether you should save a customer's credit card information for later payment, or accept payment at the time of the order. The procedures below describe how to accept a full or partial credit card payment for an order. Note: Element contains logic that checks for duplicate charges. If two charges for the same amount are made to the same card during the batch period, the second charge is declined. The batch period is set between you and Element. For more information about working around duplicate charges, see Troubleshooting Credit Cards and Element. To accept a credit card payment in order entry without saving card information: 1. From an open sales order, click the Totals tab to display the Totals information for the order. 2. In the Credit Card field, enter the amount of the payment the customer wants to charge to their card. The Credit Card Authorization window displays. 3. Do one of the following: 20 To... Do this... charge a credit card the customer has on file Select a card from the list that displays. To display the available cards, select Transaction > List Cards. Default cards that are saved for the customer display in this list. For more information, see Defining Default Credit Cards with Element Payment Services. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services To... charge a new credit card that the customer has with them, without saving the card information Do this... 1. Select New if a list of available cards displays. The card holder, zip code, and billing street address defaults to the bill-to address on the order. If the shipto and bill-to are different, the system prompts you to select the address to use. Update the address information for the card, if necessary. 2. From the Transaction menu, select Sale and do one of the following: • Select Swipe. The system displays the Element Process Transaction window in your default web browser. Run the card through your card reader. The system gathers the card information, including the CCV code from the back of the card. • Select Card Present to manually enter the card information in the fields provided in the Element Process Transaction web page, which displays using your default web browser. For example, if the card's magnetic strip is worn. If you select to manually enter the card information, you are prompted to enter CVV ID. The CVV ID is required if the Require CVV ID On Keyed Element Credit Card Sales/Authorizations control maintenance record is set to Yes. • • • Card Number - The 16 digit card number from the front of the card. Expiration Date - The month and year in which the card expires. CVV - The three digit code, typically printed on the back of the card in the signature strip. 3. Click Process Transaction to submit the information and process the transaction with Element. When the request completes, Element returns an authorization code for the transaction. The authorization code displays in the Authorization Code field for reference. If the returned authorization code is *Call* or something similar, you need to call the credit card company for authorization. See Manually Entering Credit Card Authorizations. If the authorization is approved, the payment is applied to the order. If the card fails to process or is declined, the system notifies the user taking the payment by displaying an error message in the Element Credit Card window, and also sends notification to the user set in the Credit Card Administrator control maintenance record, places the transaction in the Credit Card Payment Review Queue, and changes the print status of the order based on the setting in the Override Print Status On Credit Card Denial control maintenance record. The decline is also noted in the order change log. To accept a credit card payment in order entry and save card information: 1. From an open sales order, click the Totals tab to display the Totals information for the order. 2. In the Credit Card field, enter the amount of the payment the customer wants to charge to their card. The Credit Card Authorization window displays. © 2016 Epicor Software Corporation. All rights reserved. 21 Accepting Credit Card Payments for Orders Rel. 9.0.2 3. Enter the card information. 4. Click Save Card to Order. Important: Eclipse does not save the actual credit card number in any way. A tokenapplication process is used. The token received to process the order is saved in Eclipse for future use on this order. 5. Click Process Transaction to submit the information and process the transaction with Element. To accept a credit card payment in close counter order without saving card information: 1. From the Orders menu, select Close Counter Order to display the Close Counter Order window. For more information, see Quickly Closing Counter Orders in the Sales Management documentation. 2. Right-click the order to which you want to apply payment, and select Collect Payment. 3. In the Payment Method field, select Credit and do one of the following: 22 To... Do this... charge a credit card the customer has on file Select a card from the list that displays. To display the available cards, select Transaction > List Cards. Default cards that are saved for the customer display in this list. For more information, see Defining Default Credit Cards with Element Payment Services. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services To... charge a new credit card that the customer has with them, without saving the card information Do this... 1. Select New if a list of available cards displays. The card holder, zip code, and billing street address defaults to the bill-to address on the order. If the shipto and bill-to are different, the system prompts you to select the address to use. Update the address information for the card, if necessary. 2. From the Transaction menu, select Sale and do one of the following: • • • • • 3. Select Swipe. The system displays the Element Process Transaction window in your default web browser. Run the card through your card reader. The system gathers the card information, including the CCV code from the back of the card. Select Key Enter to manually enter the card information in the fields provided in the Element Process Transaction web page, which displays using your default web browser. For example, if the card's magnetic strip is worn. If you select to manually enter the card information, you are prompted to enter CVV ID. The CVV ID is required if the Require CVV ID On Keyed Element Credit Card Sales/Authorizations control maintenance record is set to Yes. Card Number - The 16 digit card number from the front of the card. Expiration Date - The month and year in which the card expires. CVV - The three digit code, typically printed on the back of the card in the signature strip. Click Process Transaction to submit the information and process the transaction with Element. When the request completes, Element returns an authorization code for the transaction. The authorization code displays in the Authorization Code field for reference. If the returned authorization code is *Call* or something similar, you need to call the credit card company for authorization. See Manually Entering Credit Card Authorizations. If the authorization is approved, the payment is applied to the order. If the card fails to process or is declined, the system notifies the user taking the payment by displaying an error message in the Element Credit Card window, and also sends notification to the user set in the Credit Card Administrator control maintenance record, places the transaction in the Credit Card Payment Review Queue, and changes the print status of the order based on the setting in the Override Print Status On Credit Card Denial control maintenance record. The decline is also noted in the order change log. 4. Finalize the order by collecting a signature or printing a ship ticket. For more information, see Quickly Closing Counter Orders in the Sales Management documentation. © 2016 Epicor Software Corporation. All rights reserved. 23 Saving Credit Cards on Orders for Future Payments Rel. 9.0.2 Saving Credit Cards on Orders for Future Payments Your company might decide to keep credit card information on file for an order, thus creating a payment account with Element. For example, an inside salesperson enters an order that the customer would like to pay for with their credit card. However, your company does not charge the customer's card for an order until the material on the order has shipped. You can save the credit card information with the order to charge at a later date. For more information about payment accounts, see Element Payment Services and Your Credit Card Transactions. You can also accept a payment for part of an order, and store the card to charge the remaining amount at a later date. For example, your counter salesperson take an order for one hundred 1/4 inch copper fittings. You have 50 in stock that you can send with the customer today. You can charge the customer's card for the 50 they are taking with them today, and then save the card information to the order to charge the remaining total due when you ship the remaining 50 fittings. For more information about taking a credit card payment for an order, see Accepting Credit Card Payments For Orders. To save a credit card for a customer for future use on any order a customer places, set up default credit card information at the customer level. When the product on the order is available and ready for shipping and the ship ticket prints, or when the Credit Card Authorization Phantom runs and finds that the order has shipped, the system processes the credit card payment. To save a credit card to an order for future payments: Note: If you are saving card information to charge for future payments on an order, you can save the information before or after you accept a payment for the order. You can also choose to save the credit card to the order without accepting a payment on the order. 1. In the Totals tab of an order, select Save Credit Card Info from the Payment menu, and select New to display the Default Credit Card Information window. You can also select a card on file from the displayed list if the customer wants to charge the order to a credit card they have on file with you. Selecting a saved card saves the card information to the order. 2. Swipe the card through your card reader, or enter the information for the card in the fields provided. 24 Field Description Card Number Enter the 16 digit card number as it appears on the front of the card. Card Holder Enter the name exactly as it appears on the front of the credit card. Expiration Date Enter the month and year in which the card expires. Zip Code and Street Address The zip code and billing street address defaults to the bill-to address on the order. If the ship-to and bill-to are different, the system prompts you to select the address to use. Update the address information for the card, if necessary. This is used when you charge the card to complete an address verification with the credit card company. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Field Description Card Type Select the two character code that identifies the brand name of the credit card, such as MC for Master Card. Valid credit card types are defined in the Valid Credit Card Types control maintenance record. Terms Override Enter the code that represents the payment terms, if any, to use when this credit card is used for payment. For example, if you give the customer discount to orders when they pay in cash, but discounts do not apply when they pay with a credit card, enter the terms code to override the discount. Charge Tax Select this check box to apply tax to orders paid with this credit card. For example, customers could be exempt from tax if they pay with a company credit card. If you want to charge tax to payments made with such credit cards, select this option. Reference Number Enter a reference number for this customer, such as the order number or customer ID. If you swipe the card, you also need to enter the customer's billing address information in the fields provided. 3. Do one of the following: • From the File menu, select File > Save to Customer to save the card to the customer record. This saves the card for use on future orders, not just this order. • Close the window and select Yes at the prompt to save the card to the order. This saves the card information for payments on this order only. © 2016 Epicor Software Corporation. All rights reserved. 25 Defining Default Customer and Contact Credit Cards Rel. 9.0.2 Defining Default Customer and Contact Credit Cards Enter a customer's or contact's default credit card so the information is available when customers place orders. The setting on the Validate Name In 'Ordered By' Field Against Customer Contact control maintenance record determines whether the contact has authorization to place a credit order for the company. You cannot add credit card information to a customer account set up as a branch cash account or to customer records that have the Do NOT allow Credit Cards to be saved to this account check box in the Additional Info tab in the Credit Control Parameters window checked. Important: After you save a credit card, you cannot update the expiration date on the card. If the customer or contact's card expiration information changes, create a new card and save it to the customer or contact. To define a default credit card information: 1. If you are defining default credit card information for a customer, do the following: • From the Maintenance menu, select Customer to display the Customer Maintenance window, and enter the customer's name in the Customer field to display the record. • From the Pricing menu, select Credit Controls to display the Credit Control Parameters window, and enter the credit parameters as needed. • From the Edit menu, select Default Credit Card Information, and select New, or select an existing credit card. The Default Credit Card Information window displays. The address information defaults to what is entered for the customer. If you are defining credit card information for a contact, do the following: • From the Maintenance menu, select Contact to display the Contact Maintenance window, and enter the contact's name in the Contact field to display the record. • From the Information menu, select Default Credit Card Information, and select New to display the Default Credit Card Information window. 2. To enter the card information, do one of the following: 26 To... Do this... swipe the card to gather the card information 1. From the File menu, select Swipe to display the Element Card Information window. 2. Slide the card through your encrypted card reader. 3. Click Save Card to gather the information and return to the Default Credit Card Information window. The system populates the last for digits of the card in the Card Number field, as well as the Card Type, and Expire Date fields with the information from the card. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services To... Do this... enter the credit card information manually 1. 2. 3. 4. From the File menu, select Manual Entry to display the Element Credit Card window. In the Card Number field, enter the entire card number exactly as it appears on the card. In the Expiration field, enter the month and year in which the card expires. Click Save Card to return to the Default Credit Card Information window. 3. Edit the remaining credit card information in the Default Credit Card Information window for this card: Field Description Cardholder Enter the name of the card holder, as it is printed on the credit card. Street Address Enter the billing address for the card. Zip Code Enter the zip code of the billing address for the card. Authorization Method Select one of the following authorization methods to use in order entry when the card is used for payment: • Authorize Before Shipment - Sets money aside from the credit card, guaranteeing funds for the order total plus any freight charges, without charging the card. When the order is final, the system collects the final payment. Potential charges from your credit card processor may apply if you authorize payment from a customer. • Authorize Before Shipment - Authorizes and charges the card for the order amount before shipping. The pick ticket is printed upon authorization. • Reference Only - Uses information in the Credit Card Authorization window for reference only at the order level. • Authorization After Review - Authorizes and charges the card for the order amount after the invoice is sent through batch printing and the shipping ticket is printed. The authorization method for new cards defaults to the setting stored in the Default Auth Method for New Cards control maintenance record. Terms Override Enter the code that represents the payment terms, if any, to use when this credit card is used for payment. For example, if you give the customer discount to orders when they pay in cash, but discounts do not apply when they pay with a credit card, enter the terms code to override the discount. Default Reference No Select a default reference number for this customer. Reference numbers are defined in the Credit Card: Default Reference Number control maintenance record. If Exempt Charge Tax Select this check box to apply tax to orders paid with this credit card. For example, customers could be exempt from tax if they pay with a company credit card. If you want to charge tax to payments made with such credit cards, select this option. 4. Save your changes, exit the window, and save the customer record. If you swipe or manually enter a default credit card and do not save the customer record, the credit card is not saved. © 2016 Epicor Software Corporation. All rights reserved. 27 Defining Default Customer and Contact Credit Cards Rel. 9.0.2 More Options when Defining Default Credit Card Information You can also do the following when defining default credit card information for a customer: To... Select... include additional credit payment data about the customer. This information does not directly affect any other part of the system and is displayed for informational purposes only. File > Additional Information delete default credit card information. For example, if a customer changes credit card companies, you can delete the credit card information from the system. The system also deletes the credit card information from Element Payment Services. When you delete the card, the system also deletes the associated payment account in Element. You cannot delete a card if there is an open order waiting for payment using the card. File > Delete 28 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Manually Entering Credit Card Authorization Codes In most circumstances, when you take a credit card payment for a sales order, the transaction with the credit card company happens behind the scenes with an automatic authorization, and you do not need to intervene in the process. However, at times, your system might be down, or there might be disputes with credit cards that require you to call the credit card companies directly and obtain an authorization code to process a payment. You can manually enter and process an authorization within order entry for an order. This process allows you to post the order payments to Eclipse, and to ensure that you receive the transaction money from the bank. Enter credit card authorizations whenever you receive an authorization code over the phone from the card's issuing bank. If you receive an authorization code of "Call" or something similar when accepting a payment using a saved card, you need the full card number to initiate a manual authorization. Note: You can only enter a manual credit card authorization for new cards, not cards that you have on file for a customer. To manually enter a credit card authorization: 1. From an open sales order, click Totals to display the Totals tab for the order. 2. In the Credit Card field, enter the amount of the payment the customer wants to charge to their card. The Credit Card Authorization window displays. 3. Select New if a list of available cards displays. The zip code and billing street address defaults to the bill-to address on the order. If the ship-to and bill-to are different, the system prompts you to select the address to use. Update the address information for the card, if necessary. This is used when you charge the card to complete an address verification with the credit card company. If the system automatically selects a card, select Transaction > List Cards and select New. Manual authorizations must always be processed enter the card number; stored cards cannot be manually authorized. 4. From the Transaction menu, select Enter Manual/Voice Auth Code and enter the authorization number the credit card company provided you over the phone for the transaction in the Authorization Code field. 5. From the Transaction menu, select Sale, and answer Yes at the "Create A Manual Payment?" prompt, and do one of the following: To... create a manual payment in Eclipse and to initiate the electronic payment collection process Do this... 1. 2. Answer Yes at the "Do you want Eclipse to Settle This Charge At the End of the Day?" prompt. Answer Yes at this prompt if you have not yet received your money from the bank for this credit card payment. For example, a sale transaction returns with a "call" response, which the user performs and obtains the authorization code over the phone. Or, your system is down and you choose to obtain your voice authorization and are now going back and entering transactions into Eclipse. Continue with step 6 below. © 2016 Epicor Software Corporation. All rights reserved. 29 Manually Entering Credit Card Authorization Codes To... create a manual payment in Eclipse without collecting money Rel. 9.0.2 Do this... 1. 2. 3. Answer No at the "Do you want Eclipse to Settle This Charge At the End of the Day?" prompt. Answer No at this prompt if you are entering the authorization code to enter the payment in Eclipse, an have already received the money for the transaction from the bank. For example, if there was a dispute with the card, you might have received your money, but now need to enter the payment information in Eclipse to close out the order and balance your books. If you have already received your money from the bank, answer Yes at the next prompt to continue. If you have not received your money and need to start over, answer No and start again with step 4. If you answer Yes, the system applies the payment to the order and returns to the Totals screen. Continue process the order as usual. 6. If you have not received money from the card issuing bank for the transaction, do one of the following to collect the card information: • Select Swipe to gather the card information by sliding the card through your card scanner. The system displays the Element Process Transaction window in your default web browser. Run the card through your card reader. The system gathers the card information, including the CCV code from the back of the card. • Select Key Enter to manually enter the card information in the fields provided in the Element Process Transaction web page, which displays using your default web browser. For example, if the card's magnetic strip is worn. If you select to manually enter the card information, you are prompted to enter CVV ID. The CVV ID is required if the Require CVV ID On Keyed Element Credit Card Sales/Authorizations control maintenance record is set to Yes. • Card Number - The 16 digit card number from the front of the card. • Expiration Date - The month and year in which the card expires. • CVV - The three digit code, typically printed on the back of the card in the signature strip. 30 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Authorizing Credit Cards Overview (Formerly known as "preauthorizing" credit cards) You can authorize a credit card sale to ensure that the customer has enough credit available, but without actually charging the customer's account. Use authorizations when you need to take a credit card payment for material that you plan to ship at a later date, and need the credit card sale to include the freight charge for the order, that you might not know until the order is ready to ship. The actual charge to the card occurs when you ship the order to the customer. Note: If you are accepting a credit card payment from a customer for an account balance, you must run that transaction as a sale transaction. You cannot authorize account payments for payment later. For more information, see Receiving Payments for Accounts in the Accounts Receivable documentation. Accepting credit card payments in this manner involves the following activities: • Entering and processing the initial authorization to hold the funds. The order taker can enter the initial authorization, or the Automatic Shipping Ticket Phantom initiates the authorization, depending on your setting in the Credit Card: Collection Approval Mode control maintenance record. If the authorization method is Authorize Only Before Shipment, the system invoices any orders that have a status of Ship When Avail. If a credit card is attached to the order, and has an authorization method of Sale Before Shipment, the phantom triggers the communication with Element Payment Services to process the transaction and charge the customer's credit card. For more information, see Printing Shipping Tickets Automatically. • Completing the authorization and actually charging the customer's card. An order or payment taker can complete the authorization directly in order entry, or the system completes the authorization using a phantom process when the print status on the order reaches the status designated for shipment, or when the system receives a ship confirmation posting from Starship. If the authorization method for the customer and card is set to Authorize Before Shipment, the Automatic Shipping Ticket Phantom performs the authorization and the completion is determined by the setting in the Credit Card: Collection Approval Mode control maintenance record. If the record is set to F, Freight Posting, the authorization completes when the system receives the ship confirmation from Starship. If the record is set to C, Credit Card Authorization Phantom, the authorization completes when the phantom runs and the transactions's print status matches those specified in the phantom driver screen. © 2016 Epicor Software Corporation. All rights reserved. 31 Authorizing Credit Card Sales Amounts on Orders Rel. 9.0.2 Authorizing Credit Card Sales Amounts on Orders You can authorize a credit card sale to ensure that the customer has enough credit available, but without actually charging the customer's account. Use authorizations when you need to take a credit card payment for material that you plan to ship at a later date, and need the credit card sale to include the freight charge for the order, that you might not know until the order is ready to ship. The actual charge to the card occurs when you ship the order to the customer. Note: The system uses the Element credentials for the price branch to process the authorization. For more information, see Authorizing Credit Cards Overview. To initially authorize a credit card on an order: 1. From an open sales order, click Totals to display the Totals tab for the order. 2. In the Credit Card field, enter the amount of the payment the customer wants to charge to their card. The Credit Card Authorization window displays. 3. Select an existing credit card, or select New to enter a new card. If you select New, manually enter the card information or swipe the card, as necessary. 4. From the Transaction menu, select Authorization Only to authorize the payment amount. The system records the authorization amount and displays it in the Authorized field on the order Totals tab . If the authorization is declined, the system sends a message to the user defined in the Credit Card Administrator control maintenance record at the payment branch, places an entry in the Credit Card Payment Review Queue, and changes the order's print status as indicated in the Override Print Status On Credit Card Denial control maintenance record. Note: The Disable Auth Only Option For Credit Card Authorizations control maintenance record must be set to No for the Authorization Only option to be available. 5. Save and process the order. If an authorization fails, the system sends a notification to the user identified in the Credit Card Administrator control maintenance record, using the method defined in the Notification Method When Credit Card Auth Fails. For information about completing the authorization process, see Completing Credit Card Payment Authorizations. 32 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Completing Credit Card Payment Authorizations (Authorizing is formerly known as "pre-authorizing") The authorization completion is triggered in different ways depending on the setting in the Credit Card Collection Approval Mode control maintenance record. • Automatic Shipping Ticket Phantom - When the authorization method is Authorize Only Before Shipment, and the print phantom selects a transaction to process that has a credit card attached to the order, the phantom triggers the communication with Element Payment Services to process the initial authorization and hold the funds against the customer's credit limit. For more information, see Printing Shipping Tickets Automatically. Processing the order as a Pick-Up Now does not trigger the card handling event indicated by the selected authorization method. • Credit Card Authorization Phantom - Use the Credit Card Authorization Phantom to select invoices on which to process payment. If open authorizations are found among the invoices, the phantom completes the initial authorization payment for the actual invoice amount. See the procedure below for more information. • Starship Shipment Confirmation - When the system receives a shipment confirmation posting from Starship, the system triggers the communication with Element Payment Services to complete the transaction for the credit card payment. • Order Totals in Sales Order Entry - Change the payment type to Sale in the actual sales order. See the procedure below for more information. You can also use the Credit Card Payment Review Queue to review payments, authorization, declines, and failures. However, the review queue does not contain an Approve option. Address authorizations and declines in each individual transaction. After the transaction processes and the credit card is charged, any additional monies set aside during the authorization are released. For example, the authorization amount is $110.00, and the order total, with shipping charges, is $107.75. The Credit Card Authorization Phantom collects $107.75 and releases $2.25 back to the credit limit. Important: The system collects the balance on the order, regardless of the original authorized amount. Depending on the final total, there are potential implications based on some credit card company operating regulations that could change your interchange rate qualification and the risk that a transaction might be subject to a charge back. For more information about avoiding this scenario, see Authorized Credit Card Payment Example. To use the Credit Card Authorization Phantom to complete a credit card payment authorization: 1. From the A/R > Utilities menu, select Credit Card Authorization Phantom to display the Credit Card Authorization Phantom window. 2. In the Branch/Territory field, enter the branch or territory from which you want the Phantom to select invoices. To include all branches or territories, type All. © 2016 Epicor Software Corporation. All rights reserved. 33 Completing Credit Card Payment Authorizations (Authorizing is formerly known as "pre-authorizing")Rel. 9.0.2 3. In the Print Status field, enter one of the following to select invoices with a particular print status: Print Status Option Description P Selects the invoice and includes it in the Detailed Invoice Preview report. This is a typical print status setting for an invoice. Q Selects the invoice and includes it in the Invoice Preview Queue, if that program is used before the Detailed invoice Preview report. N Assigns a "no print" status to the invoice. B Makes the invoice available to the Print Invoices program. M Places a flag on the manifest. 4. Select one of the following to run the Phantom and charge credit cards for the invoices that the system finds: • File > Begin - To run the authorization immediately. • Options > Schedule - To schedule the authorization to run at a later time. To complete a credit card payment authorization in a sales order: 1. In the Totals tab of the sales order, click Change Payment, and select the authorized credit card payment. 2. Update the payment amount as necessary to include the proper freight amount. 3. From the Transaction menu, select Sale to complete the authorization. 34 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Authorized Credit Card Payment Example When the system goes to collect the money for an authorized credit card transaction, it attempts to collect the order's balance due amount, regardless of the original authorized amount. Depending on the final order total, there are potential implications that could change your interchange rate qualification and could result in you losing charge back protection if the customer disputes the charge. Consider the example below to help avoid charge backs and declines when processing credit card transactions. The following settings and regulations apply to this example: • The Credit Card Collection Approval Mode control maintenance record is set to Freight Posting. • The VISA operating regulations provide a 15% tolerance in the completion amount from the initial authorization. Other credit card brands, or your merchant service provided may have differing rules for processing authorized transactions. This example deals specifically with VISA's tolerance rules. Your counter salesperson enters an order and authorizes the customer's credit card For $100. When Starship processes the order, the freight is calculated at $30. The system attempts to collect the entire order total of $130. The $30 freight charge exceeds the VISA 15% tolerance regulation. In this case, any of the following could happen: • The card's issuing bank might choose to decline the transaction. • VISA re-categorizes the transaction to a higher interchange rate. • If the customer disputes the charge, you are likely to lose the dispute because the initial authorization was not obtained for the extra $30. There are several ways to handle this scenario: You Can... More... Add an upcharge to the ship via in Ship Via Maintenance Adding a percent or minimum upcharge amount to the ship via includes the additional amount in the initial order authorization. If the ship via on the order in this example had a $20 minimum upcharge amount, the initial authorization on the order would have been for $120. The completion amount of $130 would have been within the 15% tolerance, thus qualifying the transaction for optimal interchange rates and only charging the customer's card once. Create another payment on the order for the $30 freight charge In Sales Order Entry, prior to the ship confirmation from Starship, complete the initial authorization for $100, and create a separate payment on the order for the additional $30 to cover the freight charges. This results in two charges on the customer's credit card statement: one for the $100 for the order, one for $30 for freight. Complete a separate sale transaction In Sales Order Entry, complete a sale transaction for the $100 and allow the system to complete the authorization for $30 when it receives the ship confirmation from Starship. This results in two charges on the customer's credit card statement: one for the $100 for the order, one for $30 for freight. Let the initial authorization lapse In Sales Order Entry, complete a separate sale transaction for $130 to cover the entire amount of the order and let the initial authorization lapse. This holds the funds on the customer's card in addition to the original amount of the order. © 2016 Epicor Software Corporation. All rights reserved. 35 Running the Credit Card Summary Report Rel. 9.0.2 Running the Credit Card Summary Report Run a Credit Card Summary Report to list all the approved credit card transactions for a specific date range or batch number. Both voice-authorized and system-authorized credit card transactions display in this report. Use the totals on this report and compare them to the totals on the Cash Box Journal when run for credit card types. For more information, see Cash Box Journal. To run a Credit Card Summary Report: 1. From the A/R > Reports/Journals menu, select Credit Card Summary Report to display the Credit Card Summary Report window. 2. In the Processor field, press F10 and select the processor that you use to settle your credit card transactions. You can run the report for Element, or other processors such as VITAL. The default is to run the report for all processors. 3. In the Filter Branch field, enter the branch or territory to filter the merchant numbers available for that branch. Your selection here restricts the merchant numbers available to run the report for in the Merchant Number field. 4. In the Merchant Number field, enter the ID number of the merchant to run the report for a single merchant ID. To run the report for all merchants, select All. If you are using Element Payment Services, the merchant number is the Element acceptor ID. Your processing firm assigns you a merchant number. You might have multiple merchant numbers if you have multiple branches or use more than one processing firm. • If you entered a branch or territory, or combination of branches and territories in the Filter Branch field you can only run the report for the merchants that are defined for the specified branches and territories. • If you specify a merchant number and that merchant number is also used by a branch that you did not select, any orders for that merchant number at that branch are included in the report, even though you did not select that branch in the Filter Branch field. 5. In the Report Branch field, enter the branch, branches, or territories for which you want to run the report. 6. In the Start Date and End Date fields, enter the first and last date of the period you want to include in the report. 7. In the Batch Number field, enter the batch number assigned in the End of Day Settlement Report for VITAL and TSYS, or the batch number provided by Element Payment Services. 8. In the Sort by field, select how you want to sort the contents of the report, for example, by manual or automatic authorization. 9. In the Select by Date field, if you have changed the payment date on a credit card transaction, select one of the following to determine which date to run the report by: • Cash Box - Uses the override date. • Authorized - Uses the original authorization date. 10. Set options, if needed, and run the report. 36 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services What the Report Shows The Credit Card Summary Report provides the following information: Column Description Order # The sales order number to which the credit card payment applies. Br The branch where the sales order was take and the credit card transaction initiated. Type The credit card company, such as VI for Visa and MC for Master Card. Tran Amount The dollar amount requested for payment. Compare the total of this column with the total of the CCard column for reconciliation purposes on the Cash Box Journal Report. Collect Amount The dollar amount the collect. The amount in this column should match the amount in the Tran Amount column, except for pre-authorizations, as preauthorizations are not actual payments. Auth Amount The authorization method for the transaction, for example, if ti was an automatic authorization, or a voice authorization that was entered manually. Tran Dt The date the transaction occurred. Collect Dt The date when funds were collected from the bank for the transaction. Batch # The number assigned to the group of transactions in which this transaction was processed. The system assigns a batch number when you run the Credit Card End of Day Settlement Report. Settle Dt The date when the settlement occurred. The settled date does not display if you ran the report for only the Element processor. Use the Transaction ID to identify the transaction instead. Settle Info Any information relative to the settlement of the transaction, for example, whether the card was accepted or declined. The settle information does not display if you ran the report for only the Element processor. Use the Transaction ID to identify the transaction instead. Transaction ID If you use Element Payment Services, the report includes the Element transaction ID instead of a settlement date and settlement information. The transaction ID, identifies the transaction to you within the Element system. Merchant # The merchant ID number that the processing firm assigned to you, and that the transaction was processed under. If you are using Element Payment Services, this is your Acceptor ID. Processor The processor used for the transaction, such as Element or Vital. © 2016 Epicor Software Corporation. All rights reserved. 37 Reviewing and Processing Failed and Declined Credit Card Charges Rel. 9.0.2 Reviewing and Processing Failed and Declined Credit Card Charges Use the Credit Card Payment Review Queue to view all failed, declined, and authorized credit card charges. The system places any transactions that failed due to communication-type errors or were declined due to a problem with the card in this queue for your review. Use the information in this queue to help you with re-charges for failed or declined transactions, or to call the customer to get a different credit card number. For information about using the queue to process authorized orders, see Processing Credit Card Payments on Authorized Orders. Use the information in the queue to help research why transactions failed or declined. For some declines, you might need to contact the customer for new or updated card information to reprocess the transaction. To review and process failed and declined credit card charges: 1. From the A/R menu, select Credit Card Payment Review Queue to display the Credit Card Payment Review Queue window. 2. In the Branch field, enter the branch, branches, or territories for which you want review credit card transactions. 3. In the Status field, select Failed to review only those transactions that failed due to a communication error, or Declined to view only the transactions where payment was declined on the entered and click Update. 4. Review the information about why the transaction failed or was declined by selecting the transaction and review the Authorization Message at the bottom of the list of transactions. For example, you might find that a transaction failed due to a communication error, or was declined because the card is expired. Having this information helps you make decisions about the actions to take regarding the transaction. 5. Do one of the following to approve or remove transactions in the queue: 38 To... Do this... enter new or update card information, such as updating the expiration date entered for the card Select the transaction and select Inquiry > Edit Order to display the sales order. Go to the Totals tab and enter the updated card information. You must have the SOE.OPEN.ORDER.EDIT and the SOE.ALLOWED authorization keys assigned to edit an open sales order. to reprocess selected transactions Select the Approve check box for the transaction that you want to reprocess, and select Approve > Approve Item to process a single transaction or Approve > Approve All Selected Items to process all the transactions with the Approve check box selected. approve all declined transactions From the Approve menu, select Approve All Declined to reprocess all transactions with a status of Declined. Use this option if you have researched the declines and updated the credit card information as necessary for all the cards in the queue. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services To... Do this... delete transactions from the queue Select the transactions you want to remove from the queue and use the select File > Delete Item to delete a single item or File > Delete All Selected Items to delete all the items selected in the queue. Credit card payments are not processed for transactions that you remove from the queue. Remove an item from the queue if the payment was processed using a different method, such as by cash or check or you have settled the credit card payment and do not need to reprocess the transaction. delete all transactions from the queue Use the select File > Delete All Items to delete all the items in the queue. Credit card payments are not processed for transactions that you remove from the queue. For example, use this option if you are reviewing Failed transactions that you have settled and do not need to reprocess. © 2016 Epicor Software Corporation. All rights reserved. 39 Reconciling Customer Credit Card Payments Rel. 9.0.2 Reconciling Customer Credit Card Payments Use the Credit Card Payment Reconciliation Queue to tie the credit card payments made by customers to actual bank deposits. You can reconcile the bank’s file to the credit card payments made and review when deposits have occurred by checking and changing the status and creating miscellaneous cash receipts to account for the payments. Note: To display the Credit Card Payment Reconciliation Queue information for at all times, add a widget to your Solar Eclipse main window. For more information, see Widgets and Menu Shortcuts Overview. To reconcile credits card payments: 1. From the A/R menu, select Credit Card Payment Reconciliation Queue to display the window. 2. Set the parameters for the queue to display the transactions you want to review and reconcile: Field Description Branch/Tr/All Select the branch, branches, or territories for which to populate the queue. Note: Eclipse displays the collection branch when populating the queue and creating the cash receipt. Deposit Status Select how you want to filter the queue by credit card process status: • Processed - Indicates the payment has been received but not yet deposited into an account. • Deposited - Indicates the payment has been received and deposited into the appropriate account. Credit Card Type Select which credit card you want to reconcile. You can select more than one. Starting Date Select the date range for the payments you want to review. Ending Date 3. Click Update to populate the queue. The queue displays the transaction information for each of the displayed payments: 40 Column Description Select* Use to process transactions. Select the rows that you want to approve, reconcile, or create a cash receipt for. See Step 4. Order Order number with which payment is associated. Customer Customer listed on the order. Date Date the payment was made. Time Time the payment was processed. CC Type Displays which credit card was used to make the payment. Amount The amount charged to the credit card. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Column Description Deposit Status* Change status based on where the money currently is in the payment process. See Step 5. Totals Grand total for all transactions displayed in the queue. Displays at the bottom of the window in a green highlighted row. * Only actionable columns. All other columns are view-only. 4. Use the Approve check box in one of the following ways to process transactions, as needed: To... Do this: to reprocess selected transactions One of the following: • Select the Approve check box for the transaction that you want to reprocess. • Select Approve > Approve Item to process a single transaction • Select Approve > Approve All Selected Items to process all the transactions with the Approve check box selected. approve all declined transactions From the Approve menu, select Approve All Declined to reprocess all transactions with a status of Declined. Use this option if you have researched the declines and updated the credit card information as necessary for all the cards in the queue.. 5. Use the Deposit Status column for each transaction to indicate the process status for the payment: Processed, Deposit In Progress, and Deposited. 6. Create cash receipts, if needed. 7. Save your changes and exit the queue. Creating Miscellaneous Cash Receipts for Credit Card Payments After taking credit card payments, you can tie the credit card payments to your actual bank deposits and reconcile your bank file to the credit card payments received. In this way, you can track when the payments have been deposited. After receiving your bank statement confirming deposits, you create cash receipts to reconcile the payments that you have received. Use the Credit Card Reconciliation Queue Defaults control maintenance record to define at the branch level the parameters for cash receipts are created for credit card payments through the Credit Card Payment Reconciliation Queue. To create cash receipts for credit card payments: 1. Display the Credit Card Reconciliation Queue and set the parameters for which you want to view credit card payments. 2. Use the Select check box to choose the orders for which you have received payment. 3. From the File menu, select Create Cash Receipt for Selected Items to create a cash receipt for all the items you have more selected. If no rows are selected, the system creates a cash receipt for row the cursor is on. The system uses the first branch if finds with set system defaults for the comment, deposit branch, and the bank on the Miscellaneous Cash Receipts window. © 2016 Epicor Software Corporation. All rights reserved. 41 Reconciling Customer Credit Card Payments Rel. 9.0.2 4. Post the miscellaneous cash receipt for the items selected. 5. Create more cash receipts for credit card payments or exit the window. 42 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Applying Credits to Credit Cards for Returns When a customer paid for an order using a credit card, credit any refunds or returns back to the same card. A returned product is linked to its original sales order, therefore, the original card information is used as the default credit card for the return order. However, you might encounter the following scenarios: • If you do not have the original sales order number, create a new sales order to process the return. • If you have the original sales order number with the credit card information, enter the return quantity on the original order, and credit the card used to pay for the original order. The settings in the Sales Order Entry Return Setup control maintenance record determine how returns to credit cards are handled in order entry. If the Require Same Credit Card on Return option in the record is set to Yes, the amount of returned items are applied to the same credit card they were originally ordered with. If the Require Original Invoice When Adding Return Item To Order option in the record is set to Yes, you must have the original sales order number to credit the card for the return. Note: The system uses the Element credentials (acceptor ID for the branch, etc) that were used on the original order, regardless of the branch where the return is being processed. However, if the card on the original order is now expired, the system deletes that card from the return order. To return a product in Sales Order Entry, see Returning Product from Sales Order Entry in the Sales Management documentation. To apply a credit to the credit card for a return: 1. From the Orders menu, select Sales Order Entry to display the Sales Order Entry window and create a return order. In the Return Goods Verification window, if you have the original order number, enter it to verify that the products were purchased. When you return to the Body of the order, the negative quantities are entered for you. 2. Click the Totals tab and enter the refund as a negative amount in the Credit Card field. 3. In the Credit Card Authorization window, do one of the following: If... You entered the return quantity on the original sales order Then... 1. 2. Verify that the information in the Credit Card Authorization window is correct for the card to which you want to refund the charge. The system displays the card information for the card used to purchase the items. From the Transaction menu, select Sale to credit the card. © 2016 Epicor Software Corporation. All rights reserved. 43 Applying Credits to Credit Cards for Returns If... You did not have the original order number, and created a new order to process the return Rel. 9.0.2 Then... 1. Either select New to credit a card that you do not have or select a card that the customer has on file. 2. Enter the card holder, zip code, and billing street address for the card. 3. From the Transaction menu, select Sale and do one of the following: • Select Swipe. The system displays the Element Process Transaction window in your default web browser. Run the card through your card reader. The system gathers the card information, including the CCV code from the back of the card. • Select Key Enter to manually enter the card information in the fields provided in the Element Process Transaction web page, which displays using your default web browser. For example, if the card's magnetic strip is worn. If you select to manually enter the card information, you are prompted to enter CVV ID. The CVV ID is required if the Require CVV ID On Keyed Element Credit Card Sales/Authorizations control maintenance record is set to Yes. • • • 4. Card Number - The 16 digit card number from the front of the card. Expiration Date - The month and year in which the card expires. CVV - The three digit code, typically printed on the back of the card in the signature strip. Click Process Transaction to submit the information and process the transaction with Element. 4. When the request completes, Element returns an authorization code for the transaction. The authorization code displays in the Authorization Code field for reference. If the returned authorization code is *Call* or something similar, you need to call the credit card company for authorization. See Manually Entering Credit Card Authorizations. 44 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Voiding Credit Card Transactions If a customer makes a change to an order, or for any other reason, you can void a credit card transaction. Void the original credit card transaction before attempting to accept a different payment. Note: The system uses the Element credentials for the price branch to process the void. If the charge transaction has already been settled, you must refund the amount instead of voiding the transaction. To void a credit card transaction: 1. In the Totals tab of the order, click Change Payment and select the payment you want to void. 2. Verify that the information in the window for the transaction is correct. 3. From the Transaction menu, select Void to void the sale. The Void menu option is only available if the sale amount has not been settled. If it is too late to void a transaction, process a refund instead. © 2016 Epicor Software Corporation. All rights reserved. 45 Returns at a Different Branch than Purchase Branch Guidelines Rel. 9.0.2 Returns at a Different Branch than Purchase Branch Guidelines When a customer purchases a product in one branch, and then returns it in another branch, the credit card that Element processed references the original purchase branch, or acceptor ID, of the order. The branch on the return for Cash Box purposes shows the branch to which the product was returned. In this scenario, do one of the following: • When processing a return for a product that was paid for using a credit card, always ask for the credit card and swipe or manually enter the credit card return so Element process it to the return branch. Then your Cash Box Journal and Credit Card Summary reports as you usually would to tie out your cash box. • Run the Cash Box Journal as usual, and run the Credit Card Summary Report with the following settings: 46 Field Setting Processor Element Filter Br/Tr/All All Merchant Number All Sort by Card Type Select by Date Cash Box © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Managing Element Payments Accounts Overview As you save credit card information either to a customer, contact, or an order, the system creates Payment Account Secure Storage (PASS) accounts, also known as payment accounts, with Element Payment Services. Your contract terms with Element indicate the charges you pay for the number of payment accounts you maintain. To reduce your costs for storing credit card information, we recommend that you review your payment accounts once a month and delete the accounts you no longer need. For example, consider deleting payment accounts for cards that have expired, for customers or contacts who have credit card information on file but have not done business with you in six months (or less), and for credit card transactions for orders that were placed using a miscellaneous cash customer record, such as for walk-ins to your counter. Using the PASS Account Utility, you can schedule to delete payment accounts that meet a certain set of criteria, or you can view and delete payment accounts manually. When you delete an account, the system deletes the information from Element and from Eclipse. For example, if you delete a payment account for credit card information stored at the customer-level, the system deletes the payment account from Element and removes the saved credit card from the customer record. As you are processing transactions or entering credit card information for a customer or contact and the power goes out, the internet goes down, or for some other reason the payment account for the information you entered is not created, there is credit card information in Eclipse that does not have a matching payment account in Element, rendering it useless. In these circumstances, an overnight routine removes the credit card information from Eclipse. However, if the system finds a payment account in Element that does not have matching information in Eclipse, the system creates the information in Eclipse using the saved data in Element. © 2016 Epicor Software Corporation. All rights reserved. 47 Viewing and Manually Deleting Element Payment Accounts Rel. 9.0.2 Viewing and Manually Deleting Element Payment Accounts Using the PASS Account Utility, you can view and delete payment accounts manually. We recommend that you review your payment accounts at least once a month to ensure that you are being billed for only the payment accounts that you need. You can also schedule a phantom process to delete the accounts that meet your selection criteria on a regular basis. For more information about scheduling account deletions, see Scheduling Element Payment Account Deletions. Use the selection criteria in the PASS Account Utility to control the performance of the search return time. For example, limit the date range of expiration dates or search for one card type at a time. Important: When you delete a payment account, the system deletes the information from Element and from Eclipse. You must enter that credit card information again in Eclipse to use the card. The system cannot delete a payment account if there is an open order waiting to use the credit card associated with that account as payment. For more information about why it is important to manage your Element Payment Accounts, see Managing Element Payments Accounts Overview. To view and delete an Element Payment Account: 1. From the System > Custom > Add On Products > Credit Card menu, select Element PASS Account Utility to display the PASS Account Utility window. 2. Select the criteria you want to use to filter your payment accounts for deletion. You must specify a card brand, an expiration date range, or both. 48 Field Description Acceptor ID Much like a merchant number, Element assigns you unique acceptor IDs to identify you as an Element customer. Depending on your business relationship with Element, you might have a different acceptor ID for each branch, or you might have a single acceptor ID that encompasses more than one branch. Enter the acceptor ID for which you want to view and delete payment accounts. To enter more than one acceptor ID, click the Multiple button next to the field. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Field Description PASS Type (Optional) Select the type of payment account you want to view or delete: • Customer - Includes payment accounts created for credit cards that you entered as default cards for a customer. • Contact - Includes payment accounts created for credit cards that you entered s default cards for a contact. • Open Order - Includes payment accounts for credit cards that you added and saved to an order that still has an open balance or an open generation. • Closed Order - Includes payment accounts for credit cards that you added and saved to an order that has a balance of $0.00 no open balance or any open generations. For example, if you want to delete all your payment accounts for a particular customer, select Customer to help narrow the list. If you want to delete payment accounts for all orders that you placed under a miscellaneous cash customer, select Closed Order. Card Brand Select the card type, such as Visa or MasterCard, to narrow the list of payment accounts to only those associated with that card type. For example, if you decide that you are no longer going to accept American Express, select that card type to view and delete only the payment accounts associated with American Express cards. You must specify a card brand, an expiration date, or both. Expire Begin Enter the first date in a range of dates to view only payment accounts that contain cards that expire in or after that month. The day of the month is provided here for variable dating purposes, however, the system ignores the day you enter, as credit cards expire on the last day of the month listed as the expiration date on the card. The year 2101 and 2001 both end in 01, thus they look like the same year. To get accurate results when searching for payment accounts, the expire begin date should not be prior to 1980, and the expire end date should not be after 2080. You cannot query for a date range greater than or equal to 100 years. If you leave this field blank, the system starts its search for cards expiring in January 2000. Expire End Enter the last date in a range of dates to view only payment accounts that contain cards that expire in or before that month. The day of the month is provided here for variable dating purposes, however, the system ignores the day you enter, as credit cards expire on the last day of the month listed as the expiration date on the card. The year 2101 and 2001 both end in 01, thus they look like the same year. To get accurate results when searching for payment accounts, the expire begin date should not be prior to 1980, and the end date should not be after 2080. You cannot query for a date range greater than or equal to 100 years. If you leave this field blank, the system ends its search in December of the current year plus 11 years. For example, 2010+11 = December 2021. © 2016 Epicor Software Corporation. All rights reserved. 49 Viewing and Manually Deleting Element Payment Accounts Rel. 9.0.2 Field Description Last Activity Over __ Days Ago Enter a time period to view or delete only those payment accounts with cards that have been charged since that time. For example, if you want to view and delete cards that have not had activity for over three months, enter 90 in this field. If you enter a last activity date and schedule a phantom process to complete your deletions, the system deletes cards you might have entered but not yet charged. Your search time can increase if you choose to search using a last activity date. 3. From the File menu, select View PASS Accounts to display the Element Payment Account Management window. The window lists the view-only payment account information for the accounts that meet the criteria you entered. Field Description PASS Type The type of transaction or entity to which the payment account is connected: • Customer - Payment accounts created for credit cards that you entered as default cards for a customer. • Contact - Payment accounts created for credit cards that you entered as default cards for a contact. • Open Order - Payment accounts for credit cards that you added and saved to an order that still has an open balance or an open generation. • Closed Order - Payment accounts for credit cards that you added and saved to an order that has no open balance or any open generations. If this field is blank, there is credit card information in Eclipse that does not have a matching payment account in Element, rendering it useless. You can choose to delete these accounts manually, or, the system deletes them the next time the overnight routines run. Card # The last 4 digit of the credit card number. For example, use this information if you want to contact the customer about a card that has or is going to expire. Expire The date the credit card expires. Name The customer or contact to whom the card belongs. If the card is saved only to an order, this field displays the order number. Last Used The date the card was last used to pay for an order. If you did not specify a last activity date in the PASS Account Utility window, the Last Used column is blank. If you do specify a last activity date, the Last Used column is blank if the card exists in the system but has not been used to process any payments. Note: Select an account and select Detail from the File menu to display the following additional information regarding the payment account: 50 Field Description Reference Number A number that is assigned to the payment account to reference it in Eclipse and tie it to the account in Element. © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Field Description Card Brand The card type, such as Visa or MasterCard. PASS GUID The payment account number as generated by Element. This number is provided for troubleshooting purposes. Note: Click Edit to display the customer, contact, or order associated with the payment account. 4. To delete a payment account, do one of the following: To... Do this... Delete a single payment account Select the account, and then select File > Delete. Delete all the payment accounts in the view From the File menu, select Delete All. All payment accounts that matched your initial criteria and that are available in the view are deleted. © 2016 Epicor Software Corporation. All rights reserved. 51 Scheduling Element Payment Account Deletions Rel. 9.0.2 Scheduling Element Payment Account Deletions Using the PASS Account Utility, you can schedule a phantom process to delete payment accounts that meet a set of criteria. We recommend that you delete unnecessary payment accounts at least once a month to ensure that you are being billed for only the payment accounts that you need. For more information about why it is important to manage your Element Payment Accounts, see Managing Element Payments Accounts Overview. Important: When you delete a payment account, the system deletes the information from Element and from Eclipse. You need to enter that credit card information again in Eclipse to use the card. Using the selection criteria, you determine the payment accounts that are deleted on a scheduled basis. For example, a couple of days before Element generates your bill, you might want to delete all payment accounts that were created for cards saved to orders that no longer have a balance due or any open generations. Set your search criteria to include Closed Order PASS Types and a particular card brand. You can schedule multiple phantom processes to capture deletions for each card branch. Scheduling these deletion types ensures that open orders retain their information, as you still need those payment accounts. To schedule payment accounts to be deleted: 1. From the System > Custom > Add On Products > Credit Card menu, select Element PASS Account Utility to display the PASS Account Utility window. 2. Enter the criteria that you want to use to select the payment accounts to delete. For more information about the selection criteria, see Viewing and Deleting Element Payment Accounts. 3. From the Options menu, select Schedule to display the Phantom Scheduler window. 4.Schedule the PASS account deletions, as necessary. The date fields accept variable dating. For more information about scheduling a phantom process, see Scheduling Phantom Processes in the System Maintenance documentation. 5.Save your changes and exit the window. 52 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Converting to the Element Payment Services Solution Overview Prior to processing credit card payments using the Element Payment Services solution, complete the following conversion activities so your data is set up correctly: 1. Upgrade to Release 8.6.8 or later of the Eclipse software. 2. Establish your agreement with Element and receive your credentials with them. 3. The night prior to your specified Element conversion date, which you have coordinated with Epicor Eclipse and Element, complete the following: • Complete all your in-process transactions in Eclipse and settle transactions with your old credit card solution. This includes any transaction that is a "pre-authorized" state. If you do not complete the sales for pre-authorized transactions and run the conversion, you need to let the authorization expire and enter the credit card transaction again. "Pre-authorized" transactions that are not complete are not included in the conversion. • Run the contact and customer conversion utility to convert your Eclipse customer and contact credit card information into tokens and to create the appropriate payment accounts in the Element database. For more information, see Running the Credit Card Data Conversion. • Run the transaction conversion utility to convert credit card information on orders into tokens and to create the appropriate accounts in the Element database. • Run the Element Credit Card Purge Utility to strip all but the last for digits of any card number that was not converted to a an Element account. This includes card numbers in log and activity files. 4. Replace your old swipe devices with the new encrypted swipe devices. 5. Verify your credit card control maintenance record settings. 6. Verify that your processor and range are setup for use with Element. 7. Inform Activant Solutions that you are no longer using the Eclipse-TSYS solution to begin the discontinuation process. © 2016 Epicor Software Corporation. All rights reserved. 53 Converting Customer and Contact Data for Element Rel. 9.0.2 Converting Customer and Contact Data for Element The weekend of your specified conversion date, you must run the contact and customer conversion utility to convert the historic credit card data in your customer and contact records system to create tokens and to create any necessary payment accounts for stored cards. When you run the conversion, the system creates a payment account in the Element database for each credit card it finds in a contact or customer record. We strongly recommend that you review the created accounts using the PASS Account Utility to verify that all the created accounts are required prior to your first Element billing cycle. Because the system is converting all saved cards, you might find that you have payment accounts for customer and contacts you no longer do business with, or expired cards that are no longer valid. You can run the customer and contact conversion more than once if you receive errors during the first run. If a PASS account has been created for a card, it does not get created a second time. Note: The conversion process does not convert any credit card information that exists within your Hold file entries. To delete this information, delete the file and regenerate it after the conversion. To run the convert customer and contact data for Element: 1. Ensure that you have completed the necessary steps listed in Converting to the Element Payment Services Solution Overview. 2. Log in to the character-based system. The conversion utility is run only at the time you are converting from your old credit card system to Element, and exists only in the character-based interface. 3. From the System > System Files > Custom > Credit Card Setup menu, select Element Contact and Customer Conversion to display the Convert CC to Element screen. 4. Select one of the following to convert your credit card information: • Begin - Use this hot key to start the conversion process immediately. • Schedule - Use this hot key to schedule your conversion process to run at a later time. 5. View the report that the system places in your Hold file to verify the results of the conversion. 54 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Converting Transactions for Element The weekend of your specified conversion date, you must run the transaction conversion utility to convert the credit card data in your transactions system to create tokens and to create any necessary payment accounts for stored cards. When you run the conversion, the system creates a payment account in the Element database for each credit card that is stored on an order in the CC Info window. We strongly recommend that you review the created accounts using the PASS Account Utility to verify that all the created accounts are required prior to your first Element billing cycle. Because the system is converting all saved cards, you might find that you have payment accounts for expired cards that are no longer valid. Note: The conversion process does not convert any credit card information that exists within your Hold file entries. To delete this information, delete the file and regenerate it after the conversion. You can run the transaction conversion more than once if you receive errors during the first run. Important: Run the transaction conversion after hours after you have run the customer and contact conversion. After the conversion is complete, and credit card listed in the CC Info window can only be processed using Element. To convert transactions for Element: 1. Ensure that you have completed the necessary steps listed in Converting to the Element Payment Services Solution Overview. 2. Log in to the character-based system. The conversion utility is run only at the time you are converting from your old credit card system to Element, and exists only in the character-based interface. 3. From the System > System Files > Custom > Credit Card Setup menu, select Element Transaction Conversion to display the Convert Transactions to Element screen. 4. In the Convert order closed ____ days in the past field, enter the number days in the past the system should convert orders. The transaction conversion converts any closed order that has been settled in the last number of days that you enter here. Use this field to help manage credits for orders that are still within your return order policy. If a card is not converted to Element for a closed order, you have to gather the credit card information from the customer again to manually create a new Element payment account to issue a credit for the return. 5. Select one of the following to convert your credit card information: • Begin - Use this hot key to start the conversion process immediately. • Schedule - Use this hot key to schedule your conversion process to run at a run at a later time. 6. View the report that the system places in your Hold file to verify the results of the conversion. Fix any errors that might have occurred, for example, invalid card numbers, and run the conversion again. © 2016 Epicor Software Corporation. All rights reserved. 55 Purging Unconverted Credit Card Data for Element Rel. 9.0.2 Purging Unconverted Credit Card Data for Element After you run the customer and contact conversion and the transaction conversion, there may be credit cards that were not converted to Element PASS accounts. To be compliant with the credit card rules, all credit card numbers left over in the system, for example in change logs and customer, contact, or orders cards that did not get converted, only the last four digits of the card number can be visible or stored in the system. Use the Element Credit Card Purge utility to trim all credit card numbers that remain in the system to display and store only the last 4 digits of the card's number. Note: The purge process does not convert any credit card information that exists within your Hold file entries. To delete this information, delete the file and regenerate it after the conversion. Important: Run the purge utility after you have completed all other Element conversion activities. To purge any unconverted credit card data for Element: 1. Ensure that you have completed the necessary steps listed in Converting to the Element Payment Services Solution Overview. 2. Log out and back into the character-based system after completing the transaction conversion. 3. From the System > System Files > Custom > Credit Card Setup menu, select Element Credit Card Purge to display the Convert CC to Element screen. 4. Select one of the following to purge your credit card information: • Begin - Use this hot key to start the purge process immediately. • Schedule - Use this hot key to schedule the purge process to run at a run at a later time. 56 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Chip & PIN Overview Epicor and Element have collaborated on a solution that supports both the Chip & PIN credit card processing and the Interac PIN Debit using a Verifone device connected to First Data Canada through the Element Express platform. A chip & PIN credit card contains a microchip for processing in addition to the magnetic strip. The solution uses a special TriPOS application and device to interface between the Eclipse application and the Element processing platform. The triPOS device is designed to process the Chip & PIN transactions and supports processing of debit and credit transactions through the Element Payment Services Express platform. The triPOS payment processing application accepts requests from business management software suites for processing end-to-end financial transactions through the Express platform: The following sequence details the interactions that take place between the different components during a typical payment transaction with triPOS : 1. Eclipse sends a payment request to the triPOS payment processing application: a service running on the local PC at the counter. 2. TriPOS interfaces with the PINpad to obtain the card information, manages cardholder selection of options and verification, then retrieves the EMV tags or tokens required to complete the transaction. 3. If necessary, triPOS sends the transaction to the Express platform to be forwarded to the cardissuing bank for approval. 4. After receiving a response from the Express platform, triPOS proceeds with final validation of the transaction with the PINpad. 5. triPOS generates the merchant and cardholder receipts. triPOS then returns a complete response to Eclipse, including the receipts. 6. Eclipse creates a payment in the Totals tab and prints the receipts on the Ship Ticket and Invoices form returned by triPOS . Note: If you use Eclipse Forms, the system prints the receipt received by triPOS on your form in the standard receipt location. Use the Chip & PIN Installation and Configuration to set up your system to interface to the Express platform using the triPOS payment processing application in order to support card present and Chip & PIN (EMV) transactions. TriPOS uses the local TCP/IP socket connection to process payments. TriPOS © 2016 Epicor Software Corporation. All rights reserved. 57 Chip & PIN Overview Rel. 9.0.2 accepts an XML-formatted request message and returns an XML-formatted response. The XML format of a triPOS message is similar to that of the Express platform. The system handles credit card and debit card transactions equally. The only requirements are the credentials passed by Element Payment Services and the application identifiers. For information about how the Eclipse system interfaces with the Chip & PIN device, see Using the Chip & PIN Interface. Note: Content within the Chip & PIN documentation used with permission from Element Payment Services, Inc. 58 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Chip & PIN Installation The triPOS payment processing application consists of binary files, configuration files, and supporting files hosted in a dedicated directory structure. In addition, two separate directories receive runtime log files and transaction receipts are required. Each site that runs the Chip and PIN program needs to install the software independently. Note: We recommend a system administrator complete the tasks outlined in this section to ensure the safe and accurate installation. This topic addresses the following information: • Software Prerequisites • Downloading triPOS for Element • Configure triPOS Signature File • Considerations for Windows Environments • Starting TriPOS Services on a Windows Machine • Considerations for UNIX and LINUX Environments Software Prerequisites Eclipse and the triPOS payment processing application reside on the same physical machine to which a PIN pad is attached using a serial connection. TriPOS has been PA-DSS validated for the following operating systems through Element Payment Services: • Windows Server 2003 / 2008 • Windows Vista • Windows 7 • Linux 5.6 / 6.0 • Java Runtime Environment (JRE) - More JRE should be installed with your Eclipse software. The latest Java Runtime Environment distribution corresponding to the desired operating system platform can be downloaded from the Oracle website located at http://www.oracle.com/technetwork/java/javase/downloads/index.html. From this deployed installation, the triPOS payment processing application communicates with the Express platform through a secured Internet connection. TriPOS accepts communication only from software running on the lcoal PC, therefore Solar is the only supported interface for Chip & PIN. Note: Eclipse server calls to triPOS are not supported, therefore the Eterm interface is unable to operate with triPOS , nor can triPOS be run on any terminal server because it only accepts calls from the local PC. © 2016 Epicor Software Corporation. All rights reserved. 59 Chip & PIN Installation Rel. 9.0.2 Downloading triPOS for Element In addition to the standard PC software mentioned above, you must download the triPOS files containing the application to your machine: 1. Log on to the customer support website: http://support.epicor.com/ 2. Click on Support. 3. Go to the Download Center. 4. Click Element. 5. Download the triPOS .zip file and save it to your local machine. The zip file contains all the code necessary for the triPOS application to run in different environments. Note: The system runs a triPOS setup mini-wizard prior to installing the actual triPOS application. 6. Locate the corresponding folder for your operating system and load the files to your machine. The triPOS zip file will look something similar to the graphic below. There is no bin folder. Ultimately, you are creating a new bin folder and copying the contents of the bin folder from the respective bin.X folder that matches the type of system you are installing triPOS on. 7. Refer to the following sections for loading your environment's files: • Considerations for Windows Environments • Considerations for UNIX and LINUX Environments After downloading the application, you will need a VeriFone® VX810 device with the TriPOS application loaded onto it. For more information and to purchase this device, contact your Eclipse account manager. Note: If your PC does not have a serial port (the connection method the device is sold with), a serial-to-USB adapter can be purchased. 60 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Considerations for Windows Environments The triPOS payment processing application is integrated with Microsoft Windows platforms to run as a Windows service. We recommend using the following for the triPOS directory: C:\TriPOS. Note: Long directory names or directory names containing spaces or special characters may not be supported. The following files are specific to Windows installations: TriPOS\ | + bin\ | + | + | + | + | | | | | InstallService.bat UninstallService.bat wrapper.exe native\ + lib\ + jspWin.dll + sjarcl.dll + wrapper.dll For Windows 32bit installations, copy the contents of the distribution bin.Win directory structure to the TriPOS\bin directory. For Windows 64bit installations, copy the contents of the distribution bin.Win64 directory structure to the TriPOS\bin directory. Note: Windows 32bit files should be used if a 32bit version of the JRE is used, even on a 64bit operating system. After all files have been copied to the target machine, install TriPOS as a Windows service named TriPOS for Express by double-clicking the InstallService.bat batch file located in the TriPOS\bin directory. The service can be uninstalled by running the UninstallService.bat batch file. Note: The install and uninstall processes should be performed by a system administrator. By default, the triPOS Windows service must be started manually by a user, but its properties can be changed to run automatically when the machine starts. © 2016 Epicor Software Corporation. All rights reserved. 61 Chip & PIN Installation Rel. 9.0.2 A user running the triPOS Windows service must have the following privileges: • Read access to the entire triPOS directory structure • Write access to the TriPOS\conf, TriPOS\logs, and TriPOS\archive directories. • Authorization to bind to a TCP port The listening port needs to be opened for local TCP connections if a software firewall is running. To start the triPOS service on a windows machine: Note: These instructions may vary slightly between machines depending on your operating system. These steps are for WindowsXP. 1. On your machine, locate the Control Panel. 2. Click Administrative Tools. 3. Double-click Services. 4. Locate triPOS.NET service and highlight it. (Shown below) 5. On the left pane, click Start the Service. Or from the Action menu, select Start. 6. The files load to the default directory: 7. Set Up Chip & PIN in Solar Eclipse. For more information about configurations, see Chip & PIN Configurations. 62 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Considerations for UNIX and LINUX Environments The triPOS payment processing application installed on Unix platforms is designed to run as a background process controlled by a startup script. Suggested triPOS directory is /opt/TriPOS, /var/TriPOS, or /usr/local/TriPOS. The following files are specific to Unix installations: TriPOS/ | + bin/ | + TriPOS | + wrapper | + native/ | + lib/ | + libjspLux86.so – or – libjspLux86_64bit.so | + libsjarcl.so | + libwrapper.so | + run/ | For Linux 32bit installations, copy the contents of the distribution bin.Linux directory structure to the TriPOS/bin directory. For Linux 64bit installations, copy the contents of the distribution bin.Linux64 directory structure to the TriPOS/bin directory. A user running the triPOS process must have the following privileges: read access to the entire triPOS directory structure • Execute access to the contents of the “TriPOS/bin” and the “TriPOS/bin/native/lib” directories • Write access to the “TriPOS/bin”, “TriPOS/run”, “TriPOS/conf”, “TriPOS/logs” and “TriPOS/archive” directories and their contents • Read/write access to the communications port to which the PINpad is connected (e.g. “/dev/ttyS1” or “/dev/ttyUSB1”). Please refer to the configuration section below for the definition of the ComPort item. Note: If device's permissions are changed manually, the permissions are not persisted during reboot, and the proper configuration commands need to be included into the boot-up sequence in order to persist. For this reason, the preferred means for giving a specific user read and write permissions to a device is to make this user a member of the group pertaining to the device. In addition, if a software firewall such as iptables is running on the host machine, the network port on which the triPOS application is listening for requests needs to be opened for local TCP connections. After all files have been copied to the target machine and privileges set, start triPOS using the triPOS executable script located in the TriPOS/bin directory. Start the background process using the triPOS start command. Use the triPOS stop command to quit the process. For more information about configurations, see TriPOS Configurations. © 2016 Epicor Software Corporation. All rights reserved. 63 Using the triPOS Automatic Installation Rel. 9.0.2 Using the triPOS Automatic Installation In order to ease the triPOS installation, Eclipse provides a triPOS Setup Wizard. This wizard runs an installer that installs both the required driver for your chip & PIN devices and the triPOS software needed to accept payment transactions using the chip-enabled credit cards. To run the triPOS installation: 1. From the System > System Files > Credit Card Setup menu, select triPOS Install to display the installation wizard. 2. In the Configuration Information window, enter the following for which you are installing: • Company name - The company name for which you are installing. This name displays on the PIN pad device's welcome screen. • Branch - The branch to determine from where the system should gather the Additional Credit Card information, such as the acceptor ID, account ID, and account token. 3. Click Next. 4. In the Default Lane Setting and Serial/USB Information window, click Next to accept the defaults. 5. In the Ready to Install triPOS window, click Install. A progress window displays the percentage complete as the installation continues. 6. At the prompt click OK. 64 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services TriPOS Configurations for Automatic Installs After completing the installation process automatically, review the following configuration details to complete the setup for using TriPOS with the Element Payment Service. The system stores the TriPOS configuration details in an XML file named TriPOS.config in the TriPOS/conf directory. After configuring TriPOS, this file needs no further modification. However, before using the TriPOS application, some configuration items need to be set to their proper values. The following XML data elements are grouped in various sections: Note: All elements are alphanumeric unless otherwise indicated. Bold text indicates a value that must be changed during installation. The TriPOS.config file can be edited using any text editor. Notepad++ is a good option. APPLICATION ServerPort (Integer): TCP port used by TriPOS to accept requests from the client application. Any nonassigned TCP port value can be used. By default, Eclipse is configured to communicate with TriPOS on port 8080. This is the port on the PC, not the Eclipse server. Port conflicts on the PC are unlikely, but an override port option in Eclipse is available by setting a value in the Element TriPOS Application Port (Chip & PIN) control maintenance record. The value in the TriPOS.config file should be set to 8080, or match what is specified in this control maintenance record. ArchivePath: Directory path where archived receipts are stored. Defaults to the TriPOS/archive directory, if omitted from the config file. TORRetryDelay (Integer): Delay in seconds before a failed TOR is retried. Defaults to 30 seconds if omitted from the config file. EXPRESS Url: URL of the Express platform. The defaults is https://certtransaction.elementexpress.com. However, when moving to live processing, the URL must be modified to https://transaction.elementexpress.com. HOST MerchantID: Host merchant identifier (number), provided by Element Payment Services. TerminalID: Host terminal identifier (number), provided by Element Payment Services. This number is unique to each PC or device. MERCHANT Name: Merchant name as it appears on receipts. AddressLine1: Merchant first address line as it appears on receipts. AddressLine2: Merchant second address line as it appears on receipts. Phone: Merchant phone as it appears on receipts. Language: ISO 639-1 language code for merchant receipts (“en” for English, “fr” for French). © 2016 Epicor Software Corporation. All rights reserved. 65 TriPOS Configurations for Automatic Installs Rel. 9.0.2 CurrencyCode: Merchant’s default ISO 3166-1 currency code (e.g. “124” for CAD). MerchantCategoryCode: Visa/MasterCard Merchant category code. TerminalCategoryCode: Terminal category code (e.g. “R” for retail). PINPAD ComPort: Name of the communications port on which the PINpad is connected. For example, COM4 for Windows machines and /dev/ttyS4 or /dev/ttyUSB4 for Unix machines. BaudRate (Integer): Communication speed for the port (defaults to 9600). DataBits (Integer): Number of data bits for the port (7 for even parity, 8 for no parity - default). FlowControl: By default, TriPOS implements the RTS/CTS flow control to communicate with the serial PINpad device. This is optional. You can also use XONXOFF for configuration item or Xon/Xoff for flow control. Use NONE for no flow control support. IsAttended: “true” if terminal is attended (default), “false” otherwise TRANSACTION IsCashbackAllowed (Boolean): Defaults to false. Set to true if cash back is allowed, or leave as false. If true, TriPOS offers the cardholder to enter a cash back amount on the PINpad during debit transactions. Note: This feature is not currently supported by Eclipse. Leave it as false. SurchargeAmount (Double): Optional fee added to debit transactions, such as 0.25. Note: This feature is not currently supported by Eclipse. Leave it as 0.00. RESTARTING After updating the TriPOS.config file, restart the TriPOS service, if it has already been started, to apply your new configuration settings. Also note that the TriPOS application updates the TriPOS.config file, inserting some encrypted information, so when you edit the file in the future (not common), parsing the XML to modify the values may be different than when you first updated the configuration file. 66 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Configuring Signatures for Chip & PIN In order to successfully capture signatures with the triPOS devices, you must copy the triPOS signature file for the triPOS automatic installer to use. If this process is not completed ahead of time, you can receive the following message from the installer program: Setting the signature format FAILED. Contact Eclipse Support for more information. After validating that triPOS service is started, stop the service and modify the triPOS.config file. Note: The following instructions are for a Windows machine. To configure the signature file: 1. From the Start menu, select Control Panel and then Administrative Tools. Note: Depending on your system operating system, you may need to select System and Security to access the Administrative Tools. 2. Right-click triPOS Service and select Stop. 3. Replace the config file by doing the following: • Delete the following file: c:\install~yyyymmdd~9999999999\triPOS.config. • Open Windows Explorer and locate the following file: c:\Program Files\Vantiv\triPOS Service\triPOS.config This path may change based on your operating system. For example, Program Files may be Program Files(x86). • Copy the file and paste it in your main c:\ directory. Window Explorer prompts you with a Copy File window. Select Copy and Replace to ensure you have the latest file. • If you are not the administrator on the computer, a Destination Folder Access Denied window may display. Click Continue. 4. Right-click triPOS Service and select Start. To modify the triPOS.config file: 1. Select the triPOS service and right click to select ‘Stop’ option. © 2016 Epicor Software Corporation. All rights reserved. 67 Configuring Signatures for Chip & PIN Rel. 9.0.2 2. Open the triPOS configuration file located in …\Vantiv\triPOS Service, change the value of the signatureFormat tag to ‘Ascii3Byte’. Ascii3Byt 3. After save the change, go to Services screen and start the triPOS service. 68 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Setting Up Chip & PIN Before using the chip & PIN interface, you must activate it for each terminal. branch in the system. To activate the chip & PIN interface for the terminal: 1. From System > System Files menu, select Terminal Setup. 2. From the File menu, select Credit Card. 3. Select Connect to TriPOS when Card Present Selected. Note: When this option is enabled, the system ignores the PIN Debit Enabled option set in Additional Credit Card Information from Branch Maintenance. 4. Click OK and close Terminal Setup. To activate the chip & PIN interface at the branch level: 1. From the Maintenance > Branch menu, select Branch to display the Branch Maintenance window. 2. From the Maintenance menu, select Credit Card Branch Setup. 3. Select the Element processor from the list. 4. From the Additional menu, select Additional Credit Card Information. 5. Select PIN Debit Enabled and click OK. 6. Save your changes and exit the window. The Account ID, Account Token, Terminal ID and Acceptor ID (also referred to as MID or Merchant ID) are values provided by Element Payment Services that need to be populated in the screen for successful PASS and key-entered transactions that are performed directly with the Element Express platform. For more information, see the Element Payment Services documentation. © 2016 Epicor Software Corporation. All rights reserved. 69 Using the Chip & PIN Interface Rel. 9.0.2 Using the Chip & PIN Interface Epicor and Element have collaborated on a solution that supports both the Chip & PIN credit card processing and the Interac PIN Debit using a Verifone device connected to First Data Canada through the Element Express platform. The Eclipse system behavior for credit card processing with Element has been modified at the branch level. These modifications help Eclipse communicate with the TriPOS application that runs locally on the PC that the Verifone device is connected. The communication occurs when the Sales Order Entry user selects Sale and chooses Card Present as the capture form for a new card. Then, the TriPOS application takes over and communicates with the device leading the user through prompts to process the Chip & PIN credit or Interac Debit transaction. After the transaction is complete or canceled, the device communicates the result back to Eclipse for payment creation or error or decline recording. Important: The Sales Order Entry change log captures canceled transactions, declined credit card transactions, Force Stop actions and any TriPOS response messages for easy tracking and review. Note: The TriPOS application is not used when PASS information is selected for the Sale transaction in Customer Maintenance. Running the Chip & PIN Verification The TriPOS service on the counter computer runs as a local web service. The XML configuration file specifies which port on the PC handles communication between Eclipse and TriPOS device. The Eclipse programs are configured so a port is specified and ensures communication with the device. Note: If you are using the Starship companion product in conjunction with the Chip & PIN device, you cannot use the authorization phantom and must handle authorization outside the Chip & PIN device. When the user selects Sale in the Solar Charge Credit Card screen and selects the Card Present option, a successful communication with TriPOS application displays: You can stop the process, if needed. If you select Force Stop, the system alerts you that the process was stopped while waiting for a response from triPOS. The card processing is canceled and you can try again. If the transaction is unsuccessful the system alerts you that an error occurred when creating the Element session. Make sure the TriPOS service is started. When the device is connected to the PC successfully, the screen displays TRIPOS on the screen. The TriPOS application steps users through a series of prompts. The prompts depend on the issued card, selected options and processing options. 70 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Note: The screen in Solar times out after two minutes of launching. Two minutes allows users time to complete the process with the VeriFone device, including swiping their card, providing a PIN or signature, and removing their card, if necessary for a successful payment capture by Eclipse. For information about how to apply payments to sales order, see Applying Payments to Sales Orders in the Sales Management online help documentation. For information about authorizing sales amounts, see Authorizing Credit Card Sales Amounts on Orders or Completing Credit Card Payment Authorizations in this documentation. Canceling Transactions If you need to cancel the transaction through Eclipse, click Force Stop on the Chip & PIN Card Capture window. This action may cause Eclipse not to create a payment. Eclipse alerts the user and prompts for confirmation to stop the process. If a user needs to cancel the transaction with the TriPOS device, use the Cancel button on the TriPOS device. This cancels the transaction and avoids creating a successful transaction with the Express platform resulting in a corresponding payment in Eclipse. The Cancel button tells the TriPOS application to send a message to Eclipse that the transaction failed resulting in Eclipse closing the “wait” screen and logging a failed payment attempt. Note: Do not use the exit button in Eclipse ( ). The transaction will not quit correctly. Who to Contact About Errors If errors occur with the prompts and behavior of the TriPOS application on the device, contact the Element Customer Care staff: [email protected] or 1-866-435-3636. If the connection between Eclipse and TriPOS causes errors and payments are not getting created, or a successful “wait” screen does not display in Eclipse, contact Eclipse application support through the customer care website:: http://epicor.com/distribution/, click Customer Login at the top of the page and click Eclipse. How the System Handles Transaction Receipts In addition to data elements returned by the Element Payment platform, a typical TriPOS XML response also contains compliant receipts in an HTML format that the can use for printing. If you are using Eclipse Forms, the system replaces the normal receipt area with this transaction receipt from the TriPOS system, as in the following example: © 2016 Epicor Software Corporation. All rights reserved. 71 Using the Chip & PIN Interface Rel. 9.0.2 If you are using Eclipse Forms, the credit card verification displays within the Description field to ensure that the appropriate receipt is provided: 72 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services Reviewing triPOS Transaction Responses Use the API Activity Logs and API Activity Log Configure to log and monitor triPOS transaction responses in Eclipse. For example, you can monitory the sales and authorizations processes or PASS Transactions. Use this in addition to the PASS Reconciliation Utility to monitor transactions. To enable triPOS activity logging: 1. From the System > System Programming > API Maintenance menu, select API Activity Log Configure. 2. In the Transaction column, search for >>> 3. In the corresponding State column, select On. 4. Use the Count and Day columns to limit the number of logs you want to maintain. For more information about logging, see Configuring API Calls in System Maintenance online help documentation. To review triPOS transaction responses: 1. From the System > System Programming > API Maintenance menu, select API Activity Logs to display the API Activity Logs window. 2. Set the header fields to display the logs you want to review. 3. Review the information as needed for triPOS responses. © 2016 Epicor Software Corporation. All rights reserved. 73 Troubleshooting Credit Cards and Element Rel. 9.0.2 Troubleshooting Credit Cards and Element Use the following sections to help troubleshoot issues when processing payments using credit cards. Transaction Not Found Message If you are manually entering or swiping a card in the Element Process Transaction window in a sales order, and you click Cancel Transaction without completing the transaction, the system displays a Transaction Not Found message when you return to sales order entry. This message indicates that the system was not able to retrieve a response for the transaction from Element because you clicked Cancel Transaction, and a similar message displays in the order's change log. If you receive this message, attempt using a different card or accepting a different payment type. Duplicate Decline Message Element contains logic that checks for duplicate charges. If two charges for the same amount are made to the same card during the same batch period, the second charge is declined. You receive an error message that indicates a duplicate decline. You might also receive this message if a charge was sent to Element, and you lost internet connectivity before Eclipse received a response, and you attempt to charge the card again. Research transactions that come back with a duplicate decline message to ensure they are legitimate business transactions. If they are legitimate and you would like to charge the card, do one of the following: • Change the price for the product on the order by one cent ($.01) so the order total is different, and charge the card for the new amount. • Hold the order until the following day, or until after your batch with Element processes, and process the order again to charge the card. If Element received a transaction but Eclipse did not receive a response, Element has the information it needs to charge the card. However, because there is no indication in Eclipse that the order has been paid, you might attempt to charge the card again and receive the duplicate decline error. In this case, manually enter the payment information on the order to capture the charged payment so the order continues to process through the system. Internet Explorer 8.0 If you are experiencing problems running Internet Explorer 8.0, refer to the fixes in the Microsoft Support Knowledge base article located at http://support.microsoft.com/kb/929867, or the steps below to fix the problem on each computer that you use to enter credit card payment information. Important: If you are running Internet Explorer 8.0 on Windows 7.0 or Windows Vista, the troubleshooting steps provided below do not apply. To correct the problem, leave an Internet Explorer 8.0 browser window open while you are entering orders and accepting payments using credit cards in Eclipse. Or, set Mozilla Firefox as your default browser. Running Firefox does not require that you leave a browser window open. 1. Double-click My Computer or display your Windows Explorer. 2. From the Tools menu, select Options. 3. Click the File Types tab. 74 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services 4. Scroll down to and highlight (NONE) URL: HyperText Transfer Protocol 5. Click Advanced. 6. Highlight the open action (should be the only on you have) and click Edit. 7. Click OK to close the window. 8. Click OK again to close the next window and then click Close to close the last window. It may seem like nothing has changed by doing these steps since you did not actually change anything. However, you should now find that Internet Explorer 8 launches correctly from Eterm. If these steps do not resolve your Internet Explorer issues, you can follow all the steps in the article which double checks the information in the necessary fields. 404 Page Not Found Errors If you receive a 404 Page Note Found error when trying to enter a credit card payment on an order, your system has lost the internet connection with Element. Verify that your internet connection is still online. © 2016 Epicor Software Corporation. All rights reserved. 75 Using the PASS Reconciliation Utility Rel. 9.0.2 Using the PASS Reconciliation Utility The PASS Reconciliation utility searches Element's system to obtain all the tokens Element has on file. For performance reasons, Element provides data back to the Eclipse from a separate data source that is not accurately real-time. As of Release 8.7.2, Element updates the secondary data source four times per day, so any deletion activity performed in Eclipse recently may be caught and reported by the Reconciliation Utility with an error. For example: PASS Account number entered was linked to ABC Electrical in Element. The card does not exist in Eclipse. Could not add customer information. Element does include all tokens added in the live environment since the last refresh of the secondary source. However, Element does not remove any tokens that have been deleted. In addition, Eclipse runs a real-time double check against the live system before adding or purging any token that is not in the sync. Ultimately, the utility should have to be run rarely, but assists in finding and fixing these types of discrepancies. The reconciliation can be done to synchronize Element and Eclipse systems before running the PASS reconciliation utility itself which purges unwanted tokens before Element’s billing at month end. If you are unsure about why or how to run this utility, please contact Eclipse Customer Support. To run the PASS Reconciliation Utility: 1. From the System > Custom > Add On Products > Credit Card Authorization menu, select Element PASS Reconciliation Utility. 2. Set any options and run the report. 76 © 2016 Epicor Software Corporation. All rights reserved. Index A about 1, 2 authorizations, credit cards accepting as payment 20 about 31 authorization codes, entering 29 authorizing amounts 32 authorizations completing 33 about 31 ship via upcharges for freight 17 authorizing amounts 32 B completing 33 branches ship via upcharges for freight 17 credit card processor 13 C branch setup 13 chip and PIN chip and PIN canceling transactions 70 canceling transactions 70 downloading triPOS 59 downloading triPOS 59 errors 70 errors 70 installation 59 installation 59 logging transactions 73 logging transactions 73 overview 57 overview 57 receipts 70 receipts 70 reviewing triPOS responses 73 reviewing triPOS responses 73 running verifications 70 running verifications 70 setting up 69 setting up 69 software prerequisites 59 sofware prerequisites 59 triPOS configurations 65 triPOS configurations 65 UNIX and LINUX considerations 59 UNIX and LINUX considerations 59 Windows considerations 59 Windows considerations 59 customer Credit Card Payment Review Queue 38 default 26 credit card services deleting 26 conversion purging card numbers 56 declined charges 38 Element conversion Credit Card Summary Report 36 about 53 credit cards customer and contact 54 © 2016 Epicor Software Corporation. All rights reserved. 77 Index transactions 55 failed charges 38 authorization codes, entering 29 authorizations Level 3 data 7 about 31 PASS reconciliation 76 authorizing amounts 32 payment accounts completing 33 deleting 48 branch setup 13 viewing 48 control maintenance records 11 payment accounts (PASS accounts) converting to about 5, 47 about 53 deleting, scheduling 52 customer and contact conversion 54 payment example 35 purging credit card data 56 payment review queue 38 transaction conversions 55 qualification costs 5 credit card payment example 35 returns 43 Credit Card Payment Review Queue 38 sales 20 declined charges 38 saving cards on orders 24 default cards, customer setting up about 10 defining 26 deleting 26 authorization keys 11 failed charges 38 browser considerations 11 Level 3 data 7 control maintenance records 11 payment accounts (PASS accounts) test connection 16 about 5, 47 URL addresses 15 deleting 48 ship via upcharges 17 deleting, scheduling 52 storage costs 5 viewing 48 troubleshooting 74 qualification costs 5 voiding transactions 45 reconciling charges to your cash box 36 credit cards, reconciling charges to your cash box 36 credit cards, summary report 36 customer records credit cards 26 E returns 20, 43 saving cards on orders 24 setting up about 10 authorization keys 11 browser considerations 11 Element Payment Services about 1, 2 78 Rel. 9.0.2 test connection 16 URL addresses 15 © 2016 Epicor Software Corporation. All rights reserved. Rel. 9.0.2 Credit Card Processing with Element Payment Services ship via upcharges for credti cards 17 storage costs 5 viewing 48 payment terms summary report 36 troubleshooting 74 defining credit card parameters 26 payments voiding transactions 45 credit cards 20 L saving credit cards on orders 24 Level 3 credit card data 7 R O reports, credit card 36 orders returns credit card orders 43 sales saving credit card information on 24 P S sales tax setting up credit cards 26 PASS reconciliation 76 payment accounts (PASS accounts), credit cards ship vias freight upcharges for credit cards 17 about 47 deleting 48 U scheduling deletes 52 URL addresses, credit card setup 15 © 2016 Epicor Software Corporation. All rights reserved. 79

A Printable Version Of The Credit Card Processing With Element

Rating

Date

Size

Views

Categories

Share

Transcript

Forgot your password?.