3rd Party Integration with swiftpos NetPOS
This outlines the information and the steps that are needed to familiarise oneself with the Blackhawk interface, prior to and during it's implementation.
The content is targeted at Resellers and swiftpos Venue Administrators who have a sound knowledge of and experience with swiftpos. For further information or assistance, please contact your swiftpos Reseller or swiftpos Support.
Subjects ▼
About ▲ ▼
- Available In?
- To Be Considered
- What is it?
- What Is Not Supported?
- What Is Required?
- What Is Supported?
- When Is It Used?
Available In? ▲ ▼
- SwiftPOS V10.53+
To Be Considered? ▲ ▼
- Blackhawk recommends that when POS Keys are configured for Refunds/Reversals/Voiding, these should ONLY be accessible by management staff. That is they appear to dissuade general POS Clerks/Staff Members to have access to Refunds/Reversals/Voiding functions that interface with Blackhawk.
Notes...
A POS Key is configured for Refunds/Reversals/Voiding when the Prompt for Original Reference ID option is selected here and/or here.
What Is It? ▲ ▼
Blackhawk is, amongst other services, a provider of:
- Branded Gift Cards in both a physical and digital format.
- Digital Accounts (also known as POR (PIN On Request) Products, allowing customers to top up accounts, subscriptions, phone plans, etc.
What Is Not Supported? ▲ ▼
- The ability to check the balance of Blackhawk provided Gift Cards.
- Redemption of Blackhawk provided Gift Cards.
What Is Required? ▲ ▼
- SwiftPOS V10.53+
- A NetPOS registration for Blackhawk.
- Ensure an authentication certificate has been obtained from Blackhawk, in the form of a certificate file and accompanying password, this will then need to be imported and installed on the computer running Back Office. To do this, do as follows:
- Referring to How To Import A Windows Authentication Certificate ensure the provided certificate is imported for both the Personal and Trusted Root Certification type certificates.
- Referring to How To Import A Windows Authentication Certificate ensure the provided certificate is imported for both the Personal and Trusted Root Certification type certificates.
- For those Venues also wishing to offer Blackhawk Products, in the form of POR (PIN On Request) Products or Digital Accounts, a list of Products will need to be requested from Blackhawk. These will generally be provided in the form of an email containing the Products, their Account Number, UPC (Product ID), Description and Denomination (Transaction Amount). Once obtained these can be added via the VAS Products Links menu option to ensure they are available to be searched/selected in Touch. Refer to How To Manage Blackhawk Products for more information.
What Is Supported? ▲ ▼
- Only one Product can be Activated at a time.
When Is It Used? ▲ ▼
Any swiftpos Venue that wants to integrate with Blackhawk and offer it's patrons, their Gift Cards (For example, Amazon, BCF, Ebay, JB HI-FI, Westfield, etc.) or to provide Digital Account services (For example, Accounts, Phone Plans, Subscriptions, etc) that are supported by Blackhawk.
How To ▲ ▼
- Get Started
- Access The NetPOS Menu?
- Import A Windows Authentication Certificate?
- Manage Blackhawk Products?
How To Get Started? ▲ ▼
Do as follows:
- Once the above requirements have been met, then the Blackhawk settings will need to be configured. To do this access the Blackhawk settings screen in NetPOS via the NetPOS Menu.
- Once the Blackhawk settings screen is displayed, configure as appropriate.
Add Blackhawk Provided Products ▲ ▼
- The Blackhawk Products obtained above will need to be added to Back Office. Refer to the How To Add A Blackhawk Product subject for more information.
Once the Blackhawk Products have been added, then Touch will need to be configured to ensure Blackhawk Gift Cards can be issued and topped up. To do this:
- Ensure the following POS Keys are added to the appropriate Keyboard Layout via the Designer:
- Ensure the POS Keys, added above, are configured appropriately to meet the Venue's requirements.
- Ensure a Full Update is sent to all Touch Terminals that make use of the same Keyboard Layout to which the above POS Keys were added.
Notes...
Refer to Add A POS Key To A Keyboard Layout for more information.
How To Manage Blackhawk Products? ▲ ▼
How To Activate A Product? ▲ ▼
Do as follows:
- In the VAS Products Links screen:
- Select the Location from the drop down list in the header section.
- Select the Blackhawk option from the VAS Type drop down list in the header section.
- Select one of the Inactive Products listed. A Product is considered Inactive when it does not have a value displayed in the Active column.
- Select the Activate Item button.
- Once activated, the text Active will be displayed in the Active column against the selected Product.
Notes ...
Only one Product can be Activated at a time.
Do as follows:
- In the VAS Products Links screen:
- Select the Location from the drop down list in the header section.
- Select the Blackhawk option from the VAS Type drop down list in the header section.
- For each of the Products provided by Blackhawk, do as follows:
- Select the Add Blackhawk Product option from the Add/Import Items button.
- In the Add/Edit Blackhawk Product screen enter the details of the Product provided by Blackhawk and select OK.
- The Product will be added to the grid in the VAS Products Links screen.
- Select the newly added Product and select the Activate Item button to set the Product as Active. This will ensure the Product can be searched/selected in Touch using the Top Up 3rd Party Account (#244) POS Key.
How To Deactivate A Product? ▲ ▼
Do as follows:
- In the VAS Products Links screen:
- Select the Location from the drop down list in the header section.
- Select the Blackhawk option from the VAS Type drop down list in the header section.
- Select one or more active Products listed. A Product is considered active when the text Active is displayed in the Active column.
- Select the Deactivate Item option from the Delete button.
- Once deactivated, no value will be displayed in the Active column against the selected Product(s).
Notes ...
One or more Products can be Deactivated at a time.
Do as follows:
- In the VAS Products Links screen:
- Select the Location from the drop down list in the header section.
- Select the Blackhawk option from the VAS Type drop down list in the header section.
- Select one or more Products listed. Both an Active and Inactive Product can be deleted.
- Select the Delete Products option from the Delete button.
- Once deleted the Product(s) deleted will no longer be displayed in the grid.
Notes ...
One or more Products can be Deleted at a time.
Do as follows:
- In the VAS Products Links screen:
- Select the Location from the drop down list in the header section.
- Select the Blackhawk option from the VAS Type drop down list in the header section.
- Select one of the Blackhawk Products listed and select the Edit button.
- In the Add/Edit Blackhawk Product screen change the details as required and select OK.
Screens ▲ ▼
NetPOS Settings Screen ▲ ▼
To access refer to How To Access The NetPOS Menu. A NetPOS Registration for the Blackhawk Interface will be required in order to access this screen. Used to configure the settings required to implement the Blackhawk Interface.
Header Section
- Access Code - Default is blank. Displays/Enter the Access Code that must match the same Access Code configured at the swiftpos Touch terminal. This is not mandatory, but does provide an additional level of security.
- Service URL - Displays/Enter the URL provided by Blackhawk.
- Certificate Authentication - Select to select from the drop down list the Authentication Certificate provided by Blackhawk and imported, For more information regarding the importing and installing of certificates, refer to the What Is Required? section above.
- Back Office Interface - Select from the drop down list the Back Office instance to connect with.
Notes ...
In general this will only have one instance listed. However, multiple Back Office instances can be listed, in which case one needs to be selected.
- Refresh Locations - Select to ensure the list of Locations displayed in the grid is refreshed with the latest Locations currently available.
Grid Section
Displays a list of the Locations, their StoreID and MID details. These values are provided by Blackhawk and will need to be populated opposite each of the Locations that will require access to the Blackhawk Interface.
- Store ID - Displays/Enter the value as provided by Blackhawk.
- MID - Displays/Enter the value as provided by Blackhawk.
End of article. ▲