User Documentation AssureBuy Payment Processing for Microsoft Business Solutions Great Plains Release 8.0 Last Update: September 24, 2005 Distributed By: AssureBuy 1340 Remington Road – Suite E Schaumburg, Illinois 60173 Phone: 847-843-7400 Fax: 847-843-7676 URL: www.assurebuy.
IMPORTANT NOTICE The information contained in this publication is provided as a courtesy to AssureBuy clients, partners, employees and sub-contractors. Certain information contained herein is confidential and may be considered proprietary. As a result, please obtain the written consent of AssureBuy, Inc. prior to using or reproducing any of its contents.
Contents Introduction to AssureBuy 7 Overview ................................................................................................................................... 7 Data Validation............................................................................................................ 8 Shipping Calculation ................................................................................................... 9 Tax Calculation .................................................................
Step 6.........................................................................................................................37 Step 7.........................................................................................................................37 Uninstall...................................................................................................................................37 Uninstall Warning............................................................................................
Introduction to AssureBuy Overview AssureBuy offers a reliable, scalable and secure method of outsourcing the mission critical back office payment processing infrastructure without the technical issues and historically high cost associated with an in-house developed solution. Additionally, use of the AssureBuy infrastructure affords the seller access to industry leading transaction and payment processing expertise, which can reduce overall processing costs and prevent losses from fraudulent transactions.
the request and securely sends it to AssureBuy for processing. Processing center firewall security controls access to the AssureBuy processing services. Once inside the processing center, the seller’s request is authenticated, the request is validated and the appropriate services are performed. The response is then packaged and returned to the seller’s server. The AssureBuy servers typically do not communicate directly with the buyer.
validity of all processing codes, and the relationship of the data elements contained within the request. Certain data elements are required in order to complete a transaction request and others are required based on the values contained in related elements. In all cases, the validity of the request is verified; in the event an invalid data element is located, an error response and error message are returned to the seller.
along with a seller identified tax jurisdiction and adds that amount into the total amount for the current transaction. For simple mail order type businesses, the AssureBuy payment gateway allows sellers to establish tax rates which apply only to the shipping location of the order. For all applicable seller jurisdictions, a simple tax rate is entered into a tax calculation database. Tax is applied to all taxable items for each order shipped to one of these jurisdictions.
The system accepts transactions identified as check, money order, COD, cash, ACH, purchase order, invoice, gift certificate and giveaways. The system can also be set up to automatically transfer electronic check and ACH payments to a seller’s bank for processing. Unlike many other payment processing services, AssureBuy rigorously scans all orders prior to processing and reviews all processing information returned by the processor.
specific requirements. Data containing sensitive information, such as credit card or bank account numbers, is encrypted using standard public/private key encryption technology. Although the AssureBuy payment gateway can be easily integrated into any existing environment, interfaces to existing environments and applications may be available. An interface to the Microsoft Great Plains accounting applications is currently available for Dynamics and eEnterprise customers using Release 6.0 and higher.
freed from the burden of writing complex error processing scripts to validate buyer information entered through the web browser. Systems and Technology AssureBuy houses its transaction and payment processing system in a stateof-the-art, ultra-secure Exodus data center containing the most advanced, fault-tolerant Internet technology available, including power backup, fire suppression, network redundancy and built-in disaster recovery.
The acquiring bank that provides the merchant account will act as a clearinghouse for the credit card payments. Each day, the acquiring bank transmits instructions to the issuing banks telling them to remove funds from the buyer’s credit card account and transfer the money back to the acquiring bank. Once the issuing bank has transferred the funds to the acquiring bank, the acquiring bank will then transmit the payment to the seller’s regular business bank account.
Connection: High speed frame relay In order for AssureBuy to set up the payment gateway to work with a VisaNet merchant account, the merchant account provider will need to provide the following information to AssureBuy. These details are necessary so AssureBuy and the acquiring bank will be able to identify the merchant for each transaction. Typically, the acquiring bank will fax a document containing this information once the merchant account has been set up in their system.
Nashville Platform If the seller’s merchant bank is set up to process on the Nashville platform, the seller’s bank will need to know the following information about the AssureBuy payment gateway. Product Name IntegriCharge (g/w) Product ID 819806 Vendor Name PaylinX Vendor ID 198 If the seller’s merchant account is not set up with the above specifications then the seller’s merchant account will not work with the AssureBuy payment gateway.
actual validation of the transaction data and are grouped into various levels. The watch codes identify each of the fraud filters for maintenance and for displaying the results of the fraud tests on the transaction. Each watch code that is triggered for a transaction will be displayed on the transaction record. The final piece of the fraud system is the watch action. A watch action is the seller-defined procedure that the system will follow after a transaction has triggered a watch code.
Levels of Service The AssureBuy fraud prevention system is offered in three levels of service. The basic level of service includes five common tests, checking for things such as duplicate transactions or restricted email addresses. The advanced level of service offers more sophisticated testing that checks for matching values across all the transaction data, allows for more restrictions, and does some validating of the transaction data.
Watch Codes Description VC Basic Advanced Custom Suspect Vowel Count X X VO Missing Vowels X X WD Restricted Words X X XB Too Many Orders From Same Billing Address X X XC Too Many Orders From Same Credit Card Number X X XR Too Many Orders From Same IP Range X X AU Failed Authentify™ Confirmation AV Bad Response from AVS System X DL High Risk Delivery Location X IT IP Address/Billing Country Check X X Watch Codes All watch codes have two common features.
Watch Code Filter Description FL The first name and last name fields contain the same information. This usually indicates that a customer has either typed or copied garbage information into the transaction fields. ID The domain for the specified e-mail address is invalid or cannot be identified as a valid Internet domain. NC No capital letters were entered in any of the name fields. This practice sometimes indicates that a transaction is fraudulent.
List Watch Codes List watch codes require a list of data that is compared to all incoming transaction data. If any of the transaction data contains an entry on the restricted data lists, then the transaction will fail the fraud filter and the appropriate watch codes will be applied to the transaction. Some of the watch lists, such as restricted e-mail addresses, will require the seller to input data. Other lists, such as the list of free e-mail domains, are system controlled.
Code Owner Fraud Test Description FM System The buyer's email address contains the domain of a free Web-based email provider. Free e-mail accounts are often used to place fraudulent on-line transactions. WD System One or many of the transaction fields contains a word or phrase from the restricted words watch list. Combined Watch Codes The combined watch code is similar to the list filters in how it performs the fraud tests.
XP The buyer has placed multiple transactions from the same IP address in a given period of time. Enter a buyer’s IP address to allow their transaction to process. XR XR is similar to the functionality of the XP watch code above, except that this test looks for too many transactions placed from a specified IP address range instead of a single IP address. The IP range must contain the numbers up to the class C. Enter a buyer’s IP range up to the Class C to allow their transaction to process.
letters. The seller can decide that the transactions that fail this watch code can be allowed to process. However, if a transaction were placed using a credit card on the bad credit card database, the seller would typically want this transaction to be automatically declined. The watch action on the watch code for the bad card database would then be set to decline.
Payment Gateway Overview The AssureBuy payment gateway requires certain information to complete the processing of each transaction. This required data will automatically be sent to the payment gateway by the AssureBuy Payment Processing application. The AssureBuy Payment Processing application will also receive the data that is returned from the payment gateway and complete the processing within the Great Plains software.
Great Plains Card Type AssureBuy Payment Type AssureBuy Code User-defined American Express AM User-defined Bravo Card BR User-defined Carte Blanche CB User-defined Diners Club DC User-defined Discover DI User-defined EuroCard EC User-defined JCB Card JC User-defined MasterCard MC User-defined Visa VI Transaction Types Each of the credit card transaction types available within the Great Plains software is listed below with a description of each type.
Transaction Type Description Manual Sale A manual sale or a force transaction allows a transaction to be entered after an authorization has been obtained from a voice authorization process. A voice authorization is provided when calling a processing center in response to a decline transaction where the cardholder’s bank replied with a message indicating the transaction requires a voice approval.
Transaction Result The transaction result field contains the result of the payment processing. The possible transaction results are listed below. Code Status Description Corresponding AssureBuy Code 1 Unprocessed A status of “1”, or unprocessed indicates that payment has not been processed. blank 2 Approved A status of “2”, or approved, indicates that the payment has been approved. Y 3 Declined A status of “3”, or declined, indicates that the payment has been declined.
CALL CENTER The CALL CENTER code is a decline—so the AssureBuy payment gateway treats the transaction as though it is declined; however, if a transaction receives a Call Center code, it indicates that the bank would like you to call the voice authorization center. Sometimes, the charge just needs additional verification before the card company will approve the transaction, but in most cases, the transaction will still be declined. The bank will charge sellers additional fees for a voice authorization.
RE-ENTER The RE-ENTER code indicates that the credit card transaction could not be completed. The seller should cancel the payment, as the system considers this an error and does not automatically decline the payment. Address Verification Service The Address Verification Service (AVS) is provided to a seller through the cardholder’s bank. The AVS system is owned and operated by the card processing banks.
CVV2 Response Codes The CVV2 Response codes will vary greatly depending on the card type and the credit card issuer. The table below lists the valid response codes for Visa and MasterCard as of the printing of this manual.
Installation and Setup Overview The AssureBuy Payment Processing application allows Microsoft Business Solutions users to process credit card payments in real-time or batch mode over any TCP/IP connection. The product offers a seamless integration to existing Sales Order Processing, Invoicing and Receivables Management modules and includes support for payment authorizations, sales, and returns.
Installation Before beginning the installation of the AssureBuy Payment Processing application, we highly recommend closing all windows programs currently running. Your Great Plains application should not be running, as it will cause the installation to fail. Closing any virus protection software is also suggested to avoid any conflicts with the installation.
Figure 5: Installation Step 2 Step 3 The third step of the installation involves determining the destination location of the AssureBuy Payment Processing files. These files must be installed in the same directory as the current Great Plains Dynamics/eEnterprise installation. If the installation program does not find the location of the Dynamics/eEnterprise folder on the computer, use the browse button to browse to the correct location. Once the correct folder has been selected, select the OK button.
Step 4 The fourth step is simply a verification window. Select the Next button to continue with the install or the Cancel button to cancel the installation. The Back button can be used if any of the previous installation information needs to be changed before continuing with the installation. Figure 7: Installation Step 4 Step 5 The fifth step begins the installation of the AssureBuy Payment Processing application. Press the Cancel button only if the installation needs to be halted.
Step 6 The final step is to exit the installation program by selecting the Finish button at the bottom of the window. The ReadMe file will automatically open once the installation program is closed. The ReadMe file contains instructions for setting up a test system and other important information. By deselecting the check box next to View ReadMe File, the ReadMe file will not launch.
Uninstall Warning Only attempt to uninstall this application if you are familiar with the Great Plains Dynamics/eEnterprise operating environment. Otherwise, contact your System Administrator for assistance. Instructions To uninstall the application manually, perform the following steps. 1) Locate the directory under which the Dynamics/eEnterprise application is installed. For Dynamics, this will typically be the c:\Dynamics directory. For eEnterprise, you should look for the c:\eENTRPRS directory.
Setting up AssureBuy Inside Great Plains Once a seller has established an account with AssureBuy and has received and installed the AssureBuy Payment Processing application, the seller can then set up the AssureBuy Payment Processing application inside the Great Plains software. Each company setup is allowed to have its own unique AssureBuy settings. This allows the AssureBuy application to be used in production and test mode (for training and testing) simultaneously.
Figure 13: AssureBuy Processing Setup The top two fields of the setup window are uneditable fields that identify the company within the Great Plains software. Each company within the Great Plains Dynamics/eEnterprise system can have its own setup options within the AssureBuy Payment Processing application and can use either the same or a different AssureBuy account. However, an AssureBuy account can only be linked to one merchant account.
Field Name Description User ID The User ID field contains the AssureBuyassigned 5 digit user ID for the seller. Please contact AssureBuy Support for the UserID. The correct User ID must be entered or the gateway will return an error on every transaction. Password The password field contains the user-assigned password determined during the setup process with AssureBuy. The password in this field must match the password on file with AssureBuy.
Field Name Description Mode The mode field indicates which operation mode of the payment gateway will be used. The two modes of operation are Production and Test. Production mode is used when the seller is ready to start charging customer’s credit cards. All transactions are then sent on to the cardholder’s bank. Testing mode allows the seller to test their system without sending any information to the cardholder’s bank.
The next section of fields lists the system settings for the AssureBuy/Great Plains payment processing interface. Some of these system options will affect the way certain situations are handled with the system. Field Name Description Default Address ID The Default Address ID field contains the default customer address type to be used as the BillTo address for credit card transactions.
Field Name Description Process Holds For the transaction processing, the seller must chose a sales process hold value to be used when the payment processing ends with the specified result. The values entered for these must exist in the process holds master table. Declines Choose the sales process hold that should be attached to the transaction when the transaction has been declined. This process hold should apply to Posting and, if desired, to Printing Documents.
Field Name Description Allow Save to Batch Processing By selecting this check box, the system will allow both real-time and batch processing of payment transactions. If batch processing is allowed, the user will be able to save the transaction without sending the transaction to the AssureBuy payment gateway for immediate processing.
Field Name Description Add Process Hold on Non-Approved Authorizations A credit card payment record is not added to the system for a document until after a transaction is authorized or approved. When this option is enabled, a process hold will be placed on the document when a credit card payment is attempted and does not receive an authorization or approval. When this option is not enabled, a declined transaction will allow a document to be posted with an “on account” amount.
Navigation Arrow Keys There are Arrow Keys available in the User ID Box. It is possible to set up many User ID’s. Examples of this might be the use of specific Accounts for View ‘N Pay or different Accounts based on Currency. Please note that only one Account may be used for View ‘N Pay for each Currency and a different Credit Card must be set up based on the Account. Registration Selecting the Registration Setup button will allow you to Register which products you are using.
System: User Date: 3/4/2002 3/4/2002 9:06:21 AM The World Online, Inc. ASSUREBUY PROCESSING SETTINGS REPORT Page: User ID: Company Name: The World Online, Inc. Company ID: TWO AssureBuy User ID: Gateway Version: Processing Mode: Test Result: 82001 4.2 Production Primary URL: Secondary URL: Port: Failover Duration: gateway.assurebuy.com gateway2.assurebuy.com 443 60 Default Address ID: Default IP: Close Payment Screen: CREDIT CARD 1.1.1.
Figure 15: Sales Process Holds Setup AssureBuy Credit Card Setup The Great Plains system normally allows credit card types to be set up on the Credit Card Setup window, available by selecting Credit Cards on the Company Setup palette. Because these credit card types are user-defined, the AssureBuy Payment Processing system needs a way to associate these types with credit card types that can be understood by AssureBuy.
Figure 16: AssureBuy Credit Card Setup Field Name Description Card Name The Card Name field is for credit card name as it is described in the Great Plains database. The value entered here should match one of the card types already established using the Great Plains Credit Card Setup window. The lookup icon may be used to select an existing credit card type from Great Plains.
Field Name Description Authorization Expiration The Authorization expiration designates how many days an authorization is still considered good by the bank for the specified credit card type. The standard number of days is usually 7 days but it can vary by card type. This field will be important in the cases where a credit card is authorized but the transaction is not captured until the item has shipped.
AssureBuy Functionality Introduction The AssureBuy Payment Processing module is a single-vendor solution providing both enhanced credit card processing capabilities and payment gateway services to Great Plains Dynamics/eEnterprise users. From within the Great Plains software, users are able to create credit card transactions associated with sales documents, invoice documents, or cash receipts.
Authorization An authorization transaction contacts the cardholder’s bank to verify that the cardholder has enough funds available to cover the transaction. An authorization will not transfer money from the cardholder’s account until a Capture transaction is performed. The number of days an authorization remains valid is determined by the cardholder’s bank. Capture A capture transaction is performed only on an existing approved authorization transaction.
Source Document Type A U T H C A P T U R E S A L E Sales Order Processing Quote Sales Order Processing Order z Sales Order Processing Invoice z Sales Order Processing Return Sales Order Processing Back Order Invoicing Invoice Invoicing Return Receivables Management Sales/Invoices z Receivables Management Debit Memo z Receivables Management Finance Charges z Receivables Management Service/Repairs z Receivables Management Warranty z Receivables Management Credit Memo Rece
Module Window Receivables Management Transaction Entry Cash Receipts Entry Shown below is an example of how the payment processing window can be accessed from the Sales Payment Entry window. See “AssureBuy Payment Processing ” on page 61 for more information about entering transactions.
Figure 19: Authorization Transaction Step 3 - Transaction Processing Transactions are processed either by selecting the Process button on the AssureBuy Payment Processing window, or by performing the AssureBuy Batch Transaction Processing option from either the Sales Batches or Invoice Batches window.
Figure 20: Transaction Result Step 4 - Linked Transactions A Great Plains document may have one or more associated AssureBuy transactions. Once a transaction has been processed, additional "linked" transactions may be added. For example, an Authorization transaction may be later followed by a Capture transaction. These are treated as two separate transactions by the AssureBuy Payment Processing application.
Figure 21: Adding A Capture To An Authorization Other types of "linked" transactions include linking a Refund to a previously entered Sale transaction, or linking a Void transaction to a previously entered Authorization or Sale. Declined transactions may be automatically reprocessed in a similar fashion. The following table shows the available transactions in the "Change To" field on the AssureBuy Payment Processing window after a transaction has previously been processed.
Source Document Type Transaction Type Approved A U T H Invoicing Invoice Sale No Invoicing Return Refund Yes Invoicing Return Refund No z Receivables Sales/ Invoices Sale Yes z Receivables Sales/ Invoices Sale No Receivables Debit Memo Sale Yes Receivables Debit Memo Sale No Receivables Finance Charges Sale Yes Receivables Finance Charges Sale No Receivables Service/ Repairs Sale Yes Receivables Service/Re pairs Sale No Receivables Warranty Sale Yes Rec
AssureBuy Payment Processing Window Figure 22: AssureBuy Payment Processing Window Top Row Buttons The top row buttons are the available action buttons for the payment processing screen. The buttons will be enabled or disabled according to how the seller has setup the account in the AssureBuy Processing Setup and the state of the transaction is currently displayed.
document information for the customer and below that is the transaction processing result section. Credit Card Information Figure 23: Credit Card Fields from AssureBuy Payment Processing Field Description Transaction Type The transaction type field is a dropdown list. The available transactions types for the currently displayed transaction will be listed in the dropdown menu. For more information on transaction types, please see “Transaction Types” on page 53.
Field Description Card Number The card number field displays the masked credit card number for the customer. The lookup icon to the right of the field allows the user to view the unmasked credit card number for this customer. Security Warning! The credit card number is always displayed as a masked number. The lookup icon allows access to the unmasked credit card number. To disable the ability to view the unmasked card number, simply remove the user access rights for the unmasked credit card window.
2) If the system cannot find an address for the customer that matches the default address ID, then the system will use the BillTo address attached to the current document. 3) If the system cannot find a default address or the BillTo address for the document, then the system will take the address directly from the current document. 4) If all of the above three fail, then the system will display the fields as blank.
Field Description IP Address The IP address field is available to enter the customer’s IP address if the information is available. If not, the system will use default IP address from the AssureBuy Processing Setup. Great Plains Document Information The Great Plains document information is not editable by the user. These fields are copied from the originating document and are for informational purposes only.
Figure 26: Transaction Fields from AssureBuy Payment Processing Field Description Bypass Processing The Bypass Processing checkbox allows the user to override the AssureBuy transaction processing and enter the processing results manually. This feature is only available if the “Allow Manual Entry of Approval Information” option is enabled on the AssureBuy Processing Setup window.
Field Description AVS Response The AVS response field displays the Address Verification Service’s response. Only credit card transactions will have an AVS response. For more information, please see “Address Verification Service” on page 30. CVV Response If the CVV2 number is sent with the credit card information then the response from the bank will be display in this field.
Sales Order Processing This section describes how the AssureBuy Payment Processing application integrates with the Great Plains Sales Order Processing module. There are four windows on which the AssureBuy functionality has been added: Sales Transaction Entry, Sales Payment Entry, Sales Batches, and Order Fulfillment. The Print Sales Documents functionality may also be affected by the process holds added for AssureBuy transactions.
automatically be applied to the document. For more information, please see “AssureBuy Payment Processing Window” on page 61. Transfer Button When transferring documents and payments from one type to another, all AssureBuy transactions attached to the originating document will be automatically reassigned to the new document number. If the entire document is being transferred, be sure to check the box next to Include Totals and Deposits so that the payments are transferred with the document.
Allocate or Fulfill Menu Option When the Allocate or Fulfill menu option is chosen from the Options menu, a window will display allowing a choice between selecting allocate, fulfill or both. Once the options are selected and the OK button is selected, the AssureBuy Payment Processing application will review any credit card transactions and determine whether or not the document can be fulfilled. The allocate option is not affected by the AssureBuy application.
Warning”. This warning will allow the fulfillment process to continue if the Yes button is selected and will abort the process if the No button is selected. The “Transaction Amount Warning” option can also affect the fulfillment process without the “Authorization Required Before Order Fulfillment” option being enabled.
Figure 29: Sales Payment Entry Window As with the Sales Transaction Entry window, the Extras menu option is an alternative way of launching the AssureBuy Payment Processing window. Again, the payment processing window will open with the default customer and transaction information filled in and ready for a new transaction to be entered. When entering a credit card transaction, you will notice that the Insert button is disabled.
failed. Continue?” By selecting No on the warning message, the payment removal process will be aborted. By selecting Yes on the warning message, the payment removal process will continue without reversing the authorization. Authorizations are reversed so that the credit originally set aside by the authorization will be released back to the customer. Most banks will expire authorizations after a pre-determined length of time. Reversals are considered a courtesy to the customer.
Figure 30: Sales Batch Entry AssureBuy Transactions By selecting the AssureBuy Transactions menu option, the AssureBuy Payment Processing window will launch and display all the credit card transactions attached to all documents in the currently selected batch. The transactions can be reviewed one at a time by using the record selectors located at the bottom left-hand side of the window.
batch transaction processing will check the setting called “Fulfillment Required Before Capturing Transactions" on the AssureBuy Processing Setup window. If this function has been enabled, then the transaction will only be processed if the document has been fulfilled. A pending capture transaction will be processed only after the companion authorization transaction has been approved and checked to verify that the authorization has not expired.
AssureBuy Batch Processing Report System: User Date: 3/4/2002 3/4/2002 9:06:21 AM The World Online, Inc. ASSUREBUY BATCH PROCESSING REPORT Sales Order Processing Page: User ID: 1 Lessonuser1 Batch ID: SALES01/2002 Batch Comment: Approved: Approved By: Approval Date: Batch Transactions Attempted: Batch Transactions Approved: Batch Transactions Declined/Pending: 0/0/0000 7 4 3 Batch Sales Total: Batch Credit Total: Net Batch Total: $397.67 $27.40 $370.
Report Field Description Document Number The document number field displays the document number associated with the current document. Doc Date The doc date or document date field displays the date the document was created. Customer ID The customer ID field displays the customer ID associated with the current document. Name The name field displays the customer’s name from the current document.
Report Field Description Summary of Sales Transactions The summary of sales transaction section displays a summary of all credit card transaction that are approved sales. Transfer Button When transferring batch documents and payments from one type to another, all AssureBuy transactions attached to the originating document will be automatically reassigned to the new document number. Be sure to check the box next to Include Totals and Deposits so that the payments are transferred with the document.
Allocate or Fulfill Menu Option When the Allocate or Fulfill menu option is chosen from the Options menu, a window will display allowing a choice between selecting allocate, fulfill or both. Once the options are selected and the OK button is selected, the AssureBuy Payment Processing application will review the credit card transactions for each document in the batch and determine whether or not the document can be fulfilled. The allocate option is not affected by the AssureBuy application.
The “Transaction Amount Warning” option can also affect the fulfillment process without the “Authorization Required Before Order Fulfillment” option being enabled. The system would, after verifying that credit card transactions are present on the document, verify whether the document has any remaining balance “on account” and then display the same warning message, allowing the fulfillment process to continue or be canceled.
declined or processed with an error. Posting the sales document to the general ledger with a status other than approved would result in a document being posted without a full payment. In addition, a pending transaction processed after the document has been posted would not be applied to the sales document. The customer would have been charged but the payment will not have been applied. The AssureBuy application will automatically remove the process hold when an approved payment has been completed.
Figure 34: Transaction Entry Window In addition to entering data in the credit card amount field or selecting the credit card details icon, the Extras menu offers an alternative way of launching the AssureBuy Payment Processing window. Figure 35: Transaction Entry Window If the current document does not have any transactions attached, the system will display a message: “No transactions available for this document.
the user will be returned to the Transaction Entry window. If the document already has transactions attached, the AssureBuy Payment Processing window will launch and will display any attached credit card transactions that already exist for the current document. These transactions can be reviewed by using the arrows in the lower left hand corner of the window.
Figure 36: Cash Receipts Entry Window As with the Transaction Entry window, the Extras menu option is an alternative way of launching the AssureBuy Payment Processing window. Again, the payment processing window will open with the default customer and transaction information filled in and ready for a new transaction to be entered. If the current cash receipt does not have any transactions attached, the system will display a message: “No transactions available for this document.
Posted Transactions On the Posted Transactions window, the user is allowed to void an existing payment that has already been posted. When the AssureBuy Payment Processing application is installed, this functionality is enhanced to ensure that payments with approved credit card transactions are not voided without issuing an appropriate refund.
When the Receivables Batch Entry window is open, an Extras menu will appear with two AssureBuy menu functions: AssureBuy Transactions and Process AssureBuy Batch Transactions. Figure 38: Receivables Batch Entry Window AssureBuy Transactions By selecting the AssureBuy Transactions menu option, the AssureBuy Payment Processing window will launch and display all the credit card transactions attached to all documents in the currently selected batch.
A transaction has failed to receive an approval from the bank. Contact the customer to let them know the credit card was declined. A transaction was sent for processing but received an error from the AssureBuy payment gateway. Review the “AssureBuy Gateway Errors” on page 101 or contact AssureBuy Support. For Contact information, please see “How To Obtain Technical Support” on page 99. AssureBuy Batch Processing Report System: User Date: 3/4/2002 3/4/2002 9:06:21 AM The World Online, Inc.
Report Field Description Batch Summary Fields A group of fields that summarize how many transactions were attempted and the results of those transactions including the batch dollar totals. Type This field displays the document type for Receivable Management. 7 = Payment Document Number The document number field displays the document number associated with the current document. Doc Date The doc date or document date field displays the date the document was created.
Report Field Description Number The number field displays a transaction reference number assigned by the AssureBuy payment gateway. Summary of Sales Transactions The summary of sales transaction section displays a summary of all credit card transaction that are approved sales. Delete Button When using the AssureBuy Payment Processing application, an automatic verification is performed to make sure that documents in the receivables batch are not deleted with approved credit card transactions attached.
Figure 40: Invoice Entry Window The AssureBuy Payment Processing window will launch and display all the transactions attached to the selected invoice document. If there are no transactions attached to the current document, then a message will be displayed and a new transaction can be entered. Once the AssureBuy Payment Processing window is displayed, the payment information can be entered and processed. When transactions are approved, the payment will automatically be applied to the document.
Invoice Holds Warning: The AssureBuy system will remove any hold previously attached to a document when a credit card transaction is processed. An invoice hold applied while to an invoice document will be affected by the AssureBuy application when credit card transactions have been added to the document. Before processing a transaction, the AssureBuy application will remove any existing invoice holds. Depending on the result, a hold may be reapplied after the credit card processing has been completed.
Invoice Payment Entry Normally, credit card payments for invoice documents are entered directly on the Invoice Payment Entry window. When the AssureBuy Payment Processing application is installed, this functionality is disabled and replaced by the AssureBuy Payment Processing window. Accessing The AssureBuy Payment Processing Window The Invoice Payment Entry window allows check, cash and credit card transactions.
payments are attached to the document. Depending on the type of credit card transactions found, the AssureBuy Payment Processing application may prevent the payment from being removed until a credit card transaction has been removed or reversed. The following items outline the verifications performed by AssureBuy. 1) If any unprocessed credit card transactions are found, then the application will automatically void the transaction and allow the payment to be removed normally.
Figure 43: Invoice Batch AssureBuy Transactions By selecting the AssureBuy Transactions menu option, the AssureBuy Payment Processing window will launch and display all the credit card transactions attached to all documents in the currently selected batch. The transactions can be reviewed one at a time by using the record selectors located at the bottom left-hand side of the window.
include anything from a transaction failing to get approval from the bank to an error accessing the credit card network. Possible Errors Solutions A transaction has failed to receive an approval from the bank. Contact the customer to let them know the credit card was declined. A transaction was sent for processing but received an error from the AssureBuy payment gateway. Review the “AssureBuy Gateway Errors” on page 101 or contact AssureBuy Support.
Report Field Description Batch Comment The Batch Comment field displays any notes that have been added to the current batch. Batch Summary Fields A group of fields that summarize how many transactions were attempted and the results of those transactions including the batch dollar totals. Type The field displays document type for the current invoice. 1 = Sale 2 = Return Document Number The document number field displays the document number associated with the current document.
Report Field Description Status The status field displays the status of the credit card transaction. For a complete list of all possible status codes, please see “Transaction Result” on page 28. Approval Code The approval code field displays the approval code received from the customer’s bank at the time of processing. Number The number field displays a transaction reference number assigned by the AssureBuy payment gateway.
Technical Support How To Obtain Technical Support AssureBuy maintains a staff of qualified support personnel to assist when you encounter problems while using the payment processing gateway. These support personnel will be able to assist with problems from both the Great Plains Dynamics/eEnterprise AssureBuy payment processing module and from the AssureBuy payment gateway. AssureBuy Support can be contacted as follows; By E-mail support@assurebuy.
Figure 45: About AssureBuy Window In order to provide you with the best possible service for your installation, the AssureBuy support staff will need to know the entire six-digit version number displayed on the About AssureBuy window.
Appendix AssureBuy Gateway Errors Error Code 0174 0175 0181 0187 5101 5102 5110 5111 5112 5113 5114 5118 5120 5121 5131 5132 5133 5141 5142 5145 5146 5201 5202 5203 5204 5205 5206 5207 5208 5209 5210 5211 5212 5213 5214 Description System currently unavailable. Internal communications error. Internal gateway error. System timeout, try again. Missing or invalid HTTP Content-type. No HTTP post data received. Unable to parse XML input data. Missing or invalid User ID. Missing or invalid Password.
Error Code 5301 5302 5303 5304 5305 5306 5307 5308 5309 5310 5311 5312 5313 5320 5321 5322 5323 5401 5402 5403 5404 5405 5406 5407 5408 5409 5410 5411 5412 5413 5420 5421 5422 5423 5450 5451 5452 5453 5454 5455 5456 5457 5458 5459 5501 5502 5503 5504 5505 5506 5551 5601 Description Missing or invalid BillTo first name. Missing or invalid BillTo middle name. Missing or invalid BillTo last name. Missing or invalid BillTo name prefix. Missing or invalid BillTo company name.
Error Code 5602 5603 5604 5605 5606 5607 5608 5609 5610 5611 5612 5613 5614 5615 5616 5617 5618 5619 5620 5621 5701 5702 5703 5704 5705 5706 5707 5708 5709 5710 5711 5712 5713 5751 5801 5802 5803 5804 9999 Description Missing or invalid payment type. Missing or invalid payment card type. Missing or invalid payment number. Missing or invalid payment verification number. Missing or invalid payment PIN. Missing or invalid card present indicator. Missing or invalid customer present indicator.
Midway Island, Samoa Subtract 11:00 hours from GMT Hawaii Subtract 10:00 hours from GMT Alaska Subtract 9:00 hours from GMT Pacific Time Subtract 8:00 hours from GMT Mountain Time Subtract 7:00 hours from GMT Central Time Subtract 6:00 hours from GMT Eastern Time Subtract 5:00 hours from GMT Atlantic Time Subtract 4:00 hours from GMT Newfoundland Subtract 3:30 hours from GMT Brasilia & Buenos Aires, Georgetown Subtract 3:00 hours from GMT Mid-Atlantic Subtract 2:00 hours from GMT Azore
ISO 3166 Standard Country Codes The following is a list of International Standards Organization (ISO) country codes in use by AssureBuy: Country Code AFGHANISTAN AF ALBANIA AL ALGERIA DZ AMERICAN SAMOA AS ANDORRA AD ANGOLA AO ANGUILLA AI ANARCTICA AQ ANTIGUA AND BARBUDA AG ARGENTINA AR ARMENIA AM ARUBA AW AUSTRALIA AU AUSTRIA AT AZERBAIJAN AZ BAHAMAS BS BAHRAIN BH BANGLADESH BD BARBADOS BB BELARUS BY BELGIUM BE BELIZE BZ BENIN BJ BERMUDA BM BHUTAN BT BOLIV
Country Code BULGARIA BG BURKINA FASO BF BURUNDI BI CAMBODIA KH CAMEROON CM CANADA CA CAPE VERDE CV CAYMAN ISLANDS KY CENTRAL AFRICAN REPUBLIC CF CHAD TD CHILE CL CHINA CN CHRISTMAS ISLAND CX COCOS (KEELING) ISLANDS CC COLOMBIA CO COMOROS KM CONGO CG CONGO, THE DEMOCRATIC REPUBLIC OF THE/ZAIRE CD COOK ISLANDS CK COSTA RICA CR COTE D’VOIRE CI CROATIA HR CUBA CU CYPRUS CY CZECH REPUBLIC CZ DENMARK DK DJIBOUTI DJ DOMINICA DM DOMINICAN REPUBLIC DO EAST
Country Code ERITREA ER ESTONIA EE ETHIOPIA ET FALKLAND ISLANDS (MALVINAS) FK FAROE ISLANDS FO FIJI FJ FINLAND FI FRANCE FR FRENCH GUIANA GF FRENCH POLYNESIA PF FRENCH SOUTHERN TERRITORIES TF GABON GA GAMBIA GM GEORGIA GE GERMANY DE GHANA GH GIBRALTAR GI GREECE GR GREENLAND GL GRENADA GD GUADELOUPE GP GUAM GU GUATEMALA GT GUINEA GN GUINEA-BISSAU GW GUYANA GY HAITI HT HEARD ISLAND AND MCDONALD ISLANDS HM HOLY SEE (VATICAN CITY STATE) VA HONDURAS HN
Country Code IRAN, ISLAMIC REPUBLIC OF IR IRAQ IQ IRELAND IE ISREAL IL ITALY IT JAMAICA JM JAPAN JP JORDAN JO KAZAKSTAN KZ KENYA KE KIRBIBATI KI KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF KP KOREA, REPUBLIC OF KR KUWAIT KW KYRGYZSTAN KG LAO PEOPLE’S DEMOCRATIC REPUBLIC LA LATVIA LV LEBANON LB LESOTHO LS LIBERIA LR LIBYAN ARAB JAMAHIRIYA LY LIECHTENSTEIN LI LITHUANIA LT LUXEMBOURG LU MACAU MO MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF MK MADAGASCAR MG MALAW
Country Code MAURITANIA MR MAURITIUS MU MAYOTTE YT MEXICO MX MICRONESIA, FEDERATED STATES OF FM MOLDOVA, REPUBLIC OF MD MONACO MC MONGOLIA MN MONTSERRAT MS MOROCCO MA MOZAMBIQUE MZ MYANMAR MM NAMIBIA NA NAURU NR NEPAL NP NETHERLANDS NL NETHERLANDS ANTILLES AN NEW CALEDONIA NC NEW ZEALAND NZ NICARAGUA NI NIGER NE NIGERIA NG NIUE NU NORFOLK ISLAND NF NORTHERN MARIANA ISLANDS MP NORWAY NO OMAN OM PAKISTAN PK PALAU PW PALESTINIAN TERRITORY, OCCUPIED P
Country Code PITCAIRN PN POLAND PL PORTUGAL PT PUERTO RICO PR QATAR QA REUNION RE ROMANIA RO RUSSIAN FEDERATION RU RWANDA RW SAINT HELENA SH SAINT KITTS AND NEVIS KN SAINT LUCIA LC SAINT PIERRE AND MIQUELON PM SAINT VINCENT AND THE GRENADINES VC SAMOA WS SAN MARINO SM SAO TOME PRINCIPE ST SAUDI ARABIA SA SENEGAL SN SEYCHELLES SC SIERRA LEONE SL SINGAPORE SG SLOVAKIA SK SLOVENIA SI SOLOMON ISLANDS SB SOMALIA SO SOUTH AFRICA ZA SOUTH GEORGIA /SOUTH SANDW
Country Code SWITZERLAND CH SYRIAN ARAB REPUBLIC SY TAIWAN TW TAJIKISTAN TJ TANZANIA TZ THAILAND TH TOGO TG TOKELAU TK TONGA TO TRINIDAD AND TOBAGO TT TUNISIA TN TURKEY TR TURKMENISTAN TM TURKS AND CAICOS ISLANDS TC TUVALU TV UGANDA UG UKRAINE UA UNITED ARAB EMIRATES AE UNITED KINGDOM GB UNITED STATES US UNITED STATES MINOR OUTLYING ISLANDS UM URUGUAY UY UZBEKISTAN UZ VANUATU VU VENEZUELA VE VIET NAM VN VIRGIN ISLANDS, BRITISH VG VIRGIN ISLANDS, U.S.
VisaNet(Vital) – IP Frame AssureBuy Gateway Settings All terminals need to be setup to accept PaylinX software. AssureBuy is currently running PaylinX version 3.1.9 with a frame relay connection to the Vital credit card network.
Card Types Accepted Please check the card types that are available. Some card types may require an additional merchant account. Please consult the merchant account provider for additional details.
FDMS South AssureBuy Gateway Settings All terminals need to be setup to accept PaylinX software. AssureBuy is currently running PaylinX version 3.1.9 with a frame connection to the FDMS South credit card network. AssureBuy will also need a Contact name and number at the seller’s merchant account bank.
FDMS Nashville (FDC) AssureBuy Gateway Settings All terminals need to be setup to accept PaylinX software. AssureBuy is currently running PaylinX version 3.1.9 with a frame connection to the FDMS Nashville credit card network.
Glossary of Terms ACH ACH (Automated Clearinghouse) is a service used by banks that allows the banks to exchange electronic payments. Acquirer The acquirer receives all credit card or bankcard transactions from the merchant and sends the data to the issuing banks. The acquirer is a licensed member of the MasterCard and/or Visa association. Acquiring Bank The acquiring bank, also known as the merchant bank, allows merchants to accept credit cards by issuing them a merchant account.
Authorization An authorization is given to the merchant by the cardholders’ bank at the time of the sale. The cardholder’s bank, or issuing bank, verifies that the cardholder has adequate funds available on their account and issues the merchant an authorization code. The cardholder’s available credit will then be reduced by the amount of the sale. Bankcard Bankcard is a financial transition card whether it is a credit card or a debit card that has been issued by a financial institution.
cardholder The cardholder is the person to whom the financial institution has issued the credit card or debit card. A cardholder can also be a person authorized to use the credit card or debit card. case sensitive If the user enters a word for the password without capitalizing any letters, then the system will expect the password to always be entered without any letters capitalized.
encryption Encryption is the process of converting readable data into unreadable data. Only the computer that has the key to the encryption can convert the unreadable data back to readable data. expiration date The expiration date is the date the credit card or debit card becomes invalid. floor limit The floor limit is set by the acquiring bank on the seller’s merchant account. The floor limit is the dollar volume the seller is allowed to process on their merchant account per month.
secure site, all information being sent and received by the computer will be encrypted. IntegriCharge® AssureBuy's IntegriCharge® is an outsourced solution for Internet transaction and payment processing, fulfillment, reporting and customer relationship management. Internet A computer and communications network that allows all the computers in the world talk to each other. invoice An invoice is a bill submitted to the buyer by the seller for payment of services rendered.
navigation Navigation is the processes of moving from web page through the use of a web browser. order system The order system is the part of the Web store right after the customer clicks the buy button. The order system includes the order page as well as all the programming functionality that accepts and processes a buyer's order for payment. Payment Gateway A payment gateway provides the interconnection between two networks with different communication protocols.
recurring orders A recurring order is an order that will be automatically resubmitted for payment after a specific period of time. Orders can recur daily, weekly, monthly, quarterly, or yearly. Refund A refund, or credit, is a transaction that returns money to a credit card customer. For credit card transactions, a refund is an additional transaction that prompts the bank to release the cardholder’s money back to the credit card account.
the data to be encoded and decoded by only the users and the server. This process of encoding and decoding the data prevents any other computers or users from viewing the data being exchanged. swipe terminal A swipe terminal is a small machine with a modem that can dial into the credit card network for authorizations. The machine can read the magnetic stripe on the back of credit card. Most machines also have a number pad on the front of the machine where the credit card number can be entered manually.
Index Attaching Transactions to Great Plains Documents 24, 52 Authorization 9, 24–28, 42, 46, 49, 51–52, 54–57, 64, 67–70, 69, 73, 76–78, 110 Authorization Errors 26 Authorization Expiration 49 Authorization Required Before Order Fulfillment 44, 68–69, 77–78 Auto Cancel 26 Automatically Capture Transactions During Batch Post 43 AVS 17, 21, 28, 42, 62, 65 B A About 12–14, 41, 45, 54, 97–98 Accessing The AssureBuy Payment Processing Window 66, 69, 79, 81, 87, 90 acquiring bank 11–12, 14 Action 14–15, 17, 21
CVV2 8, 27–29, 61, 65 CVV2 Response 29, 65 D Data Collection 10 Data Required 23 Data Returned 23, 25 Data Validation 6 database 7–8, 17, 22, 27, 31, 48, 59 Declined 15, 22, 26–27, 41, 44, 46, 57, 64–65, 73, 79, 84, 92 Declines 26–27, 41 Default Address ID 41, 61–62 Default IP 41, 63 Delete 49, 59, 67, 70, 76, 81–82, 87–88, 90, 95 Discover 8, 12–13, 24, 111–13 Doc Date 75, 86, 94 Document No 63 document number 63, 65–67, 74–76, 85–86, 93–94 document type 24, 52–53, 57, 63, 66, 74, 86, 94 Dynamics/eEnterpri
Posted Transactions 83 Primary URL 40 Proc Date 75, 86, 94 Process 8, 9, 10, 11–15, 20–22, 25, 26, 31, 32, 39, 42– 44, 46–48, 52, 54, 59, 64–68, 71–72, 75, 76–78, 81–84, 86–87, 88, 91–92, 94–95 Process AssureBuy Batch Transactions 71–72, 84, 91– 92 Process Date 64 Process Holds 42, 46, 66, 69, 78 Process Holds Warning 78 R Receivables 31, 43–44, 53–54, 58, 79, 83–87 receivables batch 83–87 Record Notes Icon 49 record selectors 49, 65, 72, 84, 92 Reference 65, 75, 87, 95 refund 24–25, 28, 52–53, 57–58, 67,