Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Insert excerpt
Set-up Checklist
Set-up Checklist
nopaneltrue

1. POS TASKS

Complete POS accounting tasks for products sold online.

Status
colourRed
titleRequired

Status
colourYellow
titlePrerequisite

2. PAYMENT PROVIDER TASKS

Status
colourYellow
titleprerequisite

  • Ensure you have a Windcave Merchant account. If you don't already have one, you can sign up here: Windcave. Make note of your API key and API username when received from Windcave.

    Status
    colourRed
    titlerequired

  • Determine if you will use digital wallets. If so, obtain the proper credentials from Apple, Google, or PayPal according to the payment methods you wish to enable.

  • Determine if you will use the 3DSecure feature within Windcave. This is an additional layer of security that Visa cardholders can opt into. To configure 3DSecure from the Windcave dashboard, click on the Payment Page tab and then scroll to the bottom for the 3DSecure fields.

    Status
    colourBlue
    titleoptional

  • Enable Failed Validation Messaging for Cards Not Accepted

    Status
    colourBlue
    titleoptional

3. COMMERCE TASKS

Update Settings

Status
colourRed
titleREQUIRED

  • In Configuration > Settings > All Settings, configure the following:

    1. ecommercesettings.allowstorageofcc = TRUE

    2. ecommercesettings.allowtransferofcc =

FALSE
    1. TRUE

Status
colourYellow
titleprerequisite

  1. Set Up GL Reporting

    Status
    colourRed
    titlerequired

  2. Determine Communication Requirements

    Status
    colourRed
    titlerequired

  3. Specify Currency

    Status
    colourRed
    titlerequired

  4. Specify Language

    Status
    colourRed
    titlerequired

  5. Ensure CSS File is Sent to Windcave

    Status
    colourRed
    titlerequired

  6. Configure Payment Gateway

    Status
    colourRed
    titlerequired

  7. Activate Windcave Payment Provider Widget

    Status
    colourRed
    titlerequired

  8. Initiate Test Transactions

    Status
    colourRed
    titlerequired

Status
colourGreen
titleDetailed Setup

Info

NOTE: At this time Aspenware does not support Windcave in a multi-store environment. We plan to add that feature as part of future development.

...

  • Determine if you will use the 3DSecure feature within Windcave. This is an additional layer of security that Visa cardholders can opt into. To configure 3DSecure from the Windcave dashboard, click on the Payment Page tab and then scroll to the bottom for the 3DSecure fields. Your Windcave representative can assist you if needed.

  • Validation for Cards Not Accepted (Optional): Windcave can be configured to fail to validate any card number that is not a VISA, Mastercard or AmEx in the Card Number Field in the checkout. Error messaging is provided to the customer. This can be applied by contacting Windcave Tech Support.

    Image Removed

Commerce Tasks

Update the following settings in Commerce Admin.

Go to Configuration > Settings > All settings (advanced)

Search for ecommercesettings.allowtransferofcc

...

...

Click Edit.

...

Set the Value to FALSE and click Update.

...

Search for ecommercesettings.allowstorageofcc

...

  1. Click Edit.

    Image Removed

  2. Set the Value as to TRUE.

    Image Removed
  3. Click Update.

Note

IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work.

Detailed Setup Guide

  1. Set Up GL Reporting

  2. Determine Communication Requirements

  3. Ensure CSS File is Sent to Windcave

  4. Configure Payment Gateway

  5. Activate Windcave Payment Provider Widget

  6. Initiate Test Transactions

1. Set Up GL Reporting

Work with your Aspenware Representative to set up the GL Report so you can reconcile GL reporting in the POS and payment gateway.

2. Determine Communication Requirements

Windcave is an international payment gateway, meaning consideration must be given to the communication requirements for the individual countries in which your resort conducts business. Some countries have specific requirements for communication to customers on order confirmation emails, cancelation policies, etc. Verify any country-specific requirements with your Windcave Service Representative. Talk with your Aspenware representative about customizing the email template if necessary.

3. Specify Currency

Windcave has universal capabilities and, as such, accommodates many languages and currencies. To ensure that Aspenware is set to communicate with the gateway using the correct currency, the following configurations must be made.

  • Go to Configuration > Currencies in Admin.

  • Find the currency that you wish to choose and click Edit. If your currency is not listed, select Add new +

    Image Removed

  • On either the Edit currency details or the Add a new currency page, complete the following fields:

    • 1. Name: This should be the generally accepted name of the currency (e.g. Australian Dollar).

    • 2. Currency code: This is the official code for the currency that us used in financial markets (e.g. AUD).

    • 3. Rate: This will always be 1. The payment gateway handles all currency exchange rates

    • 4. Published: This field should be checked.

    • All other fields are not used and may be left blank.

  • Click Save.

    Image Removed
  • Once you’ve returned to the Currencies screen, find your currency and click the green Mark as primary exchange rate currency and the green Mark as primary store currency buttons. Blue checkmarks should appear to the left of each button. Please ensure that no other currency has a blue checkmark listed. Edit any other currency that is listed as Published to have that field unchecked (not shown in example).

