Configuration: Payment Gateway - Windcave

Setup Checklist

Prerequisite Tasks

POS Tasks

• Complete POS accounting tasks for products sold online.

Payment Provider Tasks

• Obtain a Windcave Merchant account. If you don't already have one, you can sign up here: Windcave.

• Determine if you will use the 3DSecure feature within Windcave. This is an additional layer of security that Visa cardholders can opt into. This can be configured via your Windcave dashboard’s Payment Page tab. Your Windcave representative can assist you if needed.
  
  

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

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

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

  Open

  

Commerce Tasks

Update the following settings in Commerce Admin.

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

  1. Search for ecommercesettings.allowtransferofcc
     
     

     Open

     

      

     1. Click Edit.
        
        

        Open

        

         

     2. Set the Value to TRUE and click Update.
        
        

        Open

        

        
        
        

  2. Search for ecommercesettings.allowstorageofcc
     
     

     Open

     

      

     1. Click Edit.
        
        

        Open

        

         

     2. Set the Value as to TRUE.

        Open

        

     3. Click Update.
        
        

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 +
  
  

  Open

  

   

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

  Open

  

• 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).

Open

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.

Open

5. Ensure CSS File is Sent to Windcave

Each Windcave "account" (unique set of user name and API key) requires that Windcave add a custom CSS file. If you are implementing Windcave for the first time, ask that they replace their own CSS with the custom Aspenware custom CSS file.

Open

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: Uncheck

     1. Note: Due to the way in which Windcave is setting up test credentials on resort sites, your resort will rarely use the Sandbox mode. Having the box unchecked allows resorts to test credit cards as well as digital wallets in a production-like fashion without creating a real charge.

  2. API Key: Obtain from Windcave (both for test and for production)

  3. API Username: Obtain from Windcave (both for test and for production)

  4. Requires Billing Address: Check to supply postal code/zip for AVS.

     1. Note: Regardless of checkbox the form fields are required to be filled out for all customers at this time, 3.8 will remove this requirement for digital wallet customers.

  5. Abandoned 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.

  6. 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’.

  7. 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!’.

  8. 3DS Successful Payment Message: (Language String) This is the second 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.’

  9. 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’
     
     
     

     Open

     

      

• Open

  

  3DS Language Strings

• Click Save.

7. Configure Digital Wallet Options

Note: Digital wallets are not supported for recurring payments and so will only display for those transactions that do not have payment plans, subscriptions, or resort charge products in the cart.

Obtaining your Apple Pay Mid

Once the apple well-known file has been added to your test and production sites, Windcave will be able to provide your Apple Pay merchant IDs.

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:

  • White:

  • White-outline:

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

  • Plain:

  • Book:

  • Buy:

  • Continue:
    Pay :
    
    

Use GooglePay: To use Google Pay you must procure a merchant ID from both Google and Windcave. Once you have your merchant IDs you may check the box to enable Google 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.

Obtaining your Google Google Pay Mid

Configuring Goole Pay

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

• Windcave Google Pay Merchant Id: Obtain from Windcave.

• Google Google Pay Merchant Id: Obtain from Google

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

  • Black:

  • White:

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

  • Plain:

  • Book:

  • Buy:

  • Checkout:

  • Pay:

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. You must enabled vaulting in PayPal.

• To enable vaulting in PayPal

  • Access your PayPal account: Log in to your PayPal merchant account. 

  • Go to settings: Navigate to the "Settings" section of your account. 

  • Find payment settings: Within the settings, locate the "Payment settings" or similar option. 

  • Enable Vaulting: Look for the "Vaulting" option and toggle it on.

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

  Open

  

   

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

  Open

  

8. Initiate Test Transactions

For first time implementations and whenever a major feature is added or implemented for the first time, Aspenware requires test transactions to be completed using both test and production credentials within your test environment. Please work with your customer service representative to work through this checklist:

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?

Open

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?

Open

A: The custom css file is needed. Unfortunately, this can only be seen when testing using production credentials. 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: Customers on 3.7 or earlier will not be able to transfer liability using 3DSecure unless they set up Windcave to force the 3DSecure challenge. We recommend resorts move to 3.8 or later or configure Windcave to force the 3DS challenge to ensure liability shift.

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 my digital wallet customer skip entering their billing information?

A: This functionality has been added to 3.8.

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.

Open

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.

Q: Why isn’t my PayPal integration returning my guests to the store after they have successfully logged into their PayPal account?

A: Check that both your PayPal merchant account has vaulting turned on.

For PayPal:

• Access your PayPal account: Log in to your PayPal merchant account. 

• Go to settings: Navigate to the "Settings" section of your account. 

• Find payment settings: Within the settings, locate the "Payment settings" or similar option. 

• Enable Vaulting: Look for the "Vaulting" option and toggle it on.