NetSuite <> Authorize.Net Integration as a SDF project that runs completely inside NetSuite that is available under the Apache License, Version 2.0 with Common Clause Version 1.0 license as part of the Cloud 1001, LLC Free & Open Suite Initiative.
Although our FAQ's makes this as clear as we can make it - it needs to be reiterated : THIS SOLUTION DOES NOT USE THE NetSuite Payment Gateway Plug-In, because it is not allowed to, per Oracle. This solution offers an approximation of credit card payment processing following the native NetSuite flow via the Authorize.Net payment gateway. While it uses only native NetSuite API calls inside of NetSuite - it is NOT a "NetSuite Payment Gateway" - and because of this there are some inherent limitations to it's functionality.
Here's a checklist and grades of things it does and does not do (version 3.1+):
- [A+] Allows for processing of authorizations or authorizations+captures created in an external webstore like Magento, Shopify, WooCommerce, BigCommerce, etc inside of NetSuite
- [A+] Allows for direct processing of authorizations or authorizations+captures inside of NetSuite on the appropriate transaction type following native card processing logic
- [A+] Provides VERY ROBUST batch settlement tracking and processing features making daily reconciliations and deposits simple and efficient while also making any discrepancies easy to spot and resolve
- [A+] Storage of card data using Authorize.Net CIM for PCI complaint tokens - no raw card data is preserved
- [A+] Allows multiple NetSuite subsidiaries each with their own Authorize.Net account / payment gateway
- [F] SuiteCommerce will not work with this solution because it is not a Gateway Plugin (besides, you should use a decent webstore anyhow - not SuiteCommerce)
- [F] NetSuite POS will not work with this solution because it is not a Gateway Plugin (additionally, should you really be running a product that calls itself a POS?)
- [D] Customer Center "self pay" has not been tested end to end tested - it can work - but the Customer Center implementation in NetSuite itself is so poor - the user experience is horrific and not suggested
- [F] The new(ish) "Pay Now" link functionality in NetSuite is not supported as that uses NetSuite Payment Instruments which is part of their Payment Gateway, which this is not part of
- [F] Hardware integration for swipes, dips or taps is not supported becasue NetSuite is a web based platform and that's just silly to expect
There is a PDF in the codebase that offers additional information about prerequisite components needed in your NetSuite account to support the installation. To enable these you will need to navigate in your NetSuite account, while in the Administrator role, to Setup > Company > Enable Features >> SuiteCloud and enable the following:
- Custom Records
- Client SuiteScript
- Server SuiteScript
- SuiteFlow
- Token-based Authentication
- SuiteCloud Development Framework (SDF)
You also need to install the NetSuite provided “SuiteCloud Development Integration” (bundle id 245955) by navigating to Customization > Suitebundler > Search & Install Bundles and searching for 245955. Validate the company name providing the result is "NetSuite Platform Solutions Group - SuiteCloud Development Integration" and then install the bundle.
After installing the above bundle, add the newly created "Developer" role to the user that is going to be installing the software AND use that role to issue the tokens for authentication that are required for the installation. You can get your token set on your main screen in NetSuite - lower left side - Manage Tokens. Select the SuiteCloud Development Integration, for the integration and then record your tokens in a safe place!
Install and configure a supported IDE per the NetSuite SDF (SuiteCloud Development Framework) configuration to allow you to push a SDF project including all scripts, custom fields, custom records and other configuration objects into your environment. While NetSuite offers different SuiteCloud Plugins for different IDE's, we STRONGLY recommend the use of WebStorm which offers a free 30 day trial is is far easier to use than the other options (this is the only IDE we will assist you with)
Here are some resources for this step - it's easier than it sounds!
SuiteCloud Development Framework: Installing the WebStorm IDE Plug-in for SDF
Super Helpful guide by Oracle
ALSO - while logged into your instance of NetSuite - open Help and search for the following phrase - the results walk you through how to install the plugin for the IDE you have chosen: "SuiteCloud IDE Plug-in" - NOTE: the documentation may be older / incorrect - the CORRECT URL for the SuiteCloud IDE Plugin is "https://system.netsuite.com/download/suitecloud-sdk/ideplugin/webstorm/latest/updatePlugins.xml", this is what you will enter into the WebStorm IDE for the new custom plugin repository
Once you have the SuiteCloud IDE Plug-in installed into your IDE (again we can't recommend Webstorm strongly enough over all the other options!), you can then configure the IDE Plugin to connect to NetSuite using the Account Management in the Plugin and enter the tokens for your user and the instance number of your account. (if you are installing into a NetSuite sandbox - and your sandbox ID is like 654321-sb1, the value in the configuration for Instance ID will be 654321_sb1. Change the "-" to an underscore "_")
Download the full directory structure into a NetSuite supported IDE (WebStorm) after configuring for connecting to you account (you can use git features for retrieving the code - but unless you are going to be actively developing against the code, it's usually easier if you are not familiar with git, to just download the whole project)
Deploy the code to your account.
- In the main navigation menu go to Cloud 1001 > SuiteAuthConnect > SuiteAuthConnect Configuration
- Follow the prompts!
All configuration of the connector is done from the Cloud 1001 menu in NetSuite, via SuiteAuthConnect > SuiteAuthConnect Configuration
All code is installed in SuiteScripts > openSuite > netsuite-authnet > sac
In that folder is a PDF that offers some older and a little outdated guidance on setup
One important step in that guide is the ability to obtain a free sandbox / test account from Authorize.Net - be sure to read that PDF (it's referenced in the PRE-Installation section as well)
Really wish we had a better answer here - but the folks at Oracle do not provide an "uninstall" for a SDF Configuration project like they do "bundles" - so to uninstall this you need to manually find all Custom Fields, Custom Records, Custom Lists, Scripts / Script Deployments with SuiteAuth or something like that in the name and manually delete them from your system. Then you can navigate to SuiteScripts in the file cabinet and delete the directory openSuite (if you have no other openSuite projects installed) or SuiteScripts > openSuite > sac if just SuiteAuthConnect is installed.
Cloud 1001, LLC provides this software for free under the above license and is the only consulting firm that you should pay to assist you with this software. That's the point of the license - to make it free to anyone to obtain, use and modify - for their OWN purposes... if another consulting group or individual is asking to be paid to in any way to modify or assist with this software - they are in violation of the license.
Feel free to reach out to us if you have any bugs!
If you need help installing, configuring or have other questions - we do provide pre-paid ad-hoc assistance for installation in 30 minute and 1 hour blocks. We WILL NOT log into your system - these are screen share sessions where you can use the time for anything you need.
3.2.x is LIVE and includes multi-subsidiary support, even better reconciliation tools and enhanced token entry for better AVS validation support! 3.1.x is LIVE and includes eCheck support (ACH) using Authorize.net, default payments by customer and sets the stage for "pay by link" logic to let people pay their invoices directly!
This readme is made pretty by https://stackedit.io