...

4. Specify Language and Culture

Windcave has universal capabilities and, as such, accommodates many languages and currencies. To ensure that Aspenware is set to communicate with the gateway using the correct language and cultural references, the following configurations must be made.

  • Go to Configuration > Languages in Admin.

  • Find your chosen language and select Edit. If your language is not listed, select Add new +.

  • On either the Edit language or Add new language screen, complete the following fields:

  • Name: Enter the name of the language (e.g. English).

  • Language culture: Select appropriate language culture from the dropdown list.

  • Unique seo code: Choose a code (e.g. us)

  • Flag image file name: Select the appropriate flag.

  • Right-to-left: Check the box if the language reads right to left instead of left to right.

  • Default currency: Select the currency used.

  • Limited to Stores: Leave blank.

  • Published: Check this box.

  • Determine if you will use digital wallets with Windcave and procure credentials: Digital wallets (Apple Pay, Google Pay or PayPal) can be configured in Aspenware Commerce, but will require preliminary setup to enable.
    To set up:

    1. Gather Credentials:

      • Log into your Windcave merchant account.

      • Go to the payment gateway settings and locate credentials for Apple, Google, or PayPal.

      • If you don’t already have accounts for these digital wallets, establish valid merchant accounts through Google, Apple, or PayPal first.

    2. Need Help?
      If credentials are not readily available, contact Windcave Support for assistance with integrating Apple Pay and other wallets.

    3. Helpful Resource: Windcave PayPal Credentials Guide

  • Validation for Cards Not Accepted (Optional): Windcave can be configured to fail to validate any card number that is not a VISA, Mastercard or AmEx in the Card Number Field in the checkout. Error messaging is provided to the customer. This can be applied by contacting Windcave Tech Support.

    Image Added

Commerce Tasks

Update the following settings in Commerce Admin.

  • Go to Configuration > Settings > All settings (advanced)

    1. Search for ecommercesettings.allowtransferofcc

      Image Added

      1. Click Edit.

        Image Added

      2. Set the Value to TRUE and click Update.

        Image Added


    2. Search for ecommercesettings.allowstorageofcc

      Image Added

      1. Click Edit.

        Image Added

      2. Set the Value as to TRUE.

        Image Added
      3. Click Update.

Note

IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work.

Detailed Setup Guide

1. Set Up GL Reporting

Work with your Aspenware Representative to set up the GL Report so you can reconcile GL reporting in the POS and payment gateway.

2. Determine Communication Requirements

Windcave is an international payment gateway, meaning consideration must be given to the communication requirements for the individual countries in which your resort conducts business. Some countries have specific requirements for communication to customers on order confirmation emails, cancelation policies, etc. Verify any country-specific requirements with your Windcave Service Representative. Talk with your Aspenware representative about customizing the email template if necessary.

3. Specify Currency

Windcave has universal capabilities and, as such, accommodates many languages and currencies. To ensure that Aspenware is set to communicate with the gateway using the correct currency, the following configurations must be made.

  • Go to Configuration > Currencies in Admin.

  • Find the currency that you wish to choose and click Edit. If your currency is not listed, select Add new +

    Image Added

  • On either the Edit currency details or the Add a new currency page, complete the following fields:

    • 1. Name: This should be the generally accepted name of the currency (e.g. Australian Dollar).

    • 2. Currency code: This is the official code for the currency that us used in financial markets (e.g. AUD).

    • 3. Rate: This will always be 1. The payment gateway handles all currency exchange rates

    • 4. Published: This field should be checked.

    • All other fields are not used and may be left blank.

  • Click Save.

    Image Added
  • Once you’ve returned to the Currencies screen, find your currency and click the green Mark as primary exchange rate currency and the green Mark as primary store currency buttons. Blue checkmarks should appear to the left of each button. Please ensure that no other currency has a blue checkmark listed. Edit any other currency that is listed as Published to have that field unchecked (not shown in example).

...

4. Specify Language and Culture

