1 QMerchantManual

September14,2017

QMerchantManual

Version13.0

Thisdocumentreflectsversion13.0.0ofQMerchant.Someofthescreenshotsarejustexamplesandmaydifferfromtherealproduct.QBAutomationisatrademarkandservicemarkofRHAV.addQinisatrademarkandservicemarkofRHAV.QuickBooksisaregisteredtrademarkandservicemarkofIntuitInc.intheUnitedStatesandothercountriesAuthorize.NetisaregisteredtrademarkofLightbridge,Inc.Allothermarksarethepropertyoftheirrespectiveowners.Copyright©2002–2018byRHAVAllrightsreserved.

2 QMerchantManual

September14,2017

TableofContents

INSTALLATION........................................................................................................................4 PREPARATIONFORUSEWITHQUICKBOOKS(DESKTOPVERSIONS)...................................................9 SETUPFORUSEWITHQUICKBOOKS(DESKTOPVERSIONS)............................................................10 SETUPFORUSEWITHQUICKBOOKSPOINT-OF-SALE...................................................................11 STARTUSINGQMERCHANT....................................................................................................13 SETTINGS............................................................................................................................14 KEYBOARDSHORTCUTS..........................................................................................................18 MULTIPLEMERCHANTACCOUNTS...........................................................................................20 USEQMERCHANTASVIRTUALTERMINALWITHOUTQUICKBOOKS.............................................21 USEQMERCHANTWITHQUICKBOOKSPRO,PREMIERE,ENTERPRISE............................................23 WORKINGWITHSALESRECEIPTS.............................................................................................24 USEOFCHECKS....................................................................................................................28 WORKINGWITHINVOICES/RECEIVEPAYMENTS........................................................................29 WORKINGWITHSALESORDERS...............................................................................................31 WORKINGWITHCREDITMEMO..............................................................................................32 RECURRINGBILLING..............................................................................................................33 BATCHPROCESSING(‘UNATTENDEDMODE’)............................................................................36 BEHAVIOROFTHEGETPAYMENTBUTTON................................................................................37 USEQMERCHANTWITHQUICKBOOKS–POINTOFSALE.............................................................39 VOIDS,CREDITSANDREFUNDS...............................................................................................43 QUICKMODE.......................................................................................................................44 SERVERINSTALLATIONANDMANAGEMENT...............................................................................45 LEVELIIDATA......................................................................................................................46 LEVELIIIDATA.....................................................................................................................47 CIM(AUTHORIZE.NETCUSTOMERINFORMATIONMANAGEMENT)........................................48 USEOFMAGNETICSTRIPEREADERS........................................................................................50 QMERCHANTMENUENTRIES.................................................................................................51 THELOGFILE.......................................................................................................................53 TRANSACTIONTYPESANDOTHERCODES...................................................................................54 PRINTRECEIPT.....................................................................................................................55 CHANGETHEPRINTRECEIPT....................................................................................................55 BARCODEPRINTING..............................................................................................................57 RECEIPTFORMATTINGPARAMETERSANDCOMMANDS................................................................57 RE-PRINTARECEIPT..............................................................................................................58 CUSTOMSETTINGS................................................................................................................59 REPORTS.............................................................................................................................64 ACTIVATION.........................................................................................................................65 PAYMENTGATEWAYS............................................................................................................66 AUTHORIZE.NETAPILOGINIDANDTRANSACTIONKEY..............................................................67 TIPS....................................................................................................................................68 TESTYOURCONNECTIONTOTHEPAYMENTPROVIDER:................................................................68

3 QMerchantManual

September14,2017

GETTHEQMERCHANTVERSIONANDSERIALNUMBER.................................................................68 TROUBLESHOOT...................................................................................................................69 Prerequisites....................................................................................................................69 HowdoIgetthetransactionkeyfromAuthorize.Net?...................................................69 IseethefollowingmessagefromAuthorize.Net.............................................................69 SupportedPaymentGateways:........................................................................................69 HowcanIseetheauthorizationandtransactionidofasalesreceipt?...........................69 CannotgetthecreditcardnumberfromQuickBooks.....................................................70 QuickBooksDesktopVersionsi.e.EnterpriseandWindows7.........................................70 HowcanIdisabletheintegratedQuickBooksmerchantservice?...................................70 Errormessage‘Markettypeisinvalid..............................................................................71 IwanttochangetheQuickBooksversionIselectedduringinstallation..........................71 APPENDIXA:SCREENSHOTSFORTHEUSEWITHQUICKBOOKSPOINT-OF-SALE(OLDERVERSIONS)......72 APPENDIXB:AUTHORIZE.NETRESPONSECODES(EXCERPTFROMAUTHORIZE.NETDOCUMENTATION)75

4 QMerchantManual

September14,2017

INSTALLATIONAfterdownload,pleaserunthedownloadedexecutable.

Step1:Thefollowingdialogappears.

Step2:Click’Next’tocontinue.

TheRHAVlicenseagreementisdisplayed.Youmustacceptthelicense,otherwiseyoucannotuseQMerchant.

5 QMerchantManual

September14,2017

Step3:Confirmtheinstallationfolder.Werecommendleavingitasitisandclick‘Install’tocompletetheinstallation.

6 QMerchantManual

September14,2017

Step4:FinishtheinstallationandlaunchQMerchant.

Step5:Usethesetupwizard.

Thesetupisatwo-stepprocess.FirstwesetupyourQuickBooksconnectionandthenweestablishtheconnectiontotheselectedpaymentprovider.

PleaseselectyourQuickBooksversionandclickcontinue.QMerchanttriestoconnecttoQuickBooks. If this is thefirsttimeyouinstallQMerchant,somedialogswillappear(asdescribedinthefollowingchapter).Pleaserespondtothosedialogs.

Aftertheconnectionissuccessful,thenpleaseselectyourpaymentgateway.Thefollowingselectionsarecurrentlyavailable:

Authorize.net YouneedtheAPILoginIDandthetransactionkey.Yougetbothfromtheauthorize.net

merchantwebsiteundersecuritysettings.

PPI YouneedanAccountToken.PleaseaskPPIPaymoverforit.Other

Youaregoingtouseoneoftheothersupportedpaymentgateways.Pleasefollowthein-structionsandsetitupviatheQMerchantsettingsdialog.

Iwillsetupthepaymentproviderlater

PleasedefinethepaymentgatewayviatheQMerchantsettingsdialog

Nowenterthecredentialsyourpaymentprovidergaveyou.

7 QMerchantManual

September14,2017

BelowisascreenshotofasuccessfulsetupforaQuickBooksdesktoporserverversionandauthorize.net.

HereisascreenshotofasuccessfulsetupforaQuickBooksPoint-of-SaleandPPI.

Ifweareable toestablish the connection to yourpaymentprovider, youare ready touseQMerchant.Press the‘ReadytouseQMerchant’buttontoclosethewizard.Pleasereviewyoursettings,connecttoQuickBooksandstartwithQMerchant.

8 QMerchantManual

September14,2017

Ifyourpaymentproviderisnotlisted,pleaseselectOTHER.FromtheQMerchantdashboardclickSettings

Andenterthepaymentproviderinformation.

After installationyousee the following icon atyourdesktop.Also there isanentry inyourProgramsMenunamedQMerchant.Toruntheapplication,double-clickthaticon.

IfyouchoosetouninstallQMerchant,youcandothiseitherfromtheprogrammenuorviatheControlPanel-Unin-stallPrograms.

9 QMerchantManual

September14,2017

PREPARATIONFORUSEWITHQUICKBOOKS(DESKTOPVERSIONS)OpenyourQuickBooksapplication.TheninvokefromthemenuEdit|Preferences.ChooseIntegratedApplicationsandtheCompanyPreferencestab.

Makesurethatthe"Don'tallowanyapplicationtoaccessthiscompanyfile"isun-checked.

10 QMerchantManual

September14,2017

SETUPFORUSEWITHQUICKBOOKS(DESKTOPVERSIONS)OpenQuickBooks.Youwillbeaskedtoauthorizeourapplication(This isaone-timeprocess).QMerchantrequestsac-cesstoQuickBooks.ThefollowingQuickBooksmessage-orsimilarforQuickBooksPointofSale-appears:

Pleasecontinueas indicatedwith 'Yes,wheneverthisQuickBookscompanyfile isopen'anddon't forgettocheckthe'Allow....'checkbox.Thisisnecessary,becausewewillaccess/modifythecustomercreditcardinformation.Aconfir-mationdialogwillappear

Confirmwith'Done'andthenextdialogwithYes.

11 QMerchantManual

September14,2017

SETUPFORUSEWITHQUICKBOOKSPOINT-OF-SALEPlease loginasSysAdminandmakesure thatQuickBooksPoint-of-Sale is innetworkmode.Youcanget thisdialog inPOS from the Filemenu and then CompanyOperations (older versions) or ‘Switch company file tomultiusermode’.QMerchantactslikeanadditionalworkstationtoPOS

WhenQMerchanttriestoaccessQuickBooksPoint-of-SaleforthefirsttimeduringthesetupdialogorwhenyouconnecttoQuickBooks,youseethefollowingdialogsequence:

QMerchantlooksforavailablePoint-of-Saleserverstoconnectto.

Afteraserverisfoundorselected,youmustgiveQMerchantthepermissiontoaccessPOS.Pleasechoose‘Yes,Always’.

12 QMerchantManual

September14,2017

ThenafterashortperiodoftimetheQMerchantdashboardshowsthatitisconnectedtoQuickBooksandyoucanstarttoprocesspayment.

Pleasecontinuewiththesection‘UseQMerchantwithQuickBooksPoint-of-Sale’.

13 QMerchantManual

September14,2017

STARTUSINGQMERCHANTFromtheDashboardpresstheyellowbutton‘ConnecttoQuickBooks’.

Bydoingthat,aconnectiontoQuickBooksisestablished.

TheDashboardthenlookslikethis:

14 QMerchantManual

September14,2017

SETTINGSOpentheSettingsdialog(theboxinthelowerleft).

Thepictureaboveshowsanexampleforauthorize.netsettings.Pleasereadtheexplanationsbelow.

IfyouworkwithQuickBooksPoint-of-Sale,theQuickBooksSettings(rightside)arenotvisiblebecausethatisdoneau-tomatically.

Therearesomespecialsettingsavailableviathemenuentry‘Special’

1.Itemized:Ifcheckednotonlythetotalsbutalsothesingleitemsaresendtothepaymentprovider.Thisoptionisnotavailableforallpaymentproviders.

2.DebugMode:Indebugmode,allmessagetoandfromQuickBooksarerecordedinalogfile.Werecommendtousethisonlyonadvicebyoursupportteam.

3.MultipleMerchantAccounts:Enablestheusageofseveraldifferentmerchantaccountswiththesameofwithdiffer-entpaymentproviders.

4.AllowBatchProcessing:Enablestheprocessofaseriesofpaymentsinunattendedmode(authorize.netonly).

5.Level3:Level3transactionmode(PayTraceonly).

15 QMerchantManual

September14,2017

Thefieldshavethefollowingmeaning:

ProviderInformation

PaymentGatewayProvider

Selectoneoftheimplementedpaymentproviders.Youmusthaveacontractwiththem.Theyprovideyouwiththecredentialsneces-sary.

Authorize.NetSettings(youmustobtainthisinformationfromAuthorize.Net)

APILoginID Authorize.NetLoginIDorAPILoginID

TransactionKey TransactionkeyfromAuthorize.Net

CARDPRESENTCheckifyouhavea‘CardPresent’accountwithAuthorize.Net.BydefaultitissettoaCardNOTPresentaccount

ServerAddress

AddressoftheAuthorize.Netserver.https://secure.authorize.net/gateway/transact.dllForcardpresentaccounts:https://cardpresent.authorize.net/gateway/transact.dll

TestModeTransactionwillsendbesendtoAuthorize.Net intestmodeonly.Thecreditcardwillnotbeprocessed,butyouwillreceiveaproperresponse.(ThetrialapplicationisalwayssettoTestmode).

PayTraceSettings(youmustobtainthisinformationfromPayTrace)

UserName PayTraceUserName

PasswordPayTracePassword(PleaserememberyoumustchangeyourPay-Tracepasswordevery60days)

ServerAddress

