Description: This article walks through how to create and issue an Authorization or Access Token for Lighthouse Transaction Manager (LTM).
Log into Lighthouse Transaction Manager as the Administrative User, navigate to the Settings tab and select API Settings. Select Add API to bring you to the below screen.
The screen above will appear and you will need to select the Vendor for which you are generating a token. This is the provider/developer of the interface you are using to process sales. Once the vendor has been selected, a list of their products will be displayed in the Application drop-down.
If you have not used the interface type or version before, you may need to speak to our Account Maintenance Group to have the version or build of the interface added to your list of GUIDs on the account. Otherwise, they can’t select the application name in the drop-down.
Note: For any Shift4 service such as 4Res or i4Go, you would select Shift4 Corporation as the vendor.
After having made your Vendor and Application selections, you will need to select which revenue center is going to be using this interface to process under the Merchant Selection. This is important as any transaction that is processed in the interface using this “key” will authorize and process under the merchant it was assigned to:
- API Type: This needs to be set as “Standard”. For now, there is only one option, but other options may become available later
- API Rules: These allow you to choose whether this "key" can be used for post-sales or refunds
- API Firewall Rules [Optional]: This is a way to restrict which IPs are able to process using this “key.” It is an added feature to further lock down processing terminals if wanted
- Auth Token Expires: If the auth token is not used to exchange for an Access Token within this time frame, the auth token will expire, preventing it from being exchanged. This does not apply to tokens that have exchanged or an Access Token
After the settings have been filled in and you hit submit, you will be provided an Auth/Access Token based on the interface in use. This "key" is to be provided to the interface for them to place into their software.
WARNING: Be sure to select Submit on this page! Selecting Cancel or "X" to close the window will delete the token you generated and render it useless. A new token would then need to be generated. Selecting Submit saves the value and makes it visible from the API Settings page.