Windcave has universal capabilities and, as such, accommodates many languages and currencies. To ensure that Aspenware is set to communicate with the gateway using the correct language and cultural references, the following configurations must be made.

  • Go to Configuration > Languages in Admin.

  • Find your chosen language and select Edit. If your language is not listed, select Add new +.

  • On either the Edit language or Add new language screen, complete the following fields:

    • Name: Enter the name of the language (e.g. English).

    • Language culture: Select appropriate language culture from the dropdown list.

    • Unique seo code: Choose a code (e.g. us)

    • Flag image file name: Select the appropriate flag.

    • Right-to-left: Check the box if the language reads right to left instead of left to right.

    • Default currency: Select the currency used.

    • Limited to Stores: Leave blank.

    • Published: Check this box.

    • Display order: Set as 1.

...

5. Ensure CSS File is Sent to Windcave

...

6. Configure Payment Gateway

  • Go to Configuration > Payment Methods in Admin.

  • Click Edit on the Windcave payment gateway.

  • Check Is active and save.  Ensure that only the Windcave payment gateway is set to ‘Is active.’

  • Select Configure on the desired payment method. 

  • Complete the following fields:

    1. Use Sandbox: Should be checked for test and unchecked for prod.

    2. API Key: Obtainfrom Windcave.

    3. API Username: Obtain from Windcave.

    4. Requires Billing Address:Check to supply postal code/zip for AVS. (You can edit which fields are captured under Settings/Customer Settings/Address Form Fields.

    5. Credit Card Form Title: (Language String) This is a customizable title for the form the guest completes with credit card information. Default title is ‘Credit Card Information’.

    6. 3DS Successful Payment Title: (Language String) This is the first sentence of the customizable message a guest receives to proceed once they successfully pass 3DSecure (see screenshot below). Default message is ‘Payment information complete!’.

    7. 3DS Successful Payment MessageAbandoned Session Timeout in minutes: Determine the number of minutes you would like the system to wait before cancelling a customer’s initial credit card authorization. This helps prevent multiple authorizations against a credit card if a customer opts to leave checkout. This setting is defaulted to and must be at least 30 minutes.

    8. Credit Card Form Title: (Language String) This is the second a customizable title for the form the guest completes with credit card information. Default title is ‘Credit Card Information’.

    9. 3DS Successful Payment Title: (Language String) This is the first sentence of the customizable message a guest receives to proceed once they successfully pass 3DSecure (see screenshot below). Default message is ‘Click the continue button to proceed.’‘Payment information complete!’.

    10. 3DS Successful Payment Link TestMessage: (Language String) This is the third second sentence of the customizable message a guest receives to proceed once they successfully pass 3DSecure (see screenshot below). This language accompanies the Default message is ‘Click the continue button to proceed.’

    11. 3DS Successful Payment Link Test: (Language String) This is the third sentence of the customizable message a guest receives to proceed once they successfully pass 3DSecure (see screenshot below). This language accompanies the link that takes a user back to the credit card entry screen to change their payment method. Default message is ‘change payment’

  • Image Modified
Info

NOTE: Activation and configuration of 3DSecure is done within the Windcave dashboard. This feature is NOT activated in Aspenware Commerce.

  • Click Save.

7.

...

  • Go to Configuration > Widgets. Select the Windcave Payment provider widget and click Edit.

    Image Removed

  • Check the Is active checkbox to make the widget active. Leave Display order at 1. Click Update to save the settings.

    Image Removed

8. Initiate Test Transactions

  • Windcave mandates 3DS is turned on for testing prior to a resort’s launch, so resorts need to test and decide to enable or disable this setting.

  • Test a live credit card for each type of accepted credit card (Visa, Amex, Discover, Mastercard) to ensure the gateway is processing payments properly once setup is completed.

Common Troubleshooting guide

Q: When a 3DSecure customer goes to enter their payment information, the screen is very small and there are scrollbars to see the whole window. Can we make this look better?

...

A: Unfortunately, this window is not configurable by Aspenware. We understand that it doesn’t conform to our UI standards. Fortunately, 3DSecure customers are savvy and have likely seen this screen many times will understand how to enter their credentials.

Q: I’m seeing the following screen. Why does it look like this?

...

Configure Digital Wallet Options

Use ApplePay: Once you have your merchant ID for Apple Pay from Windcave you may check this box to enable Apple Pay to show as an option on the Payment page. Note: This option will only show for those transactions that do not have payment plans, subscriptions, or resort charge on them, as digital wallets are not supported for recurring payments.

  • Apple Pay Merchant Id: Obtain from Windcave.

  • Apple Pay Button Style: Use the dropdown to select one of the button styles offered by Apple Pay:

    • Black: image-20241225-025253.pngImage Added

    • White: image-20241225-025332.pngImage Added

    • White-outline: image-20241225-025420.pngImage Added

  • Apple Pay Button Type: Use the dropdown to select one of thebutton types offered by Apple Pay (this will show with the button style selected above, examples using white-outline button style):

    • Plain: image-20241225-025420.pngImage Added

    • Book: image-20241225-030350.pngImage Added

    • Buy: image-20241225-030410.pngImage Added

    • Continue: image-20241225-030437.pngImage Added
      Pay : image-20241225-030453.pngImage Added

Use GooglePay: Once you have your merchant ID for Apple Pay from Windcave you may check this box to enable Apple Pay to show as an option on the Payment page. Note: This option will only show for those transactions that do not have payment plans, subscriptions, or resort charge on them, as digital wallets are not supported for recurring payments.

  • Use GooglePay Test Mode: Check this box if you would like to use Google Pay test mode.

  • GooglePay Merchant Id: Obtain from Windcave.

  • Google Pay Button Style: Use the dropdown to select one of the button styles offered by Google

    • Black: image-20241225-030453.pngImage Added

    • White: image-20241225-030852.pngImage Added

  • Google Pay Button Text: Use the dropdown to select one of thebutton texts offered by Google Pay (this will show with the button style selected above, examples using black button style):

    • Plain: image-20241225-032822.pngImage Added

    • Book: image-20241225-032834.pngImage Added

    • Buy: image-20241225-032944.pngImage Added

    • Checkout: image-20241225-033109.pngImage Added

    • Pay: image-20241225-030453.pngImage Added

Use PayPal: Once you have established your merchant account for Paypal, you may check this box to enable PayPal to show as an option on the Payment page. Note: This option will only show for those transactions that do not have payment plans, subscriptions, or resort charge on them, as digital wallets are not supported for recurring payments.

  • Digital Wallet Authentication Error Message: Enter text you would like your customers to see if there is an error accessing or processing a payment with PayPal. Default message is: ‘There was an error with your payment.’

  • Click Save.

8. Activate Windcave Payment Provider Widget

  • Go to Configuration > Widgets. Select the Windcave Payment provider widget and click Edit.

    Image Added

  • Check the Is active checkbox to make the widget active. Leave Display order at 1. Click Update to save the settings.

    Image Added

8. Initiate Test Transactions

  • Windcave mandates 3DS is turned on for testing prior to a resort’s launch, so resorts need to test and decide to enable or disable this setting.

  • Test a live credit card for each type of accepted credit card (Visa, Amex, Discover, Mastercard) to ensure the gateway is processing payments properly once setup is completed.

Common Troubleshooting guide

Q: When a 3DSecure customer goes to enter their payment information, the screen is very small and there are scrollbars to see the whole window. Can we make this look better?

...

A: Unfortunately, this window is not configurable by Aspenware. We understand that it doesn’t conform to our UI standards. Fortunately, 3DSecure customers are savvy and have likely seen this screen many times will understand how to enter their credentials.

Q: I’m seeing the following screen. Why does it look like this?

...

A: The custom css file is needed. See Step 3 above in the Detailed Setup Guide.

Q: My 3DS challenge is showing $0 rather than the price of my products, why is this?

A: Unfortunately, customers on 3.7 or earlier will not be able to transfer liability using 3DSecure unless they force the 3DSecure challenge. We recommend this approach, which can be configured via the Windcave payment gateway.

Q: What happens if I want to use multiple payment methods and digital wallets?

A: If a customer would like to use stored value, a gift card, or a discount they can do so by applying these additional methods of payments prior to completing their digital wallet validation.

Q: Why can’t I change my billing address when using a digital wallet in checkout?

A: To facilitate a more frictionless checkout, if a customer already has a stored billing address Aspenware auto-advances to the next screen. This information is used for AVS and is not necessary for digital wallet address verification. A customer can, however, change their billing address prior to selecting the digital wallet payment method.

Q: Why can’t I see the last 4 of my credit card number on the confirmation page when I use my digital wallet?

A: For security, digital wallet integrations do not provide the last 4 to Aspenware Commerce and so these digits can neither be shown on the confirmation page nor in RTP.

...

Q: Why is there no alternate credit card profile in RTP after a resort customer’s transaction?

A: A customer who uses a digital wallet will not have an alternate credit card profile created because digital wallets do not offer the credit card number in a way that can be re-used. As a result, digital wallet transactions need to be returned via the Windcave portal.

...