Versions Compared

Key

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


Info
iconfalse
titleIs this feature disabled?


Image Added This feature needs to be switched on for your site by Commerce Vision. 

  • This is for use with the integrated Eway Payment  (4.19+) or Braintree Payments (4.31+) gateways.
  • Settings can only be configured by your site's CMS administrators. 
  • Verification is not applicable for invoice payments.


Overview

Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title


Excerpt
hiddentrue

Configure

...

Prerequisites

...

settings for the system's built-in credit card verification security feature. (For Eway and Braintree Payments.) 


If your website uses the Eway or Braintree Payments gateway to process credit card transactions at checkout, its builtin Credit Card Verification can be added as an extra security check on a card's first use. (For Braintree Payments, cards used through Google Pay and Apple Pay are also included.) When enabled, the system will undercharge the card by a random nominal amount. The order remains 'pending' until the buyer confirms the actual charged amount. Processes at each stage of verification are automated so minimal handling and attention are needed from your staff. But an order's verification status can easily be tracked and changed in the CMS manually when required. 


Excerpt
hiddentrue

Configure settings for the system's built-in credit card verification security feature. (For Eway and Braintree Payments.) 




Multiexcerpt
hiddentrue
MultiExcerptNameFeature Overview

...

We have expanded the capabilities of CMS administrators by enabling them to configure Credit Card Verification Feature Settings. With Credit Card Verification, when new customers or users make purchases over the user-defined threshold, then the system will hold the order until the user verifies credit card ownership.

For sites that use the Eway or Braintree Payments gateway. this Credit Card Verification adds another security check for orders with new credit cards

Here is how Credit Card Verification works:

  1. When guest users and registered Users or Customers Orders (depending on settings) place orders above a set threshold amount with credit cards never used before, they must acknowledge that they may be subjected to an additional security check.
    Image Added
  2. When they submit their order, they are alerted that the order is 'pending' until they correctly enter the actual undercharged amount. This can be retrieved from their credit card account. (Note - The legacy 'split charge' method is also available but is no longer supported by Commerce Vision.) 
  3. They will also receive an 'order pending' confirmation email, which includes instructions on how to verify the card. 
  4. They return to your site to enter the charged amount in the verification page.
  5. If verification is successful, the system will release the order for fulfilment. If not, it will be cancelled. 

For more details, see: From your customer's perspective.





Panel

On this page:

Table of Contents




Note
titleNotes
  • For registered Users/Customers: (i) when a credit card has been successfully verified, subsequent use of the card will not trigger another security checks; (ii) multiple orders 'pending' against the same credit card will all be released upon successful verification through one of these orders.
  • Guest orders over the threshold amount will trigger the verification process even when the credit card has been used before (unless the guest makes multiple purchases in the same browser session).
  • CMS users (depending on Role) can track and manage orders undergoing this verification process through the Credit Card Verification page.
  • Two modes are available: 'immediate order integration' ON or OFF. See 'Edit Settings' below for details about each one.

Step-by-step

...

guide 

1.

...

Edit settings 

Note - you must be a CMS Administrator to configure Credit Card Verification settings. 

  1. In CMS, navigate to Settings → Feature Management → Payment & Checkout.

...


  1. Toggle ON Credit Card Verification and click Configure.   

    Image Modified

...


  1. In the Credit Card Verification page, toggle ON Enable Credit Card Verification.
    Image Modified

...


  1. Accept the default field values or

...

  1. change them to match your business requirements. 

  2. Next, we need to ensure orders are canceled that have expired credit card verifications, navigate to Advanced Settings → Scheduled Tasks 

    Info
    titleMy scheduled task menu item isn't available?

    Please reach out to our to your contact at CV if you aren't able to access the scheduled task page


  3. Click New to create a new scheduled task
  4. Under Task, select the CreditCardVerification option
    Image Added

  5. Set the task Schedule and hit Save


OptionDefault ValueDescriptionOverride Available?
Enable

...

Immediate Order IntegrationOFF

OFF:  the verification process for the order is completed online in CMS. Integration to the ERP occurs only after the verification process is over. The order status of 'pending' is in CMS only. 

ON: the system will integrate the order to the ERP before the verification process is initiated. The order has the status 'pending' on your website and in your ERP. 

The ON option provides the following business efficiencies during the verification process period:

  • stock status - items are committed to the 'pending' order and are marked unavailable in your ERP so they cannot be offered for other purchases, online and offline,
  • multiple orders - when a credit card is verified, all remaining pending orders on that credit card are automatically confirmed and moved to the next step of the order processing.
  • cash receipt issue - cash receipts are written at the time of integration and can be reconciled more easily with your customer's credit card payment since they occur on the same day 


Role level
Attempts Allowed3

The number of times

...

a user

...

can

...

try to enter a correct amount charged to their credit card before the order is cancelled.


Role level
Percentage Split (of the order amount)85

Applies to the Split Charge method only. The system will split the total order amount

...

