Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title

Albert Terminal Payment Integration.


Multiexcerpt
MultiExcerptNameFeature 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.

  1. Log into your CMS.
  2. Navigate to Settings → Feature Management.
  3. Click on Payment & Checkout.
  4. Locate Terminal Payment.          
  5. Click Configure.
  6. Turn on the options: Enable Terminal Payment and Enable Terminal Payment for Trade Docket. 
  7. You can control what customers will see the Terminal Payment option by configuring Overrides.
  8. 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.
  9. Click Save and Exit to effect your changes.
  10. Navigate to the Checkout Template: Content → Pages & Templates → Checkout.
  11. Locate the Checkout Payment Options widget and click to Edit. In our example, it is in the Step2 Zone.
  12. 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. 
  13. 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.
  14. 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.
  15. 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.
  16. You can also restrict the Layer and change the icon. 
  17. On the Notifications tab, you can also change the warning and error messages the system displays.
  18. Save your changes.
  19. We will now head over to your website and purchase a product to test the Albert Payment Terminal Functionality.
  20. Follow your standard procedures to purchase a product and head to the checkout. 
  21. When you get to the payment area, you should see a new Terminal tab and your prompt to select the terminal. 
  22. Ensure your Albert Terminal is turned on and connected to your provider.
  23. Click Send Order to Terminal.
  24. A Payment Processing message will display. Follow any prompts on your terminal.
  25. The system will display a Successful Order Confirmation message if the payment processes correctly.
  26. Should the payment fail, you will receive a Payment Not Processed message.
  27. You can click the View Cart link and retry your payment.




Additional Information


Multiexcerpt
MultiExcerptNameAdditional 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
MultiExcerptNameMinimum Version Requirements

4.13.00


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

POS Terminal and SignalR functionality configured and working.


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

No; needs API development; Contact CV Support for more information.


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

Payment Types


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both

Both


Ballpark Hours From CV (if opting for CV to complete self config component)


Multiexcerpt
MultiExcerptNameBallpark 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
MultiExcerptNameBallpark Hours From CV (in addition to any self config required)

Contact CV Support


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

Fees apply


CMS Category


Multiexcerpt
MultiExcerptNameCMS Category

 Content



Excerpt
hiddentrue

API expectations

Print 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

Content by Label
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "how-to" and type = "page" and space = "KB"
labelshow-to


Multiexcerpt
hiddentrue
MultiExcerptNameFeatures List Headers

Macro Instructions for carrying Article Information through to Feature List

Minimum

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.