Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
gateways:quickbooks [2019/08/04 22:09] marijagateways:quickbooks [2019/11/14 21:52] (current) – [Testing] adam
Line 3: Line 3:
  
 # Add the full name of the gateway after the colon below. # Add the full name of the gateway after the colon below.
-name            : Intuit Merchant Service for QuickBooks+name            : Intuit QuickBooks Payments
  
 # Supported Countries. Please use 2-character ISO Country Codes available at # Supported Countries. Please use 2-character ISO Country Codes available at
Line 12: Line 12:
 # Enter the FoxyCart versions where support was added or removed (if applicable). # Enter the FoxyCart versions where support was added or removed (if applicable).
 # Version numbers should include applicable decimals, such as "0.7.0" and not "070" # Version numbers should include applicable decimals, such as "0.7.0" and not "070"
-support-added   : 0.7.1+support-added   : 2.0
 support-removed :  support-removed : 
 supports-3dsecure: no supports-3dsecure: no
Line 22: Line 22:
  
  
-====== Intuit Merchant Services ====== +====== Intuit Quickbooks Payments ======
-===== Setting Up Intuit Merchant Services for FoxyCart ===== +
-==== Normal Instructions ==== +
-  - Click the following link to connect your account to ours (so we are allowed to send transactions on behalf of you). <wrap important>You have to use **these specific links below**.</wrap> The ''appid'' portion of the link is important. +
-    * For a live account: [[https://merchantaccount.quickbooks.com/j/sdkconnection?appid=300838968&sessionEnabled=false]] +
-    * For a test account: [[https://merchantaccount.ptc.quickbooks.com/j/sdkconnection?appid=183651237&sessionEnabled=false]] +
-    * {{ :gateways:intuit_login.png?direct&600 |}} +
-  - Log in using your appropriate (live or test) account. +
-    - If you get a message saying that your live account is not setup for this application then you need to exit and then relogin to your merchant account using this link: +
-    - [[https://merchantcenter.intuit.com/portal/portal/qbms/Init]] +
-    - Then click through the link for "Processing Information" under Account and switch the setting for "Process with Web Store" from Off to On.  This may incur an additional $9.95 to $19.95 fee per month on your account, see the intuit site for details on costs. +
-  - Create a new connection. {{ :gateways:intuit_create_new_connection.png?direct&600 |}} +
-  - If asked for your website URL (image below), you must put ''http://qbms.foxycart.com/''. (If you're setting up a test account, set it to ''http://testing.foxycart.com/'' instead.) {{ :gateways:intuit_enter_url.png?direct&600 |}} +
-  - Copy the Connection Ticket you are provided with and paste it in the "connection ticket" field on the payment gateways page of your Foxy admin (https://admin.foxycart.com/admin.php?ThisAction=EditPaymentGateway).  +
-  - Test. +
-==== Version 0.7.1 and lower ==== +
-If you're using a very old FoxyCart account, it's more difficult. But the good news is that you're //very very likely not// using FoxyCart v0.7.1 or prior. Check your store -> settings page to see. And if you are, just [[:static:upgrading|upgrade]] to 0.7.2. It's much easier than trying this approach below. +
-  - Enter the Application Login and Connection Ticket values from your Intuit Merchant Services account into your store's FoxyCart admin. +
-  - Test.+
  
-If that's not helpful, which it may very well not be, [[http://forum.foxycart.com/comments.php?DiscussionID=4703|post on this thread]] in our forums. Getting the application login and connection ticket values is actually not an easy thing to do. (Thanks to forum user opus13 for the walkthrough.) +===== Setting Up Quickbooks Payments for FoxyCart =====
-===== Testing ===== +
-==== Obtaining a Test Account ==== +
-=== Version 0.7.2 and higher === +
-Visit [[http://qbms.developer.intuit.com/0085_QuickBooks_Windows_SDK/qbms/0030_Get_Set_Up/3._Create_a_Test_Merchant_Account|this page]] and follow the instructions. Note that you only need to complete the step 3. +
-After you got a test account, connect it to ours using the [[#version_072_and_higher|instructions above]]. +
-=== Version 0.7.1 and lower === +
-Visit [[http://qbms.developer.intuit.com/sdk/qbms/Get_Set_Up|this page]] to get an instruction of how to obtain a test account.+
  
-==== Watching the test transactions ==== +  - Log in to your Foxy store administration, and proceed to the "payments" section
-Login [[https://merchantcenter.ptcfe.intuit.com/portal/authsec/portal/qbms/|here]] using your test account+  - For the payment set that you are looking to connect, enable the option labelled "Let customers pay with a Credit or Debit Card" if it isn't already 
-==== Test Card Numbers ==== +  - In the payment method dropdown, select "Intuit Quickbooks Payments" 
-According to [[http://qbms.developer.intuit.com/sdk/qbms/Get_Set_Up/5._Try_a_Test_Transaction|this link]] you're allowed to use the following test card numbers: +  - Click the "Connect to Quickbooks Payments" buttonThis will redirect you over to Quickbooks to log in to your account to authorize access for your Foxy store to the Quickbooks Payments API. 
-  * 4111111111111111 +  - After completing that process, Quickbooks will redirect you back to your Foxy store - and if you see a success message, then everything is good to go!
-  * 5105105105105100 +
-  * 5555555555554444 +
-  * 4222222222222 +
-  * 4012888888881881 +
-  * 378282246310005 +
-  * 378734493671000 +
-  * 38520000023237 +
-  * 6011111111111117 +
-===== Troubleshooting & Interpreting Response Codes ===== +
-Contact quickbooks for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>+
  
  
 +===== Testing =====
  
-===== Important Notes and Caveats ===== +For testing, your QuickBooks account should be provisioned automatically with a sandbox company you can use
-While testing checkoutin order to get the response you want just fill one of following values in 'First Name' field. Put space into 'Last Name' field (you cannot leave it blank since it's required).+
  
-==== Possible 'First Name' field's values and expected responses correspondingly: ====+If when trying to connect to QuickBooks using Test Servers you receive an error of "There is no sandbox companies found for the user", you'll need to review your account to create sandbox companies to utilise. You can do that from your QuickBooks account at this URL: https://developer.intuit.com/app/developer/sandbox, there is also some information about sandbox companies [[https://developer.intuit.com/app/developer/qbpayments/docs/develop/sandboxes#launch-a-sandbox|in their documentation here]]. 
 +===== Troubleshooting & Interpreting Response Codes ===== 
 +Contact quickbooks for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>
  
-__configid=10200_comm__ 
-An error occurred while communicating with the credit card processing gateway. 
- 
-__configid=10201_login__ 
-An error occurred during login to the processing gateway. 
- 
-__configid=10301_ccinvalid__ 
-This credit card account number is invalid. 
- 
-__configid=10400_insufffunds__ 
-This account does not have sufficient funds to process this transaction. 
- 
-__configid=10401_decline__ 
-The request to process this transaction has been declined. 
- 
-__configid=10403_acctinvalid__ 
-The merchant account information submitted is not recognized. 
- 
-__configid=10404_referral__ 
-This transaction has been declined, but can be approved by obtaining a Voice Authorization code from the card issuer. 
- 
-__configid=10405_void__ 
-An error occurred while attempting to void this transaction. 
- 
-__configid=10406_capture__ 
-An error occurred while processing the capture transaction. 
- 
-__configid=10500_general__ 
-A general error occurred at the credit card processing gateway. 
- 
- 
-==== "Authorization Error" message on checkout ==== 
-This error message is rather generic and doesn't really give much direction on how to fix it. Previously though, several users have found that when creating the connection ticket they hadn't used the link included in the documentation above. Ensure that you create the connection ticket using the links in step 1 above and that should fix this error. 
  
 ===== User Notes and Experiences ===== ===== User Notes and Experiences =====
 <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page. <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.
- 
-=== Three Hours on the Phone === 
- 
-From a user D.H.: 
- 
-<blockquote>I spent almost 3 hours on phone support with Intuit and the problems were clearly on their end. 
- 
-The only things I can think of on the Foxycart side that would have helped would be: 
-A. Display the Foxycart version number on the admin page somewhere. 
-B. Make it clear that despite what Intuit tells you, if you are using Foxycart v 0.7.2 or higher, you don't need to enter the Application Login. 
- 
-I did follow the instruction in your wiki for enabling Process with Web Store. And yet, Intuit kept insisting that my client's account wasn't authorized to use Web Store and that we needed to use Desktop. 
-C. Again, despite what Intuit tells you… But it seems odd to have to add instructions to your wiki based on incorrect information from Inuit support. 
- 
-Intuit also has some incorrect links on their site. I would follow their instructions exactly and not see on the screen what they were describing. They would come back 10 minutes later and say…. Oh that url has changed and the site is not updated, sorry… 
- 
-Another odd thing was that my client and I were both logged into his Intuit account using the same account login, and he was seeing different things than I was. 
-Some functions to create apps were erroring but were still executing. I ended up with about a dozen apps, some of which had id numbers some didn't. 
-None of them worked when I created a url: 
-''https://merchantaccount.quickbooks.com/j/sdkconnection?appid=[your app id]&sessionEnabled=false'' 
-The resulting page looked like the examples showing a connecting ticket but that part of the page was either missing or if that div was there the text box was empty. 
-</blockquote> 

Site Tools