into two charge amounts (with the first split equalling this value +/- the Credit Card Verification Percentage Variant)

...

. One of the two split charge amounts is entered to verify credit card ownership.

  

Role level
Threshold Order Amount250.00

The system will

...

put orders over this amount

...

on hold ('pending') until credit card ownership is verified.


Role level
Days to Hold Order45

...

The the number of days an order remains open

...

for the user

...

to validate the credit card. 


Role level
Usage TypeCustomer

...

Credit Card Verification

...

is set against the

...

User's login or

...

the Customer.


Role level
Verification MethodShortCharge

The charge method used. ShortCharge or SplitCharge (NOTE - SplitCharge is a legacy method that is available but no longer supported.)

Short Charge - the system charges the credit card once. The amount charged is the total order amount minus a random amount under the value entered in the 'Max Short Charge Amount' field. The user verifies by entering this actual charged amount.

  • The 'Short Charge' method has the advantage of being a single charge with the issuance of one cash receipt. This streamlines the reconciliation of credit card charge with cash receipt for your business and customers, and minimises the number of reversals if these are needed.  

Split Charge (legacy method) - the system charges the credit card twice in accordance with the 'Percentage Split' previously entered. They appear as two separate charges with two cash receipts. One of these charged amounts must be entered to verify credit card ownership.  

Role level
Days Before Initial Reminder Email2

...

The number of days an initial reminder email is sent after order placement if the customer has not verified the credit card. 



Days Before Subsequent Reminder Email7

...

The number of days after the initial reminder email a follow-up reminder email is sent if the customer still has not verified the credit card.



Notification EmailBlank

...

(Used only when 'Enable Immediate Order Integration' is OFF.) The email address to which the system sends notifications of failed verification attempts and order cancellations when maximum verification attempts have been reached.



Online Team EmailBlank

(Used only when 'Enable Immediate Order Integration' is OFF.) The email address to which the system

...

5.       You can configure overrides at the role level for the marked options by clicking the Overrides button.

Image Removed

...

sends copies of emails received by the purchaser, i.e., order pending and order confirmation emails.

Role level
Order Integration Order Status17

This value represents the order status 'pending'. If the 'enable immediate integration' is on, this value represents the order status of 'pending' but unintegrated in the ERP.  If your ERP uses a different number, you can change this value. 


Short Charge Settings

Max Short Charge Amount

$1.00

Applies to the 'ShortCharge' method only. The maximum amount the system can undercharge an order total. 


2. Add Overrides (optional)

An override allows you to specify an exception to a global setting for a certain feature. For Credit Card Verification settings, overrides can be set at the Role level. If an override is available for a setting, the Overrides button appears.


For instance, you may want to restrict

...

B2B customers to two

...

verification attempts and allow everyone else the default value of three

...

...

Image Removed

7.       If you want to add different override values for other roles, click the Image Removed button and assign a role and an override value.

8.       Click Confirm to save your changes.

9.       Click Save and Exit to effect your changes.

10.     You should now see a new option in your CMS: Orders

Image RemovedImage Removed

11.     Any orders waiting for verification will appear in here. 

Image Removed

12.     Click on More Info to see the details on the order, including the order split amounts.

Image Removed

13.     If the user fails the first attempt, then eWay 

Image Removed

...

Image Added

To add an override,

  1. Click the Add Override button.

  2. In the Role dropdown list, select the required Role.

  3. In Override Value, add the alternative value.

  4. To save the override, click Confirm. You will see that the number of overrides for the feature has increased by one.

  5. To save your changes, click Save or Save and Exit.

3. Edit Order Confirmation Message Widget

After an order is submitted, the Order Confirmation page displays a message about the verification process and how to complete it. The message also appears in an 'Order Pending' email to the customer.

Image AddedImage Added

Image Added


This message is customised in the Order Confirmation Message widget. To edit it,

  1. Navigate to Content → Pages & Templates → Order Confirmation Page

  2. Click Edit.

  3. Find the Order Confirmation Message widget and click Edit

  4. Find the tab: Credit Card Validation.

    Image Added

  5. Customise the heading and message. In the default message, '{0}' is the placeholder for the value set in 'Days to Hold Order', and the message contains a link to the 'Credit Card Validation Amount' page.  

  6. Save your changes. 

View and manage orders during the credit card verification process

When Credit Card Verification is turned on, the menu item Orders → Credit Card Verification appears in the CMS. Click it to view the list of orders flagged for verification and their current statuses.

Image Added

Image Added


Orders processed through the verification check have one of three statuses at any time:

  • Completed - verification was successfully completed and the order has progressed to the fulfilment process,
  • Pending - verification is in progress and order is on 'hold',
  • Cancelled - verification was unsuccessful and order has been cancelled.
      

An order awaiting credit card verification has the status 'Pending'.

Image Added


To view an order's details including the actual charged amounts and access verification management functions, click More Info.

Image Added

Resend credit card verification email to Customer

