Multiexcerpt |
---|
hidden | true |
---|
MultiExcerptName | Feature Title |
---|
|
Albert Terminal Payment Integration. |
Multiexcerpt |
---|
MultiExcerptName | Feature Overview |
---|
|
Extend the Point of Sale (POS) functionality of your website by connecting your online application to a physical in-store payment terminal. In this example, we show you how to integrate a physical POS terminal with your online application using SignalR technology. SignalR allows your e-Commerce system to push web content to connected clients in real-time; in this case, a CommBank Albert Payment Terminal to process payments. |
Step-by-step guide
These steps assume that an Albert Terminal is connected and operating correctly in your environment.
Log into your CMS.
Navigate to Settings → Feature Management.
Click on Payment & Checkout.
Locate Terminal Payment.
Click Configure.
Turn on the options: Enable Terminal Payment and Enable Terminal Payment for Trade Docket.
You can control what customers will see the Terminal Payment option by configuring Overrides.
For instance, you may want to restrict the Terminal Payment for Trade Dockets to a select Role. In which case, you would click the button and add in one or multiple roles that can use this functionality.
Click Save and Exit to effect your changes.
Navigate to the Checkout Template: Content → Pages & Templates → Checkout.
Locate the Checkout Payment Options widget and click to Edit. In our example, it is in the Step2 Zone.
You should see a Terminal Payments tab in the Checkout Payment Options widget. If you don't see it, review Steps 2 to 6 to ensure you have enabled Terminal Payments.
Although you don't need to alter any parameters within this tab for the Albert Terminal functionality to work, you may want to customise the messages.
We will add in the SignalR Group Message Selector widget to enable the selection of a terminal. You don't have to add it to a specific zone, but we will add ours to the Step2 zone.
You don't have to change any options here for the functionality to work correctly. However, you may want to change the 'Client Group Select Prompt' to something more meaningful. We've changed ours to reflect what the action will do: Select a Terminal.
You can also restrict the Layer and change the icon.
On the Notifications tab, you can also change the warning and error messages the system displays.
Save your changes.
We will now head over to your website and purchase a product to test the Albert Payment Terminal Functionality.
Follow your standard procedures to purchase a product and head to the checkout.
When you get to the payment area, you should see a new Terminal tab and your prompt to select the terminal.
Ensure your Albert Terminal is turned on and connected to your provider.
Click Send Order to Terminal.
A Payment Processing message will display. Follow any prompts on your terminal.
The system will display a Successful Order Confirmation message if the payment processes correctly.
Should the payment fail, you will receive a Payment Not Processed message.
You can click the View Cart link and retry your payment.
Multiexcerpt |
---|
MultiExcerptName | Additional Info |
---|
|
Info |
---|
We recommend testing this functionality in your staging site before taking it live. Contact CV Support if you want to configure this functionality for your e-Commerce site. |
|
Minimum Version Requirements |
Multiexcerpt |
---|
MultiExcerptName | Minimum Version Requirements |
---|
| 4.13.00 |
|
---|
Prerequisites |
Multiexcerpt |
---|
| POS Terminal and SignalR functionality configured and working. |
|
---|
Self Configurable |
Multiexcerpt |
---|
MultiExcerptName | Self Configurable |
---|
| No; needs API development; Contact CV Support for more information. |
|
---|
Business Function |
Multiexcerpt |
---|
MultiExcerptName | Business Function |
---|
| Payment Types |
|
---|
BPD Only? | |
---|
B2B/B2C/Both |
Multiexcerpt |
---|
MultiExcerptName | B2B/B2C/Both |
---|
| Both |
|
---|
Ballpark Hours From CV (if opting for CV to complete self config component) |
Multiexcerpt |
---|
MultiExcerptName | Ballpark Hours From CV (if opting for CV to complete self config component) |
---|
| Contact CV Support |
|
---|
Ballpark Hours From CV (in addition to any self config required) |
Multiexcerpt |
---|
MultiExcerptName | Ballpark Hours From CV (in addition to any self config required) |
---|
| Contact CV Support |
|
---|
Third Party Costs |
Multiexcerpt |
---|
MultiExcerptName | Third Party Costs |
---|
| Fees apply
|
|
---|
CMS Category |
Multiexcerpt |
---|
MultiExcerptName | CMS Category |
---|
| Content |
|
---|
Excerpt |
---|
|
API expectationsPrint Order Send { Data: { FileName: “file name string including website URL” }, MessageType: “PrintOrder”, ResponseToken: “secure string we require on a response” }
Response – Received We accept a response indicating the client has received our data sent, fields to be sent - the response token from the original request is required
- successful boolen
- additional message
Response – Processed We accept a response indicating the client has received our data sent, fields to be sent - the response token from the original request is required
- successful boolen
- additional message
- this will include the file name so that we can delete the file
|
Related articles
Content by Label |
---|
showLabels | false |
---|
max | 5 |
---|
spaces | KB |
---|
showSpace | false |
---|
sort | modified |
---|
reverse | true |
---|
type | page |
---|
cql | label = "how-to" and type = "page" and space = "KB" |
---|
labels | how-to |
---|
|
Multiexcerpt |
---|
hidden | true |
---|
MultiExcerptName | Features List Headers |
---|
|
Macro Instructions for carrying Article Information through to Feature ListMinimum Version Requirements | BPD ONLY
| Business Function | CMS Category | B2B B2C BOTH | Feature | Feature Description(Written for our customers and can be pasted into comms sent to them) | Additional info | Pre-Reqs/ Gotchas | Self Configurable | Ballpark Hours From CV(if opting for CV to complete self config component) | Ballpark Hours From CV(in addition to any self config required) | Third Party Costs |
---|
Instructions for carrying Excerpts through from this page to the Feature List Article Page: Add macro / Multiexcerpt (or copy and existing excerpt and edit) or (Copy existing page and place content into existing excerpt macros) On Features List page: Click in the Cell to be populated / add macro / Multiexcerpt Include / Select the Article page and the excerpt (or copy another feature line and edit the 'Article page' source. |