AddressofthePayTraceserver.https://paytrace.com/api/default.pay

TestModeTransactionwillsendbesendtoPayTrace intestmode,usingthedemoaccount.Thecreditcardwillnotbeprocessed,butyouwillreceiveaproperresponse.

PPIPaymover(YoumustobtainthisinformationfromPaymentProcessingInc.)

AccountToken AccountTokengeneratedfromPaymentProcessing.

RETAIL

Check this ifyouhaveaRetail (industry type)account.OtherwiseDIRECT MARKETING is assumed. In case you use a card reader,thosetransactionsareautomaticallyassignedtotheindustrytypeRETAIL.

16 QMerchantManual

September14,2017

Hardware

CardReader

Use a magnetic stripe reader. Select the type of your magneticstripereader.QMerchantsupportsUSBHIDorUSBkeyboardemu-lationinterfacescardreaders.Amongthesupportedtypesare:MagTekMagMini21040101ornewerUICMSR213Encrypteddevices:(PPIgateway)MagTekMagneSafecardreaderMagTekIPadPinPad

ReceiptPrinterSelect the receiptprinter youuse. The selectionof ‘None’meansthatthereisnoprinterused.

AutoPrintIfchecked,automaticallyprintthereceiptafterasuccessfultrans-action.

PrintPreview Checkthisbox,toreviewthereceiptbeforeprinting.

PrintCopies Selectthenumberofcopies.

QuickBooks Settings (There are no specific transaction orpaymenttypesforQuickBooksPointofSale)

TransactionTypes(notavailablewithPOS)

Choose theQuickBooks transaction types forpaymentprocessing(checkall thatapply).Currentlywesupport thefollowingtransac-tion types from QuickBooks: ‘Sales Receipt’, ‘Receive Payment’,‘CreditMemo’, ‘Invoice’and‘SalesOrder’.Werecommendcheck-ingthefirstthreetransactiontypes.ForuseofRecurringBillingyoumustcheckInvoice.Default settings are: ‘Sales Receipt’, ‘Receive Payment’, ‘CreditMemo’.

Paymenttypes

Whichtypesofpaymentwillbehandledbyyourpaymentproces-sor (check all that applies)? These payment types are defined inQuickBooks in the Payment Method List. Usually you check alltypesofCreditCardPayments.

PreferencesAutomaticallycon-necttoQuickBooks

CheckifyouwillautomaticallylogontoQuickBooks.

QuickModeWhenchecked,aminimalpaymentwindowisshownfortheusualday-to-daytransactions.

UseShortCuts Enableuseofkeyboardshortcuts.

autoClosePaymentDefaultfalse.Ifsettotruethepaymentdialogisclosedautomaticallyafterprint-

17 QMerchantManual

September14,2017

ingoriftheprinterselectioninthesettingsissetto‘None’afterasuccessfulpaymenttransaction.

showSelectDialog

AlwaysshowtheSelectTransactionDialog.Default:true.IfsettofalsetheSelectTransactionDialogisshownonlywhen:

1. Notransactionsarefound.2. Morethanonetransactionisfound.

autoCloseSelectDialog

Default:false.Ifsettotrue,theSelectTransactiondialogisclosedautomaticallyiftherewasonlyonetransactionshown.

SendEmailReceipt

Send an email receipt to the customer via the selected paymentgateway.Currentlysupportedgatewaysare:

authorize.net(Overridesthemerchantaccountsettings)PayTrace

Pleaseentertheappropriatedataanddonotforgettopress‘Save’tostoreyoursettings.

18 QMerchantManual

September14,2017

KEYBOARDSHORTCUTSKeyboardshortssimplify theuseofsomeof theQMerchantdialog.Fivedifferentshortcutsare implemented for thefollowingdialogsandareactivewhenyouareconnectedtoQuickBooks.Theshortcutscangetmodifiedviathecustomsettingsdialog.Tousetheshortcuts,pleaseenableitinthesettingsdialog.

GLOBALThereisaglobalshortcutAlt–Gthatdirectlyopensthepaymentdialogfromanyapplication.Whenyoui.e.havesavedatransactioninQuickBooks,bypressingAlt-Gthepaymentwindowcomes.ThereisnoneedtobringQMerchanttothefront.MAINWINDOWAlt–G Getthepayment.Openeitherthepaymentdialogortheselecttransactiondialog.

SELECTIONOFTRANSACTIONSWINDOWAlt–P Processtheselectedtransaction.Openthepaymentwindow.Alt–C Closethewindow.

PAYMENTWINDOW(SMALLANDLARGEWINDOW)Alt–S SubmitthetransactionAlt–R PrinttheReceiptAlt–C Closethewindow.

19 QMerchantManual

September14,2017

20 QMerchantManual

September14,2017

MULTIPLEMERCHANTACCOUNTSYoucansimultaneouslyusemultiplemerchantaccounts.Theadministrationisdoneasfollows:

Pleaseenablethemultiplemerchantaccountsfeaturefromthespecialmenu.

EnterallnecessaryinformationinthePaymentGatewayInformationbox.

ThenenterintheMultipleMerchantAccountstextfieldanameforthisaccountandpress‘Add’.Thiswillcreatethismerchantaccount.

With‘Del’youdeletetheselectedaccountandwith‘Chg’youwillchangetheinformationfortheselectedaccount.

Ifyouneveraddedanaccount,theinformationasshowninthePaymentProviderGatewaywillbeused.Ifyouaddedonlyoneaccount,thatonewillbeusedautomatically.

Ifyoudefinedmorethanonemerchantaccount,youhavetoselectthemerchantaccounttouseatthedashboard.

Themerchantaccountselectionisvisibleonlyifyouhavedefinedalistofmerchantaccounts.

21 QMerchantManual

September14,2017

USEQMERCHANTASVIRTUALTERMINALWITHOUTQUICKBOOKSFromToolsmenuchoose‘VirtualTerminal’.Thefollowingdialogappears:

EnterthenecessaryinformationandpressSubmittoprocessthecreditcard.DependingontheversionofQMerchant,youcanprocesse-checkswithAuthorize.Netalso.Toswitchbetweencreditcardande-check,makeyourselectionofthepaymenttypeatthebottomofthedialogmentionedabove.Thee-checkpaymentdialogisasfollows:

22 QMerchantManual

September14,2017

Withthevirtualterminalyoucanalsoprocessothertransactiontypes.ThosearelistedatthebottomofthepaymentscreenundTX-Type.Mostcommontypesare

VOID Voidaprevious–notyetsettledtransaction.

REFUND Refundaprevioussettledtransaction

Pleaseenter intheparametersfield(bottomleft)thetransactionandtheauthorizationcodeseparatedbyaslash i.e.0006780/12345.Thenentertherefund/voidamount,creditcardnumberandexpirationdataandpresssubmit.

Ifyoudonotknowtransactionidorauthorizationcode,bothareincludedinthetransactionreportorthetransactionlog,accessiblefromtheQMerchantmenus.

23 QMerchantManual

September14,2017

USEQMERCHANTWITHQUICKBOOKSPRO,PREMIERE,ENTERPRISEAlwaysstartQuickBooksfirst,becauseQMerchantistriggeredautomaticallybyQuickBooks.

AfteraconnectiontoQuickBookswasestablished,theDashboardlookslikethis:

ThereareseveraltransactiontypessupportedbyQMerchant,whichareusedforfurthertransactionprocessing:

• SalesReceipt,• ReceivePayment,• CreditMemo• Invoices(automaticallycreatesareceivepaymenttransactionorusedforrecurringbilling)• SalesOrder(automaticallycreatesareceivepaymenttransactionifitisaCAPTUREtransaction)

Basedonexample screenshots fromQuickBookswewilloutline the typicalpaymentprocedure.Thisprocess remainsthesamewithotherQuickBooksversion,butthescreensmaylookdifferent.