This function is available only if 'Enable Immediate Order Integration' mode is OFF. If the customer enquires after their order and requires the 'pending order' email with a link to the verification page, you can resend the email to them by clicking Resend Email

...

.

...

  

Retrieve verification page link for a 'pending' order

You can retrieve the verification page link by clicking 'Copy to Clipboard' in the 'Order Information' page.  

Verify credit card ownership offline and release order

If the customer was unable to validate the credit card via the link

...

but was able to confirm card ownership another way, e.g., calling in with the amount, an authorised CMS user can manually release the 'pending' order for further processing.

  1. In the

...

What your customers/users will see

...

  1. Order list, find the order.

  2. Click the Release button for the order.

Image Removed

16.     The system will ask for a release reason. Click Confirm.

Image Removed

17.     And the order is released. The customer will receive confirmation email notifications.

Image Removed


  1. Image Added

  2. In the Credit Card Order - Release popup box, enter the reason for the release and click Confirm

    Image Added

    The order is released for further processing and the customer will receive an order confirmation email. Any other orders pending on verification of the same credit card will also be released.

    Image Added


Anchor
customer
customer

From your customers' perspective 

  1. A new user or customer registers on your site and makes a purchase

...

  1. . At the 'Checkout' page, they must tick the box to acknowledge that their credit card payment may be selected for additional security verification.

    Image Modified

...


  1. As this is the first time

...

  1. the customer has purchased something

...

Image Removed

4.       The system will also send them an email, which also has the link for them to validate the order. 

Image Removed
5.       When they click the link on the email (or Order Pending screen), they must enter one of the values that was charged to their card to release their order.
Image Removed
6.       Once the order is released, the system will send them a verification email, which shows the total amount and confirms the split values.
Image Removed

User fails credit card verification

1.       The system will display a failed message each time the user enters an amount that does not match the splits charged to the credit card for the nominated order.
Image Removed

...

  1. on your site, their credit card is unverified. In the Confirmation page, they are advised the order is 'pending' validation. 

    Image Added



  2. The system sends them an 'Order Pending' email, which also has a link to the verification page. 
    - If 'immediate integration' mode is OFF, the customer receives the email immediately after order submission. They can verify ownership of the card as soon as they know the charged amount.   
    - If 'immediate integration' mode is ON, the customer does not receive the email until the order has been integrated to the ERP. At that point, the system will send them the 'order pending' email and they can verify their credit card.

    Info
    titleWhat if the user tries to verify before the integration is complete?

    If the user tries to access the verification page before order integration is finished, a message will inform them the order has not been confirmed and to try again later. You can always tell the user to wait for the 'order pending' email before attempting to verify.

    Image Added



  3. Once the customer knows the charged amount(s), they can proceed by clicking the link on your site or in the email. (The charged amount(s) the customer needs for verification will appear in their credit card's transactions.)  

    Image Added


  4. If the amount entered is correct, verification is complete. The order is releaased and its verification status changes to 'Completed'. The customer receives an order confirmation email.  


What if the user fails credit card verification?

  1. Each time the user enters an incorrect amount, the system displays a 'failed' message. The number of allowed attempts is set in 'Attempts Allowed'. 
Image Added

2 (i) On the final failed attempt, the system will advise

...

that

...

the number of verification attempts have been reached. 

Image Removed

...

Image Added

(ii) For the 'immediate integration OFF' mode, the system will email the address

...

entered in 'Notification Email' of the failed

...

Image Removed
4.       If the user attempts the verification, the system will inform them that they have exceeded their attempts.
Image Removed

...

verifications and order cancellation.

(iii) For security reasons, a CMS administrator cannot release an order that has failed verification.

...

Image Added

...


Note

...

The credit card

...

is charged at the time of purchase. Therefore, if an order is abandoned (not verified and not cancelled), the customer must engage with the credit card merchant to organise a refund to the nominated credit card

...

.


Additional

...

information

Multiexcerpt
hiddentrue
MultiExcerptNameAdditional Info

...

Automated processes at each stage of verification so minimal handling and attention needed from your staff. An order's verification status can easily be tracked and changed in the CMS manually.  4.23+ for immediate Integration mode. 


Minimum Version Requirements


Multiexcerpt
MultiExcerptNameMinimum Version Requirements

4.15

...


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

...

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

Contact CV Support

...

Multiexcerpt
MultiExcerptNameBallpark Hours From CV (in addition to any self config required)

Contact CV Support

Use of Eway or Braintree gateway


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

Yes


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

Payment Types


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both

Both

...


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

n/a

...


...

 Orders



Related

...

help

Content by Label
showLabelsfalse
max

...

10
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
excludeCurrenttrue
cqllabel in ("

...

ver41500","

...

payment") and type = "page" and space = "KB"
labelshow-to ver41500

...

Content by Label

...

showLabels

...

false

...

showSpace

...

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

...

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:

...

false
titleRelated widgets
excludeCurrenttrue
cqllabel = "widget" and title ~ "Order Confirmation Message"