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  


This example shows you how to integrate a physical POS terminal with your online application using SignalR technology. SignalR allows your

...

ecommerce 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 IMPORTANT - An Albert Terminal is must already be connected and operating correctly in your environment.

...

Log into your CMS.

...

Navigate to Settings → Feature Management.

...

  1. In the CMS, navigate to SettingsFeature Management → Payment & Checkout

...

  1. → Terminal Payment. You can also search for Terminal Payment.

...


...

Click Configure.

...

  1. Image Added

  2. Toggle ON Terminal Payment, then click Configure.

  3. In Configuration Settings, toggle ON Enable Terminal Payment.

  4. Toggle ON Enable Terminal Payment and Enable Terminal Payment for Trade Docket.

...

  1. Or use the Overrides option to control what

...

  1. Roles will see the Terminal Payment option

...

  1. .

...

For instance, you may want to restrict the Terminal Payment for Trade Dockets to a select Role. In which case, you would click the Image Removed button and add in one or multiple roles that can use this functionality.

...

Click Save and Exit to effect your changes.

...

  1. Image Added

  2. To save your changes, click Save and Exit.
  3. Navigate to the Checkout Template:

...

  1. Content → Pages &

...

  1. Templates → Checkout.

...


  1. Find the Checkout Payment Options widget and click

...

  1. Edit. In our example, it is in the Step2 Zone.

...

  1. Image Added
  2. Select the Terminal Payments tab

...

  1. . TIP - If you don't see it, review Steps 2 to 6 to ensure you have enabled Terminal Payments. 
    Image Added

...

  1. 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.

...


  1. To define the text for the button users will click when selecting a SignalR client, e.g., a printer enabled to print orders/invoices in PDF format, add the SignalR Group Message Selector widget to

...

  1. the Checkout template. You don't have to add it to a specific zone

...

  1. . We will add ours to the Step2 zone.

...



  1. You don't have to change any options here for the functionality to work correctly. However, you may want to change

...

  1. Client Group Select Prompt

...

  1.  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.
  1. Image Added
  2. To edit more options, see: SignalR Group Message Selector widget help.

  3. To save your changes, click Save.

Test Albert Payment Terminal Functionality

You can test the set up by making a purchase on your website. 


  1. On your website, follow your standard procedures to purchase a product and head to

...

  1. checkout. 

...


  1. In the Payment section, you should see a new Terminal tab and your prompt to select the terminal. 
    Image Modified
  2. Ensure your Albert Terminal is turned on and connected to your provider.

...


  1. Click  Send Order to Terminal. 
    Image Modified
  2. A Payment Processing message will display. Follow any prompts on your terminal.
    Image Modified

  3. The system will display a Successful Order Confirmation message if the payment processes correctly.
    Image Modified
  4. Should the payment fail, you will receive a Payment Not Processed message.

...

  1.  You can click the View Cart link and retry your payment.
    Image Added



Additional Information

...

Additional Info
Info

We recommend testing this functionality in your staging site before taking it live.

Contact

CV Support

Commerce Vision if you want to configure this functionality for your

e-Commerce

site.


Multiexcerpt
hiddentrue
MultiExcerptNameAdditional Info

--




Ballpark Hours From CV (if opting for CV to complete self config component)
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

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


--

BPD

ONLY

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.
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
Multiexcerpt
hiddentrue
MultiExcerptNameFeatures List Headers

Macro Instructions for carrying Article Information through to Feature List

Minimum

Version

Requirements

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



Related help

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

...