Configuration: Payment Gateway - Windcave
- 1 Setup Checklist
- 2 Prerequisite Tasks
- 2.1 POS Tasks
- 2.2 Payment Provider Tasks
- 2.3 Commerce Tasks
- 3 Detailed Setup Guide
- 3.1 1. Set Up GL Reporting
- 3.2 2. Determine Communication Requirements
- 3.3 3. Specify Currency
- 3.4 4. Specify Language and Culture
- 3.5 5. Ensure CSS File is Sent to Windcave
- 3.6 6. Configure Payment Gateway
- 3.7 7. Configure Digital Wallet Options
- 3.8 8. Activate Windcave Payment Provider Widget
- 3.9 8. Initiate Test Transactions
- 4 Common Troubleshooting guide
- 4.1 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?
- 4.2 Q: I’m seeing the following screen. Why does it look like this?
- 4.3 Q: My 3DS challenge is showing $0 rather than the price of my products, why is this?
- 4.4 Q: What happens if I want to use multiple payment methods and digital wallets?
- 4.5 Q: Why can’t I change my billing address when using a digital wallet in checkout?
- 4.6 Q: Why can’t I see the last 4 of my credit card number on the confirmation page when I use my digital wallet?
- 4.7 Q: Why is there no alternate credit card profile in RTP after a resort customer’s transaction?
Setup Checklist
1. POS TASKS |
|
---|---|
Complete POS accounting tasks for products sold online. Required | Prerequisite |
2. PAYMENT PROVIDER TASKS | prerequisite |
|
|
3. COMMERCE TASKS |
|
Update Settings REQUIRED
| prerequisite |
| Detailed Setup |
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.
Prerequisite Tasks
POS Tasks
IMPORTANT: Syncing Windcave tokens to the POS to use for refunds or resort charge is not possible. This is due to POS technical limitations with storing Windcave tokens that would require the POS to engage in development activities to support.
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.
IMPORTANT: To activate your production environment you will need to obtain an API key and API username from Windcave. Make a note of these for use later in this guide.
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.
- Windcave Dashboard - Payment Page Tab Selected
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: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.
Need Help?
If credentials are not readily available, contact Windcave Support for assistance with integrating Apple Pay and other wallets.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.
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 TRUE and click Update.
Search for ecommercesettings.allowstorageofcc
Click Edit.
Set the Value as to TRUE.
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 +
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.
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
Each Windcave "account" (unique set of user name and API key) requires a custom CSS file to be configured and added. Work with your Aspenware Representative (support@aspenware.com) to ensure that the custom 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:
Use Sandbox: Should be checked for test and unchecked for prod.
API Key: Obtain from Windcave.
API Username: Obtain from Windcave.
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.
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.
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’.
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!’.
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.’
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’
Click Save.
7. 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:
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: 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:
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. 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.
Check the Is active checkbox to make the widget active. Leave Display order at 1. Click Update to save the settings.
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.