Pressthegreen‘GetPayment’buttontocaptureapaymentfromQuickBooks.Hint:IfyouhavestoredcreditcardnumbersinQuickBooksandyouwouldliketousetheminQMerchant,pleaseopenthepaymentinformationofthecustomerinQuickBooksandcopyandpastethecreditcardnumberintotheaccountno.field.Ifthatfieldisusedforotherpurposes,pleasefollowtheinstructionsintheQMerchantTroubleshootsection(#10)

24 QMerchantManual

September14,2017

WORKINGWITHSALESRECEIPTS(TheoutlineoftheQuickBooksdialogsmayvaryandbedifferentdependingontheQuickBooksversionyouuse).

CreateasalesreceiptinQuickBooks.Inordertoprocessthepaymentandchargeacreditcard,itisimportantthatyouselectthecorrectPaymentMethod.Thismustbeoneofthepaymentmethodsyouacceptedinthesettingsdialog.Af-tercompletingthesalesreceipt,press‘Save&Close’or’Save&New’.Makesure,thatthethecheckbox‘’Process…paymentwhensaving’abovethe‘Save’buttonsinNOTchecked.OtherwiseyouwilluseIntuitforpaymentprocessing.

Nowpressthegreen‘GetPayment’buttoninQMerchant.TheinformationofthesalesreceiptistransmittedtoQMer-chantandthefollowingdialogpopsup.Mostfieldscontaininformationofthesalesreceipt.Pleasecompletethemissingfields(Thoseinyellowaremosttimerequired)andpresssubmit.Thiswillsendtheinformationtoyourpaymentproces-sorforfurtherprocessing.

25 QMerchantManual

September14,2017

Ifyoudidn’taddsomerequiredinformation,youwillseethosefieldsflaggedredandfurtherprocessingissuspendeduntilyouenterthe information.Asaresult,thepaymentprocessorrespondseitherwithasuccessorafailure. Inanycaseyouwillgetanappropriatemessage.Incaseofasuccesstheresultwillappearas:

26 QMerchantManual

September14,2017

Theresultingauthorizationcodeand/orthetransactionidareshown.Wheneveryouaddedorchangedthecreditcardinformation,thisinformationcanbecomestoredinQuickBooks.Pleasepress‘UpdateQuickBooks’todoso.Inanycase,theauthorizationcodeandthetransactionidarerecordedinQuickBooks.

Incaseofafailure,youcandirectlyreturntothesalesreceiptinQuickBooksanddothenecessarychangesthere.Haveinmind;thetransactionisrecordedinQuickBooks,eveniftheprocessingwithyourpaymentproviderfails.So,youareresponsibletotakecorrectiveactions.

Asmentionedabove,theauthorizationcode,thetransactionid,theamountchargesandthelastfourdigitsofthecreditcardarerecordedinQuickBooks.Tomakethosevisible,youmustchangeyoursalesreceipttemplate. Inthesalesre-ceiptpress‘CustomizeTemplate’andselectyourtemplatefromthedialog.

‘Edit’willleadyoutothefollowingscreen:

27 QMerchantManual

September14,2017

UnderfieldsisanadditionalentryQ_Authorization.

TherearealsosomefieldslabeledQ_RB_.Thoseareforusewithrecurringbilling.

PleasecheckthefieldQ_Authorizationandaddsometitlelike‘TXID’toit.Andpress‘OK’tosaveyourchanges.TheTXIDwillappearinthesalesreceiptasshownbelow.

28 QMerchantManual

September14,2017

USEOFCHECKSAnalternativetotheuseofcreditcardsistheelectroniccheckfeature.(Pleasenotethatthisisnotsupportedbyallpaymentgateways)

Just select inQuickBooks as paymentmethod ‘Check’. InQMerchant the echeck payment informationwill come up.Mostvaluesarepreset.Youhavetoenterthebankaccountnumberandthebankroutingnumber.AsyoucanseeatthebottomofthepaymentwindowaspaymenttypeECHECKisselected.

There isalsoaway toautomate theentryof thebanking information. InQuickBooksyoucandefinesomeadditionalfieldsthatholdthisdataforeachcustomer.Pleasenamethefieldsasfollow:

BankName: NameofthebankBankAccount: CustomeraccountnumberBankRouting: Routingofthebank(ABA)

IncaseyouworkwithinvoicesinQuickBooks,thenyoutomanuallyselectECHECKaspaymenttypeintheQMerchantpaymentscreen.

29 QMerchantManual

September14,2017

WORKINGWITHINVOICES/RECEIVEPAYMENTS(TheoutlineoftheQuickBooksdialogsmayvaryandbedifferentdependingontheQuickBooksversionyouuse).

WhenaninvoiceisrecordedinQuickBooks,thereisnotadirectpaymentinvolved.PaymentwillusuallybedonebyaReceivePaymenttransaction.

MakesurethatyouselecttheappropriatePaymentMethodandthen‘Save&Close’or‘Save&New’.Makesure,thatthethe checkbox ‘’Process…paymentwhen saving’ above the invoice list isNOTchecked.Otherwiseyouwill use Intuit forpaymentprocessing.

Nowpressthegreen‘GetPayment’buttoninQMerchant.TheinformationofthepaymentistransmittedtoQMerchantandthesamedialogsasdescribedwiththesalesreceiptprocedureabovewillfollow.

When in the Settings under Transaction Types the option ‘Invoice’ is checked, invoices for payment can be selectedmanually.Fromthedashboardpressthegreenbutton‘WaitforPayment’.Thiswillshowalistofunpaidinvoicesaswellasofalltransactionsfromthelast2/15minutes.

Usuallyonlyunpaidinvoicesareretrieved.Inadditiontothisretrievedinvoicesarefilteredbythepaymentterms.I.e.whenapaymenttermCreditCardisspecified,onlyinvoiceswiththistermareretrieved.Allothersareignored.Byde-fault,thereisfilteringofinvoicesdisabled.Toenableit,pleasechangethe‘FilterInvoicesbyTerm’inthe‘CustomSet-tings’.Pleasereadmoreunder‘CustomSettings’.Fromtheinvoicesshown,highlighttheoneforthepaymentandpressOK.

30 QMerchantManual

September14,2017

Youcanpaytheinvoicesimilartothesalesreceiptexplainedearlieron.Afterasuccessfulpayment,QMerchantauto-maticallycreatesareceivepaymentinQuickBooks. Inordertoseethesuccessfulpaymentintheinvoice,youhavetocustomizetheinvoicetemplateasdescribedforthesalesreceipt.Theinvoicewillthenlooklikethescreenshotbelow.

31 QMerchantManual

September14,2017

WORKINGWITHSALESORDERSTheuseofsalesordersinconjunctionwithQMerchantissimilartothehandlingofinvoices.

FirstyoucreateinQuickBooksasalesorder.Dependingonyourmodeofoperationyoucannowselect inQMerchantthesalesorderandprocessitwiththepaymentprovider.

Usually you justdoanauthorization to validate the credit cardandamount.Wewill storea successful authorizationbacktoQuickBooks.Whenyoulatercreateaninvoiceforthesalesorderthenyoucancapturetheamount.Itisbasicallythesameaswithinvoices.QMerchantdisplaystheauthorizationcode/transactionidofaformerauthorizationtransac-tion.Afterasuccessfulcapture,areceivepaymenttransactionisautomaticallygeneratedinQuickBooks.

Ifyouhavechosentochargethecreditcardwiththesalesorder,thenareceivepaymenttransactioniscreatedandyourcustomerhasacredituntilyouapplyittoaninvoicelateron.

Anexample(forauthorize.net):

InQuickBookscustomizethetemplatesforsalesordersandinvoicesandmadevisibletheadditionalfieldQ_Authorizationtoseetheauthorizationcodeandtransactionid.

InQMerchantinthecustomsettingschangeDefaultTxtypetoAUTH_ONLYtoavoidincidentalcaptureofsalesorders.AlsointheQMerchantsettingsselectSalesOrderastransactiontype(SointherightupperlistatleastSalesOrderandInvoiceischecked).

NowcreateasalesorderinQuickBooksandcaptureitviatheQMerchantgetpaymentbutton.InthepaymentscreenatthebottomthetxtypeisselectedasAUTH_ONLY.SubmitandauthorizethecreditcardandstoretheauthorizationcodebacktoQuickBooks.

ThencreateinQuickBooksfromthesalesorderaninvoice.OpenitinQMerchantviathegetpaymentbutton.Atthepay-mentscreenattheleftbottomistheauthorizationcodeshownandastxtypeVOIDisselected(Unfortunatelythisisthede-fault).ChangeVOIDintoPRIOR_AUTH_CAPTUREandsubmit.Thiswillnotaskforanycreditcardinfoandthecardwillbecharged.

32 QMerchantManual

September14,2017

WORKINGWITHCREDITMEMO(TheoutlineoftheQuickBooksdialogsmayvaryandbedifferentdependingontheQuickBooksversionyouuse).

ACreditMemoisatransactionwhereyourefundthecustomer.Thiscanbedonebyrefundingacreditcard.ThestepsinQuickBooksareasfollows:

CreatetheCreditMemo.

Saveitandchoosehowtoprocessthecreditmemo.

Issuetherefund.MakesurethatyouselectthePaymentMethodasindicatedandpress‘OK’.TheprocessingwithAu-thorize.Netisthesameasdescribedearlieron.

Makesure,thatthethecheckbox‘’Process…paymentwhensaving’atthebottomisinNOTchecked.OtherwiseyouwilluseIntuitforpaymentprocessing.Thenpressthegreen‘GetPayment’buttoninQMerchantandproceedinQMerchant.

33 QMerchantManual

September14,2017

RECURRINGBILLINGRecurringBillingissupportedfortheQuickBooksdesktopversions(notPoint-of-Sale)andwithauthorize.netaspaymentprovider.Therearesomestepsnecessarytoenablerecurringpayment.1.Withauthorize.netyouneedacard-not-presentaccountwithrecurringbillingenabled.2.InQuickBooksmakesurethatyouhaveunderTermsanentry‘RecurringBilling’.Furthermorecheckthatyouhavethesameentryavailableaspaymentmethod.TheseentriesareautomaticallyaddedwhenyouinstallQMerchant.3.IntheQMerchantsettingsdialog,selectInvoiceasTransactiontype.

4.Youuserecurringbillingwithinvoices.Wehavetwodifferentscenarioshere.

a. Youhaveanunlimitedrecurringbilling.Pleasechooseasinvoiceamounttheregular(i.e.monthly)paymentrate.InQuickBooks,enteraninvoiceamountwiththeregularpaymentamountandselect‘RecurringBilling”asTerms.

b. Youhaveafixednumber(i.e.12)ofpayments.InQuickBooks,enteraninvoiceamountwiththeentireexpectedpaymentsandselect‘RecurringBilling”asTerms.

Theinvoicetemplatewilllooklikethefollowing:

Inthepictureaboveyoualsoseesomeadditionalfields,whicharefilledbytheQMerchantapplication.Theyhavethefollowingmeaning:Q_Authorization:authorizationcode,transactionid,subscriptionidwhateverisappropriate,amountchargedQ_RB_Info:Ratefortherecurringbillingofthisinvoice,Intervalinwhichthebillingoccursandmaximalnumberofbillings.Whenyousavetheinvoice,youcanretrievethattransactionanddisplayit–viathe‘GetPayment’buttoninthepaymentdialogofQMerchant.AtthebottomofthemerchantdialogRecurringBillingisselectedaswellasCreateSubscription.

34 QMerchantManual

September14,2017

AdditionallytheRecurringBillingDialogisvisible.

Thefieldshavethefollowingmeaning:

• Start: Date,whenthebillingstarts.Bydefaultitistoday’sdate.TheformatisYYYY-MM-DD• Every: Periodinwhichthebillingoccurs.I.e.1Month=Everymonth,10Days,everythendays• Times: NumberoftimesthebillingoccursorUnlimited.

Whenyouchangethenumberoftimes,theamountwillbeadjusted.Itiscalculatedasamountoftheinvoicesdividedbytimes.Exceptyouchoose‘Unlimited’.Thentheamountisnotadjusted.Ifthesefieldsarecorrectandyouenteredthecreditcardinformation,thesubsriptionissubmittedtothepaymentprovider.That’sall.Afterasucessfulcompletionthesubscriptionidisshown.WhenyougobacktotheinvoiceinQuickBooks,itwilllooklikethiswithallQ_fieldspopulated.

Ifyoueverhavetheneedtocancelasubsription,youmayeitherdothatatthepaymentprovidersmerchantwebsiteorasfollows:OpentheVirtualTerminal,selectaspaymenttype‘RecurringBilling’,Cancel_SubscrastxtypeandenterthesubsriptionidoftheinvoiceinthefieldSubs_ID.Thensubmit.Thesubscriptionwillbecancelled.

35 QMerchantManual

September14,2017

Whenyoureceivelateronapaymentbyyourpaymentprovider,youmustmanuallycreateareceivepaymentinQuickBooksoruseourQImportsoftwareproduct.Tomanuallycreatethereceivepayment,pleasedothefollowinginQuickBooks.Selectthecustomeranditsinvoiceandopenthereceivepaymentdialog.Pleaseselectaspaymenttype‘RecurringBilling’.ThatwaysitpreventsQMerchantfromopeningupthepaymentdialogagain.Thedialoglooksasshownbelow.

36 QMerchantManual

September14,2017

BATCHPROCESSING(‘UNATTENDEDMODE’)Incaseyouhaveauthorize.netaspaymentgateway(othersmaybeimplementedlateron)youcanprocessaseriesofpayments inunattendedmode.Bydefault, theunattendedmode isNOTenabled.Tomakeuseof it,pleaseopenthesettingsdialogandclickthemenu‘Special’.Makesurethat‘AllowBatchProcessing’ischecked.

Whennowthegreen‘GetPayment’buttonispressed,thelayoutofthetransactionselectiondialogischanged.

Thequery for transaction remainsunchanged.After thequery isdone,QMerchantanalyzes the transactiondataandverifiesifthetransactioncanbeprocessed.Thatverificationdependsonthetx-type(AUTH_CAPTURE,AUTH_ONLYetc.)thatisused.Validtransactionsaremarkedgreenandchecked.Invalidonesareinredandunchecked.

Foralltx-types:Thetransactionmusthaveacreditcardnumberandanexpirationdate.Theamountofthetransactionislargerthanzero.

AUTH_CAPTURE:Validifthetransactionwasneverchargedearlieron.AUTH_ONLY:Validifthetransactionwasneverchargedearlieron.Allothertx-types:Validifthetransactionhasatransactionid/authorizationcode.

Regardlessofthecolormarking,youcancheckthetransactionanditwillbeprocessed.Hoveringthemouseoverthefirstcolumnofthelistshowsthereasonwhyatransactionismarkedgreenorred.

Pleasereviewalltransactionandcheckallthosetransactionthatmustbeprocessed.Thesmall+and–buttonsselectallornone.Whenthereviewisdone,click‘Processcheckedtransactions’.Theunattendedmodestarts.SametimearedSTOPbuttonisdisplayedthatstopstheprocessing.Duringtheprocessingeachtransactionsismarkedifprocessedsuc-cessfulornot.Ifsuccessful,itisstrokedoutandmarkedgray.Ifthetransactionfailed,itismarkedred.Hoverthemouseoverthefirstcolumnofthefailedtransactiontoseethefailurereason.Everythingelseisidenticaltothesingletransac-tionprocessing.Don’tforgettoreviewthetransactionlogaftertheunattendedmodeisfinished.

Still,youcanprocessasingletransactionasusual.

Reminder:Whenyouliketore-processthetransactionforwhatreasonever(likevoidingall),pleasequeryagain,sincethelistedtransactiondoNOTreflectthepreviousprocessingstate.ThatstateisupdatedinQuickBooksonly.

37 QMerchantManual

September14,2017

BEHAVIOROFTHEGETPAYMENTBUTTONThe behavior of QMerchant after you click at the Get Payment button depends on the transaction types you havecheckedinthesettings.QMerchantsupportsfivedifferenttransactionstypes.

SalesReceiptCreditMemoReceivePaymentInvoiceSalesOrder

Thefirstthree(SalesReceipt,CreditMemo,ReceivePayment)directlycorrespondtotherespectiveQuickBookstransac-tions.Whenthesetransactiontypesarecheckedandyoucreateoneofthosetransactions,theGetPaymentbuttonwillqueryQuickBooksforallthosetransactionscreatedormodifiedwithinthelastfiveminutes.Theyaredisplayedinadia-logandcanbechosenforfurtherprocessing.TheInvoicetransactionismainlyused,ifyouworkwithrecurringbilling.Here,theGetPaymentbuttonretrievesinvoic-escreatedormodifiedwithinthe lastfiveminutesandwithRecurringPaymentaspaymenttermset.Whenyouthenprocessatransactionwithyourpaymentprovider,QMerchantautomaticallycreatesareceivepaymenttransaction inQuickBooks,sothattheinvoicesismarkedPAIDinQuickBooks.

Mostcommon,onlySalesReceipt,CreditMemo,ReceivePaymenttransactiontypesarechecked,becausethosearetheonlyQuickBookstransactionthatareinvolvedinsomekindofpayment.Ifyoumainlyworkwithinvoices,thepleaseun-checkReceivePayment.OtherwiseyouwillseetransactioncreatedbyQMerchantinthepaymentselectiondialog.

Thetransactionsinthelistaremarkedasfollows:

ClearText:Acreditcardtransactionnotyetprocessed.

StrokedText:Atransactionthatisprocessed.DoubleclickitonlyifyouneedtoVOIDorRefundthetransaction.

38 QMerchantManual

September14,2017

ClearTextwithgraybackground:Atransactionsubmittedintestmode.So,thecreditcardwasnevercharged.EitherreprocessthetransactionoutsideoftestmodeorremoveitinQuickBooks.

ItalicText:Atransactionwherewecannotdetermineexactlyifitwasprocessedornot.Pleasecheckthetrans-actionlog.ThismayhappenonlyforSplittransactionsinQuickBooksPoint-of-Sale.

Queryfortransactionsbydate.

QuickBookshastwodifferentdates.Oneisthetransactiondate,asshowninthedatefieldofthetransaction.Theotheroneisthetransactionmodificationdate.Inthequerydialog,wemixboth.Whenyoujustchangedorcreatedatransaction(withinthelast15mins)thatoneisshown.

Whenyouquery fora transaction,we look for themodificationdateof the transaction.WhenusingaQuick-Booksdesktopversion,youcanalsoquerybytransactiondate.Thosearethequeries inthe lowerpartofthedateselectionbox.

Queryfortransactionsbyreferencenumber.

YoucanalsoseektransactionsinQuickBooksbyreferencenumber.Pleaseselect‘EnterReferenceorCustomer’andenterthereferencenumberofthetransactioninthequeryfield,replacingthedateselectionsandclickque-ry.Thequeryisdoneasfollows:

QuickBooksDesktopversions:Queryforthetransactiontypesasspecifiedinthesettingsdialog. Ifthetransactiontypeallowspaymentmethods(i.e.salesreceipt),onlycreditcardpaymenttransactionsareretrieved.

QuickBooksPoint-of-Sale:Onlysaleswithacreditcardpaymentareretrieved.

Queryfortransactionsbycustomername.

YoucanquerytransactionsinQuickBooksbycustomername.Pleaseselect‘EnterReferenceorCustomer’andenterthecustomernameinthequeryfield,replacingthedateselectionsandclickquery.Thequeryisdoneasfollows:

QuickBooksDesktopversions:Queryforthetransactiontypesasspecifiedinthesettingsdialog. Ifthetransactiontypeallowspaymentmethods(i.e.salesreceipt),onlycreditcardpaymenttransactionsareretrieved.

QuickBooksPoint-of-Sale:notavailable.

39 QMerchantManual

September14,2017

USEQMERCHANTWITHQUICKBOOKS–POINTOFSALE(TheoutlineoftheQuickBooksdialogsmayvaryandbedifferentdependingontheQuickBooksversionyouuse).

SelectQuickBooks–PointofSalefromtheQMerchant-Dashboard.

Thefollowingdialogappears.

Itmaytakesometimeuntilthenextscreenwiththecompanydataselectioncomesup.

SelectyourPOSdatafile.Itmayhappenthatyouwillseethesetupdialogsasdescribedearlier.

AfterthattheQMerchant-Dashboardlookslikethis:

40 QMerchantManual

September14,2017

InordertomakeasalewithQuickBooks–PointofSaleyoustartwiththefollowingscreeninQuickBooks–PointofSaleandcreateasale:(ThefollowingscreenshotsmaydifferinvariousQuickBooksPOSversions)

Createasale.

Afteryoufinishedpressthe‘Credit’buttonforcreditcardpaymentandadialogwiththevariouscreditcardscomesup..

41 QMerchantManual

September14,2017

Chooseoneofthecreditcardtypesandreturntothepreviousscreen.

Press“SaveOnly”orSave&Print”.NowyouarefinishedwiththeQuickBookspartofthepayment.NavigatetotheQMerchantDashboardandpress“GetPayment”

42 QMerchantManual

September14,2017

ThesaleisrequestedfromQuickBooks–PointofSaleandpresentedasfollows:

Completetheyellowfieldseitherbyswipingacreditcardorbyenteringthemmanually.ThenPress‘Submit’totransferthedatatoyourpaymentprocessor.Aftercompletionyouseeamessageboxwiththeresult.DependingonyourQuickBooks–PointofSaleversion,QMerchantwilladdthetransactionidandtheauthorizationcodetothesalesreceiptinQuickBooksPOS.Youalsocanhardcopyareceiptwiththe‘Print’button.Haveinmind;thetransactionisrecordedinQuickBooks,eveniftheprocessingyourpaymentprocessorfails.So,youareresponsibletotakecorrectiveactions.

Ifyourcustomerisgoingtopaythebillwithseveralcreditcards,pleaseenterthosedifferentpaymentsinQuickBooksPoint-of-Sale.QMerchantwillautomaticallycreatethenecessarynumberoftransactionsforapprovalandprocessing.

43 QMerchantManual

September14,2017

VOIDS,CREDITSANDREFUNDSQuickBooksPointofSalehasfourdifferenttransactiontypes,whichwillresultinacreditcardtransaction:

SalesandDepositwillchargeacreditcardwhileReturnandRefundwill refundacreditcard.Normallywewilldetectthesetransactiontypesautomatically.WealsodetectifaSaleisinfactarefundbecauseofexchangeditemsor.Means,wheneverwedetectthatthetotalamountisnegative,wetreatthisasarefund.

Theexception to this is aVOID. If you like to voida transaction, then clickatpayment screen inQMerchant the link‘SwitchtoMANUAL’.Thenyouareabletomakechangesintheparameterfieldsatthebottomofthepaymentscreen.PleaseenterthetransactionidofthetransactiontovoidintheTX-IDfield.SelectVOIDasTX-Type.Thenenterthecreditcardinformationandpresssubmit.

ImportantRules:

Thesearetheguidelinesforissuingacreditfromauthorize.net.Theyaresimilarforotherpaymentproviders:

ThistransactionisalsoreferredtoasaRefundandindicatestothegatewaythatmoneyshouldflowfromthemerchanttothecustomer.Thegatewaywillacceptacreditorarefundrequestifthetransactionsubmittedmeetsthefollowingconditions:

• The transaction is submitted with the ID of the original transaction against which the credit is being issued(tx_id).

• Thegatewayhasarecordoftheoriginaltransaction.• Theoriginaltransactionhasbeensettled.Ifitisnotsettled(usuallythetransactionisasoftoday,pleaseusethe

VOIDfunction)• ThesumoftheamountsubmittedintheCredittransactionandallcreditssubmittedagainsttheoriginaltransac-

tionislessthantheoriginaltransactionamount.• Thefullorlastfourdigitsofthecreditcardnumbersubmittedwiththecredittransactionmatchthefullorlast

fourdigitsofthecreditcardnumberusedintheoriginaltransaction.• Thetransactionissubmittedwithin120daysofthesettlementdateandtimeoftheoriginaltransaction.

Incaseyousubscribed toauthorize.netECCExpandedCreditCapabilities, youcancreditanyamount toacredit cardoutsideoftherulesabove.ECCcanbeenabledattheauthorize.netmerchantwebsite.

44 QMerchantManual

September14,2017

QUICKMODEFordaytodaytransactionsi.e.saleorsalesreceiptyoucanchooseinthesettingstousethequickmodeinsteadofthefullpaymentview.Thewindowshowsasfollowsandallowsyoutoenter/swipethecreditcardinformationandsubmitthedatatothepaymentgatewayprovider..

Allbuttonshavethesamefunctionsasinthefullpaymentview.

Aclickatthesmallbuttonlabeled‘F’returnsyoudirectlytothefullpaymentview.

45 QMerchantManual

September14,2017

SERVERINSTALLATIONANDMANAGEMENTInstallQMerchantataWindowsserverofyourchoice.QMerchantisinstalledforAllUsers.

TheinstallationofQMerchantforaserverisidenticaltothedesktopinstallation.PleaseconfigureQMerchantcomplete-lyatyourfirstdesktopstation.TheservermanagementisavailableafterQMerchantisactivatedbyaserveractivationcode.Duringthisactivationthecurrentprofileandallsettingsarecopiedtoacommonplace,whereallusersofQMer-chantcanaccessthose.

Whatistheeffectofaserver?

ThenormalusercanonlychangetheQMerchantsettingsforsomeindividualparametersasprinterorswipereader.Allothersettingsaredisabled.OnlytheQMerchantadministratorcanchangethosesettingsandmakethemavailabletoall.

AfterServeractivation,fromtheSupportmenu,anewentry‘ServerManagement’isshown.WithservermanagementanormalusercancopythecommonQMerchantprofiletoitsindividualstation.Also,youcanlogonasAdministrator.Theloginispasswordprotected.ThepasswordisalwaystheQMerchantserialnumber,availablefromtheAboutdialog.

OnlytheQMerchantadministratorcanchangetheQMerchantsettingsaswellasthecommonprofile.Thesettingsaresavedautomatically.Ifyouwouldliketomakeyourindividualsettingsavailableforeverybody,usethesetprofilemenucommand.

QMerchantdeactivation.

OnlytheQMerchantadministratorcandeactivateQMerchant.Afterloginasadministrator,theLicenseManagementisvisible.

46 QMerchantManual

September14,2017

LEVELIIDATASome payment providers support Level II transaction data. Level II data are submitted automatically. The followingscreenshotshowsthepositionoftheLevelIIdata.

Thecalculationsareasfollows:

PO_NumiscopiedfromReference.TaxiscalculatedCustomerIDisgeneratedfromLastnameandFirstnameTaxExemptissetifthereisataxamountornot.Regardingdutyandfreight,theamounttransmittedis0.00.IfwedetecttheitemsDuty,FreightorShippingwewilltransmittherealamount.Allfieldsareeditable.Iftaxischanged,thesubtotalischanged.

47 QMerchantManual

September14,2017

LEVELIIIDATAWhenusingbusinessorgovernmentpurchasecard,atleastLevel2dataarerequiredasexplainedabove.InadditiontothatLevel3 isastepto lowerthetransactioncosts.Currently–uptoourknowledge–onlyafewpaymentgatewayshaveimplementedtheacceptanceofLevel3data.

QMerchant currently supports the transmissionof Level3data for thePayTrace gateway.Youcan specify theuseofLevel3inthesettingsdialog.

Bydefault,theLevel3modeisNOTenabled.Tomakeuseofit,pleaseopenthesettingsdialogandclickthemenu‘Spe-cial’.Makesurethat‘Level3’ischecked.

QMerchanttransmitsthefollowinginformationtothepaymentgateway:

AllLevel2fieldsplusShip-TocountryShip-TopostalcodeAdditionalTax=0.00AdditionalTaxrate=0.00Informationforallthelineitems:

ID,Description,Quantity,UnitofMeasureasEACH,Unitprice,Amount,Addl.Taxas0.00,Addl.Taxrateas0.00,Discountas0.00

48 QMerchantManual

September14,2017

CIM(AUTHORIZE.NETCUSTOMERINFORMATIONMANAGEMENT)WithQMerchantv5.1.0wesupporttheusageofauthorize.netcustomerprofiles(CIM)toprocesspayments.

CIMisnotenabledautomatically.Toenableit,pleaseselectfromtheInformationmenuSupport|CustomSettings.Ac-ceptthemessage.FromthefollowingdialogrevertCimEnabledfromfalsetotrue.Pressoktosavethedialog.

Whenyouopenapaymentscreen i.e.via theVirtualTerminalyouseeanewentryCIM in themenuof thepaymenttypes.

WhenyouselectCIM,thereisanewgroupoffieldbelowthecreditcardinformation.

49 QMerchantManual

September14,2017

Thefieldshavethefollowingmeaning:

ThefirsttextboxistheCustomerProfileID.TheseconddropdownlistcontainstheCustomerPaymentProfileIDs.BotharenecessaryinordertouseCIMforpayment.

WiththecheckboxyoucandefinetouseCIMortouse.i.e.acreditcardforpayment.

WiththeUpdateButtonyoucanchangethecreditcard information intheCIMpaymentprofile.Addeithercreatesanewcustomerprofileatauthorize.net(ifnotalreadydefined)oraddsanewpaymentprofilethere.ThebuttonwiththequestionmarkshowstheCIMprofileasgiveninthefirsttextbox.

Youcanhaveasmanyastendifferentpaymentprofiles.Ifthereismorethanoneprofileyouhavetoselectwhichonetouse.Inadditiontothepaymentprofilenumberweshowthelast4digitsofthecreditseparatedbyanasterisk.

MosttimesCIMisusedwiththeCIMprofile informationcapturedfromQuickBooks.Weexpectthat informationcon-tainedanadditionalfieldnamedQ_CIM,definedatthecustomerlevelinQuickBooks.TheinformationinthefieldistheProfileID.WhenQMerchantfindsthatinformationwewillautomaticallysuggestitforpayment.

IncasethatyoudonothaveaCIMProfile,usecanusetheAddbuttontocreateone.IfthecreationwassuccessfulwewillautomaticallytransferittoQuickBooksandstoreitintotheQ_CIMfieldforlaterusage.

IfyouhavetheneedtocreatealargeamountofCIMprofiles,werecommendtheusageofourothertoolslikeQImport.Pleasecontactourhelpdesk.

InQuickBooksPoint-of-Sale,pleasedefineacustomfieldas follows:FromthePreferencesmenuselectCompanyandthenfromthelistboxGeneralandMyFieldLabels.Nameoneofthe“CustomerCustomFields”Q_CIMandcheckUse.Leavethedialogwithsave.

Note:QMerchantcurrentlydoesnotallowtheuseofrecurringbillingwithCIM.

50 QMerchantManual

September14,2017

USEOFMAGNETICSTRIPEREADERSQMerchant supports several Magnetic Card Readers. Most commonly used is the Magtek USB Reader like MagTek21040101thatweusedfortesting.EveniftheyhaveanUSBconnector,theyoperateeitherasUSBHIDdeviceorasocalledkeyboardwedge.

Yousimplecantest,whichtypeofcardreaderyouhave.PleaseopentheWindowsnotepad.Placethecursorintothenotepadandthenswipeacard.Ifyouseethecarddatainthenotepadthenyouhaveakeyboardwedge.IntheQMer-chantsettings,pleaseselect‘Keyboard’.

OtherwiseyouhaveanUSBreader.Pleaseselecttheappropriatetype.

Useofkeyboardwedge:

Whenthepaymentscreenopens,thecursor isusuallyplaced inthecreditcardnumberfield.Nowyoucanswipethecardandtheinformationfromthecreditcardisdisplayinthevariousfields.Youcanrepeattheswipeasoftenasyouneed.PleasemakesurethatifpossibleyourkeyboardwedgesendaCRafterfinishingreading.Pleaseconsultthestripereader’smanual.

UseofUSBcardreader:

Whenthepaymentscreenopens,youcanswipethecardatanytime.Ifthecardisswipedsuccessfully,agreenlabelisshownabove thesubmitbutton.Wheneveryouneed toswipe thecarda second time (i.e. thecustomerchanged itsmind),thenclickthatgreenlabel.Thecolorofthelabelbecomesyellowandyoucanswipethecardagain.

51 QMerchantManual

September14,2017

QMERCHANTMENUENTRIESTools

Settings Opensthesettingsdialog

Backup/Restore Opensadialogtobackupand/orrestorethesettingsandthelogfiles.

VirtualTerminal OpentheVirtualTerminalfortransactionsoutsideofQuickBooks

GetTransactionfromQuickBooks Samefunctionasthe‘GetPayment’button.

PaymentGatewayVirtualTerminal OptionalmenutonavigatetoyourpaymentprovidersVirtualTerminal(availableforselect-edpaymentprovidersonly.Pleasecontactourhelpdesk.)

SetupWizard Re-Initializes all settings forQuickBooks and your payment provider. Currently this is sup-portedforauthorize.netonly.

Re-PrintReceipt Re-Printatransactionreceipt.

ExitQMerchant EndtheQMerchantprogramanddisconnectfromQuickBooks

Information

About OpenstheAboutdialog,whichdisplaytechnicalinformation.

Help OpensthisQMerchantGuide.

ViewSaleslog Displaythelistofsalesdone.

ViewApplicationlog Displaythetechnicalinformationlogfile.

ViewTransactionlog Displaythelistoftransactionsdone.

ViewSalesReceiptbyrefnumber QuickBooksPointofSaleonly.Retrievetransaction idandauthorizationcodeofa transac-tionreferencedbyareferencenumber.

TransactionReport Showsaformattedreportofthedailytransactions

SalesReport Showsaformattedreportofthedailysales

52 QMerchantManual

September14,2017

Support

CustomSettings Openthecustomsettingsdialog(onadviceoftheQMerchantsupportteamonly)

TestMSR Testamagneticstripereaderorcardreader.

ShowDataFolder Openthefolderlocation,whereQMerchantstoresitsdata.

ServerManagement (availableintheQMerchantServerversiononly)

LoginasAdmin LoginasadministratorforQMerchantserver

SetUserProfile SetprofileinformationforaQMerchantServeruser

GetUserProfile ReplaceprofileinformationforaQMerchantServeruser

License

PurchaseLicense PurchaseyouQMerchantlicense.

Activation AfterpurchaseyouwillreceiveanactivationcodeforQMerchant.Pleaseenterithere.

De-Activation Incaseyouaregoingtouseyouractivationcodeatadifferentcomputer,pleasedeactivateitherefirst.

ViewLicenseAgreement Readthesoftwarelicenseagreement.

53 QMerchantManual

September14,2017

THELOGFILEAlltransactionssendtoyourpaymentproviderarerecordedinadailylogfile.ThelogfilecanbeaccessedviatheDash-board.ItopensanInternetExplorerwiththefollowingcontent(similarforotherpaymentproviders):

ForPayTracethelogisasfollows:

54 QMerchantManual

September14,2017

TRANSACTIONTYPESANDOTHERCODESMostcommontransactionTypes

Whenworkingwithacreditcardtransactionprocessor,youcanspecifyseveraltransactiontypes:

AUTH_CAPTURE Thisisthemostcommontransactiontype.Itauthorizesthetransactionamountandcapturesthemoney

AUTH_ONLY Justauthorizetheamount.Itmustgetcaptureslateron.CAPTURE_ONLY Capturesapreviouslyauthorizedamount.(Needstheauth-codeortransactionid)VOID Cancelsanauthorization,voidsatransaction(Needstheauth-codeortransactionid)CREDIT Reimbursesthecreditcard(Forauthorize.Netonly)(Needstheauth-codeortransactionid)CREATE_SUBSCR Createasubscriptionforrecurringbilling.CANCEL_SUBSCR Cancelasubscriptionforrecurringbilling.

AVSCodes

A=Address(Street)matches,ZIPdoesnotB=AddressinformationnotprovidedforAVScheckE=AVSerrorG=Non-U.S.CardIssuingBankN=NoMatchonAddress(Street)orZIPP=AVSnotapplicableforthistransactionR=Retry–SystemunavailableortimedoutS=ServicenotsupportedbyissuerU=AddressinformationisunavailableW=9digitZIPmatches,Address(Street)doesnotX=Address(Street)and9digitZIPmatchY=Address(Street)and5digitZIPmatchZ=5digitZIPmatches,Address(Street)doesnot

CardCodeverificationCodes

M=MatchN=NoMatchP=NotProcessedS=shouldhavebeenpresentU=Issuerunabletoprocessrequest

55 QMerchantManual

September14,2017

PRINTRECEIPT

CHANGETHEPRINTRECEIPTThetemplateforprintreceiptislocatedintheapplicationdatafolderandisnamedprintreceipt.xsl.TheapplicationdatafoldercangetaccessedviatheAboutDialogwithaclickatthelink‘OpenApplicationDataFolder’

Openthefileprintreceipt.xslwiththenotepadeditorandeditthehighlightedlinesasfollows:

Pleaseplaceyourcompanyheaderinformationattheplacemarkedyellow.Youalsocanaddafooterlineattheplacemarkedyellow.Ifyouhavetohaveanewline,pleaseusethefollowingcharactersequence:
.Donotforgettosavethefile.

<xsl:stylesheetversion="1.0"xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:outputmethod="text"indent="no"omit-xml-declaration="yes"/><xsl:paramname="topMargin">20</xsl:param><xsl:paramname="leftMargin">10</xsl:param><xsl:paramname="firstTab">60</xsl:param><xsl:paramname="barCode">true</xsl:param><xsl:paramname="barFont">Free3of9Extended</xsl:param><xsl:paramname="barSize">48</xsl:param><xsl:paramname="barReference">//Reference</xsl:param><xsl:paramname="logoName">logo.jpg</xsl:param><xsl:templatematch="/|@*|node()"><xsl:comment>Placeyourcompanyheaderbelow</xsl:comment><xsl:comment><![CDATA[<LOGO>]]></xsl:comment><xsl:text></xsl:text><xsl:comment>YourCompanyheaderinthetextabove</xsl:comment><xsl:text>&#xd;&#xa;Receipt&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/PaymentType"/><xsl:text>&#xd;&#xa;Reference:</xsl:text><xsl:value-ofselect="Receipt/Reference"/><xsl:textxml:space="preserve"></xsl:text><xsl:value-ofselect="Receipt/Date"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/Description"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/NameOnCard"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/CardType"/><xsl:textxml:space="preserve">****</xsl:text>

56 QMerchantManual

September14,2017

<xsl:value-ofselect="substring(Receipt/CreditCard,string-length(Receipt/CreditCard)-3)"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:for-eachselect="Receipt/Items/SingleItem"><xsl:value-ofselect="ItemID"/><xsl:text>&#09;</xsl:text><xsl:value-ofselect="Description"/><xsl:text>&#09;</xsl:text><xsl:value-ofselect="Price"/><xsl:text>&#09;</xsl:text><xsl:value-ofselect="Quantity"/><xsl:text>&#09;</xsl:text><xsl:value-ofselect="Total"/><xsl:text></xsl:text></xsl:for-each><xsl:text></xsl:text><xsl:textxml:space="preserve">Subtotal:&#09;</xsl:text><xsl:value-ofselect="Receipt/Subtotal"/><xsl:textxml:space="preserve">&#xd;&#xa;Tax:&#09;</xsl:text><xsl:value-ofselect="Receipt/Tax"/><xsl:textxml:space="preserve">&#xd;&#xa;Total:&#09;</xsl:text><xsl:value-ofselect="Receipt/Total"/><xsl:text>&#xd;&#xa;&#xd;&#xa;</xsl:text><xsl:iftest="Receipt/PaymentType='RECURRINGBILLING'"><xsl:text>RecurringBilling&#xd;&#xa;</xsl:text><xsl:textxml:space="preserve">Rate:&#09;</xsl:text><xsl:value-ofselect="Receipt/ARBRate"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:textxml:space="preserve">Start:&#09;</xsl:text><xsl:value-ofselect="Receipt/ARBStart"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:textxml:space="preserve">Interval:&#09;</xsl:text><xsl:value-ofselect="Receipt/ARBIntv"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:textxml:space="preserve">Times:&#09;</xsl:text><xsl:value-ofselect="Receipt/ARBMaxOccurrence"/><xsl:text>&#xd;&#xa;</xsl:text></xsl:if><xsl:text>&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/Processor"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:value-ofselect="Receipt/TxType"/><xsl:textxml:space="preserve">&#xd;&#xa;AuthCode:&#09;</xsl:text><xsl:value-ofselect="Receipt/Authorization"/><xsl:textxml:space="preserve">&#xd;&#xa;Transaction-ID:&#09;</xsl:text><xsl:value-ofselect="Receipt/TransactionID"/><xsl:text>&#xd;&#xa;</xsl:text><xsl:text>&#xd;&#xa;&#xd;&#xa;&#xd;&#xa;&#xd;&#xa;................................................</xsl:text><xsl:text>&#xd;&#xa;Signature&#xd;&#xa;&#xd;&#xa;</xsl:text><xsl:comment><![CDATA[<BARCODE>]]></xsl:comment><xsl:comment>Placeyourcompanyfooterbelow</xsl:comment><xsl:text></xsl:text><xsl:comment>YourCompanyfooterinthetextabove</xsl:comment><xsl:comment><![CDATA[<PAGEBREAK>]]></xsl:comment><xsl:comment>Possiblyanotherpage</xsl:comment></xsl:template></xsl:stylesheet>

57 QMerchantManual

September14,2017

BARCODEPRINTINGBydefaultbarcodeprintingisswitchedoff.Toenableit,pleasedothefollowing:

1. ChangethebarCodeparameterintheprintreceipt.xslfileto“true”(Itismarkedblueinthelistingabove)2. Printingisdonebyaspecialfont.Itisnamed“Free3of9extended”.ThisfontisdeliveredwitheachQMerchant

distribution,butnotinstalledautomatically.Pleasegotothesamelocationwheretheprintreceipt.xslfileisanddouble-clickthefileFRE3OF9X.tff.Thiswillinstallthefont.

3. Bydefaultthereferencenumberofthetransactionisbarcoded.4. Tochangethebarcodesize,theinformationtobarcodeorthefonttype,pleasechangetheappropriateparame-

tersintheprintreceipt.xslfileorcontactaddQinsupport.5. Don’tforgettosavetheprintreceipt.xslfile.

RECEIPTFORMATTINGPARAMETERSANDCOMMANDSParameters:

topMargin Positionfromthetopofthepageinpoints(Default:20)leftMargin Positionfromtheleftinpoints(Default:10)firstTab Positionofthefirsttabinpoits(Default:60)barCode Printabarcode(Default:false)barSize Heightofthebarcodeinpoints(Default:48)barFont Fontusedforbarcodeprinting(Default:3FreeOf9Extended)barReference Contentofthebarcode(Default:Referencenumber)logoName Nameofthelogofile(Default:logo.jpg)

Commands:

<![CDATA[<BARCODE>]]> Placeholderforthebarcodeposition<![CDATA[<PAGEBREAK>]]> Continueprintingatanewpage<![CDATA[<LOGO>]]> Placeholderforlogoatthetopofthereceipt

SpecialCharacters:

&#xd;&#xa; Newline(Linefeedandcarriagereturn)&#09; Tabcharacter

58 QMerchantManual

September14,2017

RE-PRINTARECEIPT.Choosethisfunction,ifyouneedanoldprintreceiptorincaseyouforgottoprintthecurrentreceipt.

Selectthedateofthetransaction.Thenenteroneofthefollowing:

• transactionid• authorizationcode• amountofthetransactionor• reference

Ifyoudonotknowoneofthosevalues,pleaseopenfromtheReportsmenuthesalesreportandcheckoutthetransac-tionid.Afterwardsyouwillseetheprintdialogand/oryoucanprintthereceipt.

59 QMerchantManual

September14,2017

CUSTOMSETTINGSThesesettingscontrolinsomeaspectshowQMerchantbehaves.Pleasechangethosesettingsonadvicebyoursupportteamonly,sincewrongsettingsseriouslyinfluencethewayQMerchantoperates.

Thedescriptionofthesettingsisasfollows:

Name Default Comment

AcceptPendingTransactions False WhensettotruependingtransactionsfromQuickBooksarealsoselectedforpayment.Bydefaultthoseareignored.

allowShortCuts False Allowsshortcutsinthepaymentwindow.Implementedshortcutsare:Alt-C=CloseWindowAlt-S=SubmitTransactionAlt-P=PrintReceipt

AlternateTxType Valid transaction type as alternate to the defaults. I.e.AUTH_ONLYinsteadofAUTH_CAPTURE.

AlwaysShowTxDialog True Alwaysshowaselecttransactiondialog.IfsettoFalse,thedialogissuppressedifonlyonetransactionisavailable.

AppDirectory Locationofapplicationdatafolder.

ARForPayment AR-Account name in QuickBooks (without the numbers) whereto place the received payment. By default it is placed into ‘Ac-countsReceivable’.

AutoApplyRPayment True Applies an automatic receive payment automatically by Quick-Books if the payment cannot be applied to the original invoice

60 QMerchantManual

September14,2017

transaction.

autoClosePayment False Automaticallyclosethepaymentdialogafterasuccessfultrans-action.

autoCloseTxDialog False Automaticallyclosethetransactionselectiondialog.

AutoPrint Automatically (Auto) print a receipt after a successful transac-tion.

CCExpDateFieldName CCExpDate Name of custom field that contains the credit card expirationdate

ccFormLocation 150,150 Screenlocationofthepaymentform

CCNumberFieldName CCNumber Nameofcustomfieldthatcontainsthecreditcardnumber.De-faultistheuseoftheaccountnumberofthecustomerpaymentinfo.

CheckFields True Checkthefieldforplausibilitybeforesubmittingatransactions

CIMEnabled False Ifsettotrueusesauthorize.netCIMforpayments.

CIMValidate none ValidationcodeforCIMtransactions

ColorTransactions True Showgreencoloriftransactionhasvalidcreditcardcredentials.

CountryList Comma separated list of countries placed before the commonlist.WerecommendthatyoualsoaddthecountryISOcode.Thesyntaxisafollows:USA;US,Canada;CA…

Firstcomesthenameyouliketoseeinthelistandthenseparat-edbysemicolonthetwocharacterISOcode.

CustBankAccount BankAccount NameoftheQuickBooksadditional fieldthatholdsthecustom-er’sbankaccountnumber.

CustBankName BankName NameoftheQuickBooksadditional fieldthatholdsthecustom-er’sbankname.

CustBankRouting BankRouting NameoftheQuickBooksadditional fieldthatholdsthecustom-er’sbankroutingnumber(ABA).

Debug False RecordallmessagestoandfromQuickBooks.

DefaultTxType AUTH_CAPTURE DefaultTransactiontype.UsuallyAUTH_CAPTURE.

DepositPaymentTo Deposit-Account name in QuickBooks (without the numbers)wheretoplacethereceivedpayment.Bydefaultitisplacedinto‘UndepositedFunds’.

61 QMerchantManual

September14,2017

DutyItemNames Duty ListofthenamesoftheQuickBooksitemsspecifyingduties.Thisisusedtospecifyashipmentamounttothepaymentgateway.

EditMode False Makeitemlistandamountseditable.

EnableBatch False Allows the simultaneous processing of multiple credit cardcharges

forceCCV False Forcetheentryofthecard’sCCVcode

ForceQBXMLVersion False Internaluseonly.

forceZip False ForcetheentryofaZIPcodeinthecustomerbillingarea

getCCfromParent False Get credit card information from the parent customer in casethereisnoinformationatthejob.

hideWinControlBox False HideWindowsControlboxes

IgnoreQBDSubtotal False Ignores in the item lines an item that contains ‘Subtotal’ in itsname.

ignoreReversed True Point-of-Saleonly.Don’tshowreveredtransactions.

InstalledVersion n/a Internaluseonly.

InvoiceFilterbyTerm Placethenameofthetermincaseyou liketofilter invoicesbyterm. This field is case sensitive. If youwant to switch off thisfilter,removereplacetheentrywithblanks.

Itemized False Iftruesendsitemizedtransactionstoauthorize.net.ForPayTraceitsendsLevel3informationtothepaymentgateway.

L3 False EnableLevel3transactionsforPayTraceandSecureNet

L3SourceZip ZipcodeofthemerchantforLevel3processing

LicenseRead Internaluseonly.

mainFormLocation 100,100 Screenlocationofthemainform.

MaskCCNumber True Maskscreditcardandbankaccountnumbersinreports.

MaxReturnedQueryResults 50 NumberofreturnedresultsforaqueryagainstQB.

ModifiedMinutesBack1 2 Numberofminutessearchedbackbythe‘GetPayment’button

ModifiedMinutesBack2 15 Alternate number of minutes searched back by the ‘Get Pay-ment’button

MSR NameofMSRtype(Keyboard,COM,USB)

62 QMerchantManual

September14,2017

MsrASynch True UseMagneticCardReadertoasynchronousmode.

MSRClose True

MsrOverlap False

MsrTimeout 30000 TimeoutforsynchronousMSRoperations

multipleMerchantAccounts False Supportofmultiplemerchantaccounts.

PrintCopies 1 Numberofprintreceiptcopies

Printer Nameofreceiptprinter

PrintPreview False Showpreviewbeforeprinting

QBDLaunchMode 1 QuickBooksconnectionmode.

QBPOSConnection SetsthePoint-of-Saleservertoaspecificdatabase.Themustbeasshowninthefollowingsample:

ComputerName=QUAD;CompanyData=TestPOS;Version=10

QBVersion n/a Internaluseonly.

QBXMLVersion “2.0” MinimumQuickBooksversion

QuickMode False Showabbreviatedpaymentscreen.

RefundForLinkedTransactionsOnly

True Querycreditmemosandrefundforpreviouscreditcardtransac-tionsonly.

RemoveItemAfterProcess True Removesasuccessfullyprocessedtransaction fromthe transac-tionselectiondialog.

sc_Close C Closeawindow(Alt-C)

sc_GetPayment G Openthepaymentdialog(Alt-G)

sc_GlobalGetPayment G Globalshortcuttoopenthepaymentscreen.(Alt-G)

sc_Process P Openthepaymentscreenfortheselectedtransaction(Alt-P)

sc_ReceiptPrint R Printthereceipt(Alt-R)

sc_SubmitTx S Submitthetransaction(Alt-S)

selSrFormLocation 120,120 Screenlocationtotransactionselectionform

SendEmailReceipt False If supported by the payment gateway, automatically send anemail receipt. Currently only authorize.net and PayTrace aresupported.

63 QMerchantManual

September14,2017

SetPaymentMethodForRP False SetapaymentmethodfornewreceivepaymentsinQuickBooks.Otherwiseapaymentmethodisignored.

ShipItemNames Shipping,Freight Listof thenamesof theQuickBooks items specifying shipment.Thisisusedtospecifyashipmentamounttothepaymentgate-way.

shouldUpdate True Internaluseonly

ShowBackToQBBtn False If set to true the ‘Back toQuickBooks’ button is always shown.OtherwiseQMerchantcontrolstheappearanceofthisbutton

ShowInTaskbar True Set toFalse ifQMerchantshall showup in the icontrayonly, ifminimized.

ShowProcessedTxAlso True Iftrue,showsallprocessedtransactionsalso.

TLS12 True EnableTLS12Security

TxConfirmationMsg False ConfirmationMessagebeforeatransactionisprocessed.

Trace False Records completemessages between QMerchant and the pay-mentprovider.

UpdateAppliedToTxn False Propagate the transaction id and authorization code to linkedtransactionsinQB.

UseSaveMemory True ReleaseUnusedMemory.

UseTrack 0 Magnetictracktouse.(0=automaticallyselected)

UseTxInfo False UsesinadditiontoPOSflagthetxinfo.db3databasetofilterpro-cessedtransactions.POSonly.

vPosUrl Theurlforthepaymentgatewayweb-basedvirtualterminal(.i.e.for authorize.net https://anet.vpos.authorize.net/). Please con-sultyourpaymentgatewayprovider.

64 QMerchantManual

September14,2017

REPORTSTransactionReport

SalesReport

65 QMerchantManual

September14,2017

ACTIVATIONWhenyoufirststartQMerchant,itworksautomaticallyinTestMode.Thisallowsyoutoplayaroundwiththesoftwareand become familiar. The only limitation in contrast to the activated product is that themaximum amount you canchargeislimitedto5.00.

ToswitchtoproductionmodeyouhavetopurchaseQMerchantfromhttp://www.addqin.com/QMerchant.Afterpur-chaseyouwillreceiveanactivationcode.Thiscodeisdisplayedafterpurchaseandisalsosendtoyouremailaddress.

Toactivate,pleaseselectinQMerchantfromthemenubarInformation,LicenseandthenActivation.

In thedialog, copy andpaste the activation code andpress ok.After the activationprocess finishedQMerchant re-starts.Thenopenthesettingsdialogandun-checkthetestmodecheckbox.Leavethesettingsdialogwithsave.

IfyouwouldliketouseQMerchantatadifferentcomputer,youcande-activatetheactivationcodeandactivateitattheothercomputeragain.Youalsocanresetyouractivationatthehelpdeskathttp://www.addqin.com/QMerchant

66 QMerchantManual

September14,2017

PAYMENTGATEWAYSQMerchanthasimplementedthefollowingpaymentgatewayfunctionality.Iffunctionalityismissingornotimplement-eddoesnotmeanthatthepaymentgatewaysdoesnotofferit.

Function

Authorize.net

PPIPaymover

PayTraceAuth_CaptureThisisthetypicalsale.Authorizethecardandcapturetheamount

! ! !CaptureOnlyCapturetheamountafteraspriorauthorization ! ! !AuthOnlyAuthorizetheamountandcapturelater ! ! !VoidVoidatransactionthatisnotsettled ! ! !CreditIssuearefund ! ! !Force_AuthForceanauthorization " ! "Force_SaleForceanauthorizationandacapture " ! "PriorAuthCaptureCapturetheamountafteraspriorauthorization ! " "PinDebitAuthorizeandcapturetheamountusingaPinbasedDebitCard

" ! "QueryQuerythestateofatransaction " ! "eCheckProcesscheckselectronically ! ! !RecurringBillingUsethepaymentgatewaysrecurringbilling ! " "CustomerInformationManagementUsethepaymentgatewayscustomermanagementsystem ! " "Level2transactionsSubmittransactionsaLevel2transactionsforbetterrates ! ! !Level3transactionsSubmittransactionsaLevel3transactionsforbetterrates " " !

67 QMerchantManual

September14,2017

AUTHORIZE.NETAPILOGINIDANDTRANSACTIONKEY

Pleaselog-intoyourmerchantaccountadministrationattheauthorize.netwebsite.ThennavigatetoSettingsandthenGeneralSecuritySettings.Choose‘APILoginIDandTransactionKey’.

YourAPILoginIDandTransactionKeyareuniquepiecesofinformationspecificallyassociatedwithyourpaymentgate-wayaccount.However,theAPILoginIDandTransactionKeyareNOTusedforloggingintotheMerchantInterface.The-setwovaluesareonlyrequiredwhensettingupanInternetconnectionbetweenyoure-commerceWebsiteandthepaymentgateway.TheyareusedbythepaymentgatewaytoauthenticatethatyouareauthorizedtosubmitWebsitetransactions.Transactionsthatcannotbeauthenticatedbythepaymentgatewayusingthesevaluesarerejected.

IMPORTANT:TheAPILoginIDandTransactionKeyprotectyourpaymentgatewayaccountfromunauthorizeduseandshouldnotbesharedwithanyone.BesuretostorethesevaluessecurelyonaserverseparatefromyourWebserverandchangetheTransactionKeyregularlytofurtherstrengthenthesecurityofyouraccount.

TocreateanAPILoginIDorTransactionKeyforthefirsttime:

Step1:TypeinyourSecretAnswer.YoushouldhaveconfiguredaSecretQuestionandSecretAnswerduringac-countactivation.Step2:ClickSubmittocontinueorclickCanceltocanceltheaction.TheAPILoginIDandTransactionKeygen-eratedforyourpaymentgatewayaccountappear.

OnceyouhaveinitiallycreatedyourAPILoginID,youmaynotchangeitintheMerchantInterface.TochangeyourAPILoginID,pleasecontactAuthorize.NetCustomerSupport.

IMPORTANT:TheAPILoginIDisdifferentthanyouruserloginID.YouruserloginIDallowsyoutologintoyourMer-chantInterfaceuseraccount.TheAPILoginIDgrantsamerchantaccesstosubmittransactionstothepaymentgate-way.

Youmayobtainanew,uniqueTransactionKeyonthispageasoftenasneeded.

Toobtainanewtransactionkey:

Step1:EnteryourSecretAnswer(theanswertoyourSecretQuestionconfiguredataccountsetup).Step2:Todisabletheoldtransactionkey,clickthecheckboxlabeledDisableOldTransactionKey.Note:IftheDisableOldTransactionKeycheckboxisnotselected,theoldtransactionkeywillautomaticallyex-pirein24hours.Step3:ClickSubmittocontinueorclickCanceltocanceltheaction.Yournewtransactionkeyisdisplayed.

68 QMerchantManual

September14,2017

TIPS

TESTYOURCONNECTIONTOTHEPAYMENTPROVIDER:StartQMerchantandmakesurethatyouhaveyourpaymentproviderselectedinthesettingsdialog.Makesurethatthetestmode ischecked.ThenfromtheToolsmenuselect ‘VirtualTerminal’.Fill ina totalamount;entersomedigitsascreditcardnumber.Addtheexpirationdateandpress‘Submit’.Ifyoucanconnecttoyourpaymentproviderthenyouwillreceiveanerrormessage,thateitheryouraccountisinvalidorthecreditcardnumberiswrongorso.Thisprovesthatyoucorrectlycanconnecttothepaymentproviderandsubmittransactions.

GETTHEQMERCHANTVERSIONANDSERIALNUMBERFromtheQMerchantmenubarselectInformationandthenAbout.IntheAboutdialogclicktheDetailsbutton.

69 QMerchantManual

September14,2017

TROUBLESHOOT

PrerequisitesCurrentMinimumPrerequisitesare:

• WindowsXP,WindowsVista,Windows7,Windows8• Microsoft.NetFramework4.0rev.5,• QuickBooks2004-2018Pro,Premiere,EnterpriseUSorCAversionor

QuickBooksPointofSale• Avalidmerchantpaymentprovideraccount.

HowdoIgetthetransactionkeyfromAuthorize.Net?

Openyourwebbrowserandnavigatetohttp://www.authorize.net.Login intoyouraccountandgototheAccountSettings. In thesection ‘SecuritySettings’ isa link to thetransactionkey.Followthat linkandacquirethetransactionkey.

IseethefollowingmessagefromAuthorize.Net

Theloginandpasswordinformationyouspecifiedisnotcorrect.YouwillfirstneedtologintoyourAuthorize.NetaccountandgotoSettings>APILoginIDandTransactionKey.ThereyouwillacquireyourAPILoginandyourTransactionKey.SimplyreplacetheloginandtransactionkeywithinQMerchantwithyourAPILoginandTransactionKey.

SupportedPaymentGateways:

Authorize.Net http://www.authorize.net

PayTrace http://www.paytrace.com

PPIPaymover http://www.ppipaymover.com

Ifyouhaveadifferentpaymentprovider,pleasecontactourhelpdesk.

HowcanIseetheauthorizationandtransactionidofasalesreceipt?

InQuickBooksDesktopversions,weaddedacustomfieldQ_Authorization.PleaseaddthistoyoursalesreceiptlayoutinQuickBooks.

70 QMerchantManual

September14,2017

InQuickBooksPointofsale,pleaseusethesaleshistorytogetthereferencenumberofthesale.Thenopenthemenuitem‘Viewsalesreceiptbyrefnumber’fromtheinformationmenuandenterthereferencenumber.Therequiredinformationisdisplayed.

CannotgetthecreditcardnumberfromQuickBooks

Theccnumberisshownas******…only.IntuitdoesnotallowanylongerretrievingthecreditcardnumbersstoredinQuickBooksinanun-maskedformat.So,whenweretrievethatnumber,itisshowninourpaymentdi-alogmasked,practicallyunusable.Tousethisnumberagain,youeitherhavetore-typeitorcopyandpasteitfromQuickBooks.

Tosolvethisproblemyoucanstorethecreditcardnumberatanotherplaceorinacustomfieldwiththecus-tomerinQuickBooks.Thatwayyoucanovercomethisrestriction.Itisaone-timecopyandpasteprocess.

1. YoucanusetheAccountNo.fieldofthecustomerpaymentinfo.IntheQMerchantcustomsettingspleaseenterasvalueintheCCNumberFieldNametheexpression//CustomerRet/AccountNumber.Thisisthede-fault.WerecommendthisbecauseyoustillhaveallpaymentinformationinQuickBooksatthesametab.

2. Useanadditionalorcustomfield:

Createforyourcustomeranadditionalorcustomfieldnamedi.e.CCNumber.Youhavetodefineitonlyonce.Itisautomaticallypropagatedtoallcustomers.Thencopyandpastethecreditcardnumberfromthecustomerpaymentinfointothenewfield.Leaveeverythingelselikeexpdateetc.attheQuickBookspaymentinfo.

TheninQMerchantselectfromthe'Information'menu'Support'andthen'CustomSettings'.OKthemessagebox.Inthefollowingdialog,thereisafieldnamedCCNumberFieldName.ClickinthecolumnrightoffthatnameandenterCCNumber(thenameofyourcustomfieldfromabove).Clickoktosaveit.

NowQMerchantwillgrabthecreditcardnumberfromthatcustomfield.

QuickBooksDesktopVersionsi.e.EnterpriseandWindows7

IcannotconnecttoQuickBooks.TypicallythisisaproblemwithnewerQuickBooksversionandWindowsac-countcontrol.Intuitrecommendsthefollowing:PleaseopeninWindowstheControlPanelandsearchforUAC.ItislocationintheActionCenter.ClickChangeUserAccountControlandscrollthesliderdowntonevernotify.ClosethedialogwithOK.Closeallcontrolpaneldialogs.AlsocloseallQMerchantwindows.ThenrestartQMer-chantandtrytoconnectagaintoQuickBooks.

QUICKBOOKSPOINT-OF-SALEVERSIONS

IcannotconnecttoQuickBooksPOS.ThismayhappenwitholderQuickBooksPOSversions.PleasedownloadandinstalltheQBMXLPOSRuntime,whichallowstheaccesstoQuickBooksPOSfromthefollowinglink:http://www.addqin.com/download/QBPOSSDKRuntimeInstaller.exe

HowcanIdisabletheintegratedQuickBooksmerchantservice?

QuickBooksPOSv.10andbelow:IntheCompanyPreferences|MerchantandGiftServices,pleaseremovetheMerchantNumber.NewerQuickBooksPOSversions:

71 QMerchantManual

September14,2017

ChooseFile>SetupInterview.ClickthePaymentstab.SelectNoandthenclickDone.

OtherQuickBooks versions (Pro, Premiere, Enterprise):Make sure the checkbox 'Process ... credit card pay-ment'isuncheckedallthetimewhenyousaveasalesreceipt,areceivepaymentoracreditmemo.

Errormessage‘Markettypeisinvalid.

IamtryingtouseQMerchantwithAuthorize.netforpayment.whenIprocessthepaymentIgetANerrormes-sage itsays ‘Markettype is invalid’.Authorize.nethastwotypesofaccounts:CP=CardPresentorCNP=CardnotPresent.Dependingonthetypeoftheaccountyoumust intheQMerchantsettingscheckorunchecktheCheckbox‘CPAccount’.CPAccountCheck=CP,CPAccountuncheck=CNP.Pleasereversethestateofthecheckbox.

IwanttochangetheQuickBooksversionIselectedduringinstallation.

DuringInstallationyoucanselectbetweenNone,QuickBooksPointofSaleandQuickBooksPro,PremiereorEn-terprise.Toreversethisdecision,pleasedothefollowing:StartQMerchant.FromtheToolsmenuselectSetupWizardandfollowtheinstructions.

Ifyouhaveanyquestionsorexperienceotherproblems,pleasevisitourhelpdeskathttp://www.addqin.com

72 QMerchantManual

September14,2017

APPENDIXA:SCREENSHOTSFORTHEUSEWITHQUICKBOOKSPOINT-OF-SALE(OLDERVERSIONS)Createasale.

Afteryoufinishedpressthe‘TakePayment’button.

SelectCreditCardasPayment.AdialogtoselecttheCreditCardtypeappears.Maketheappropriateselection.

73 QMerchantManual

September14,2017

Choosethepaymenttypeandreturntothepreviousscreen.

Press“SaveOnly”orSave&Print”.NowyouarefinishedwiththeQuickBookspartofthepayment.NavigatetotheQMerchantDashboardandpress“GetPayment”

74 QMerchantManual

September14,2017

ThesalesreceiptisrequestedfromQuickBooks–PointofSaleandpresentedasfollows:

Completetheyellowfieldseitherbyswipingacreditcardorbyenteringthemmanually.ThenPress‘Submit’totransferthedatatoyourpaymentprocessor.Aftercompletionyouseeamessageboxwiththeresult.DependingonyourQuickBooks–PointofSaleversion,QMerchantwilladdthetransactionidandtheauthorizationcodetothesalesreceiptinQuickBooksPOS.Youalsocanhardcopyareceiptwiththe‘Print’button.Haveinmind,thetransactionisrecordedinQuickBooks,eveniftheprocessingyourpaymentprocessorfails.So,youareresponsibletotakecorrectiveactions.

75 QMerchantManual

September14,2017

APPENDIXB:AUTHORIZE.NETRESPONSECODES(EXCERPTFROMAUTHORIZE.NETDOCUMENTATION)22Thistransactionhasbeendeclined.23Thistransactionhasbeendeclined.Thiscodeindicatesareferralresponse.24Thistransactionhasbeendeclined.Thecodereturnedfromtheprocessorindicatingthatthecardusedneedstobepickedup.35Avalidamountisrequired.Thevaluesubmittedintheamountfielddidnotpassvalidationforanumber.36Thecreditcardnumberisinvalid.37Thecreditcardexpirationdateisinvalid.Theformatofthedatesubmittedwasincorrect.38Thecreditcardhasexpired.3 11 A duplicate transaction has been submitted. A transactionwith identical amount and credit card infor-mationwassubmittedtwominutesprior.312Anauthorizationcodeisrequiredbutnotpresent.313ThemerchantLoginIDisinvalidortheaccountisinactive.315ThetransactionIDisinvalid.ThetransactionIDvalueisnon-numericorwasnotpresentforatransactionthatrequiresit(i.e.,VOID,PRIOR_AUTH_CAPTURE,andCREDIT).316Thetransactionwasnotfound.ThetransactionIDsentinwasproperlyformattedbutthegatewayhadnorecordofthetransaction.317Themerchantdoesnotacceptthistypeofcreditcard.Themerchantwasnotconfiguredtoacceptthecred-itcardsubmittedinthetransaction.319Anerroroccurredduringprocessing.Pleasetryagainin5minutes.320Anerroroccurredduringprocessing.Pleasetryagainin5minutes.321Anerroroccurredduringprocessing.Pleasetryagainin5minutes.322Anerroroccurredduringprocessing.Pleasetryagainin5minutes.323Anerroroccurredduringprocessing.Pleasetryagainin5minutes.325Anerroroccurredduringprocessing.Pleasetryagainin5minutes.326Anerroroccurredduringprocessing.Pleasetryagainin5minutes.227ThetransactionresultedinanAVSmismatch.Theaddressprovideddoesnotmatchbillingaddressofcard-holder.328Themerchantdoesnotacceptthistypeofcreditcard.TheMerchantIDattheprocessorwasnotconfig-uredtoacceptthiscardtype.330Theconfigurationwiththeprocessorisinvalid.CallMerchantServiceProvider.333FIELDcannotbeleftblank.ThewordFIELDwillbereplacedbyanactualfieldname.Thiserrorindicatesthatafieldthemerchantspecifiedasrequiredwasnotfilledin.334TheVITAL identificationnumbersare incorrect.CallMerchantServiceProvider.Themerchantwas incor-rectlysetupattheprocessor.335Anerroroccurredduringprocessing.CallMerchantServiceProvider.Themerchantwasincorrectlysetupattheprocessor.336Theauthorizationwasapproved,butsettlementfailed.337Thecreditcardnumberisinvalid.339Thesuppliedcurrencycodeiseitherinvalid,notsupported,notallowedforthismerchantordoesn’thaveanexchangerate.340Thistransactionmustbeencrypted.347Theamountrequestedforsettlementmaynotbegreaterthantheoriginalamountauthorized.Thisoccursifthemerchanttriestocapturefundsgreaterthantheamountoftheoriginalauthorization-onlytransaction.348Thisprocessordoesnotacceptpartialreversals.Themerchantattemptedtosettleforlessthantheorigi-nallyauthorizedamount.349Atransactionamountgreaterthan$99,999willnotbeaccepted.

76 QMerchantManual

September14,2017

350Thistransactionisawaitingsettlementandcannotberefunded.Creditsorrefundsmayonlybeperformedagainstsettledtransactions.Thetransactionagainstwhichthecredit/refundwassubmittedhasnotbeenset-tled,soacreditcannotbeissued.351Thesumofallcreditsagainstthistransactionisgreaterthantheoriginaltransactionamount.352Thetransactionwasauthorized,buttheclientcouldnotbenotified;thetransactionwillnotbesettled.354Thereferencedtransactiondoesnotmeetthecriteriaforissuingacredit.355Thesumofcreditsagainstthereferencedtransactionwouldexceedtheoriginaldebitamount.Thetransac-tionisrejectedifthesumofthiscreditandpriorcreditsexceedstheoriginaldebitamount.357Anerroroccurredinprocessing.Pleasetryagainin5minutes.358Anerroroccurredinprocessing.Pleasetryagainin5minutes.359Anerroroccurredinprocessing.Pleasetryagainin5minutes.360Anerroroccurredinprocessing.Pleasetryagainin5minutes.361Anerroroccurredinprocessing.Pleasetryagainin5minutes.362Anerroroccurredinprocessing.Pleasetryagainin5minutes.363Anerroroccurredinprocessing.Pleasetryagainin5minutes.366Thistransactioncannotbeacceptedforprocessing.Thetransactiondidnotmeetgatewaysecurityguide-lines.368Theversionparameterisinvalid.Thevaluesubmittedinx_cpversionwasinvalid.369Thetransactiontypeisinvalid.Thevaluesubmittedinx_typewasinvalid.370Thetransactionmethodisinvalid.Thevaluesubmittedinx_methodwasinvalid.3 72 The authorization code is invalid. The value submitted in x_auth_codewasmore than six characters inlength.374Thedutyamountisinvalid.Thevaluesubmittedinx_dutyfailedformatvalidation.375Thefreightamountisinvalid.Thevaluesubmittedinx_freightfailedformatvalidation.376Thetaxamountisinvalid.Thevaluesubmittedinx_taxfailedformatvalidation.378TheCardCode(CVV2/CVC2/CID)isinvalid.Thevaluesubmittedinx_card_codefailedformatvalidation.384Thedevicetypeisinvalid.Thevaluesubmittedinx_device_typedidnotmatchtheconfiguredvalue.385Themarkettypeisinvalid.Thevaluesubmittedinx_market_typedidnotmatchtheconfiguredvalue.386Theresponseformatisinvalid.Thevaluesubmittedinx_response_formatwasnotequalto“0”or“1.”387Thismarkettypeisnotsupported.388TheTrack1dataisinvalid.389TheTrack2dataisinvalid.390ACHtransactionscannotbeprocessed.ACHtransactionscannotbeprocessedbythecard-presentsystem.3103Thistransactioncannotbeaccepted.Avalidfingerprint,transactionkey,orpasswordisrequiredforthistransaction.3111Avalidbillingcountryisrequired.ThiscodeisapplicabletoWellsFargoSecureSourceSMmerchantsonly.3 112 A valid billing state/province is This code is applicable toWells Fargo required. SecureSourceSMmer-chantsonly.3120Anerroroccurredduringprocessing.Pleasetryagain.Thesystem-generatedvoidfortheoriginaltimedouttransactionfailed.(Theoriginaltransactiontimedoutwhilewaitingforaresponsefromtheauthorizer.)3121Anerroroccurredduringprocessing.Pleasetryagain.Thesystem-generatedvoidfortheoriginalerroredtransactionfailed.(Theoriginaltransactionexperiencedadatabaseerror.)3122Anerroroccurredduringprocessing.Pleasetryagain.Thesystem-generatedvoidfortheoriginalerroredtransactionfailed.(Theoriginaltransactionexperiencedaprocessingerror.)3123Thisaccounthasnotbeengiventhepermission(s)requiredforthisrequest.ThetransactionrequestmustincludetheAPILoginIDassociatedwiththepaymentgatewayaccount.2 127 The transaction resulted in an AVSmismatch. The address provided does notmatch billing address ofcardholder.Thesystem-generatedvoidfortheoriginalAVSrejectedtransactionfailed.3128Thistransactioncannotbeprocessed.Thecustomer’sfinancialinstitutiondoesnotcurrentlyallowtrans-actionsforthisaccount.

77 QMerchantManual

September14,2017

2 141 This transaction has been declined. The system-generated void for the original FraudScreen-rejectedtransactionfailed.2 145 This transaction has beendeclined. The system-generated void for the original card code-rejected andAVS-rejectedtransactionfailed.3152Thetransactionwasauthorized,buttheclientcouldnotbenotified;thetransactionwillnotbesettled.Thesystem-generatedvoidfortheoriginaltransactionfailed.Theresponsefortheoriginaltransactioncouldnotbecommunicatedtotheclient.2165Thistransactionhasbeendeclined.Thesystem-generatedvoidfortheoriginalcardcode-rejectedtransac-tionfailed.3170Anerroroccurredduringprocessing.Pleasecontactthemerchant.ConcordEFS–Provisioningatthepro-cessorhasnotbeencompleted.3171Anerroroccurredduringprocessing.Pleasecontactthemerchant.ConcordEFS–Thisrequestisinvalid.3172Anerroroccurredduringprocessing.Pleasecontactthemerchant.ConcordEFS–ThestoreIDisinvalid.3173Anerroroccurredduringprocessing.Pleasecontactthemerchant.ConcordEFS–Thestorekeyisinvalid.3174Thetransactiontypeisinvalid.Pleasecontactthemerchant.ConcordEFS–Thistransactiontypeisnotac-ceptedbytheprocessor.3175Theprocessordoesnotallowvoidingofcredits.ConcordEFS–Thistransactionisnotallowed.TheCon-cordEFSprocessingplatformdoesnotsupportvoidingcredittransactions.Pleasedebitthecreditcardinsteadofvoidingthecredit.3180Anerroroccurredduringprocessing.Pleasetryagain.Theprocessorresponseformatisinvalid.3181Anerroroccurredduringprocessing.Pleasetryagain.Thesystem-generatedvoidfortheoriginal invalidtransactionfailed.(Theoriginaltransactionincludedaninvalidprocessorresponseformat.)3185Thistransactioncannotbeprocessed.MerchantisnotconfiguredforVPOS.2 201 This transactionhas beendeclined. The expirationdate is invalid. This error code applies only tomer-chantsonFDCOmaha.2202Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thetransac-tiontypeisinvalid.2203Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thevaluesubmittedintheamountfieldisinvalid.2 204 This transactionhasbeendeclined. This error code applies only tomerchants on FDCOmaha. Thede-partmentcodeisinvalid.2205Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thevaluesubmittedinthemerchantnumberfieldisinvalid.2206Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Themer-chantisnotonfile.2207Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Themer-chantaccountisclosed.2208Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Themer-chantisnotonfile.2209Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Communica-tionwiththeprocessorcouldnotbeestablished.2210Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Themer-chanttypeisincorrect.2211Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thecard-holderisnotonfile.2212Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thebankconfigurationisnotonfile2213Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Themer-chantassessmentcodeisincorrect.2214Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thisfunc-tioniscurrentlyunavailable.

78 QMerchantManual

September14,2017

2 215 This transactionhasbeendeclined. This error code applies only tomerchants on FDCOmaha. Theen-cryptedPINfieldformatisinvalid.2216Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.TheATMtermIDisinvalid.2217Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thistransac-tionexperiencedageneralmessageformatproblem.2218This transactionhasbeendeclined. This error codeappliesonly tomerchantson FDCOmaha. ThePINblockformatorPINavailabilityvalueisinvalid.2219Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.TheETCvoidisunmatched.2220Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.TheprimaryCPUisnotavailable.2 221 This transaction has been declined. This error code applies only tomerchants on FDCOmaha. The SEnumberisinvalid.2222Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Duplicateauthrequest(fromINAS).2223Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Thistransac-tionexperiencedanunspecifiederror.2224Thistransactionhasbeendeclined.ThiserrorcodeappliesonlytomerchantsonFDCOmaha.Pleasere-enterthetransaction.