| Table of Contents |
|---|
...
Setup Checklist
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
1. POS Tasks | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| ||||||||||||||||||||||||||||||
2. Commerce Tasks | |||||||||||||||||||||||||||||||
Ensure that the Additional Payments Plugin is installed.
|
| ||||||||||||||||||||||||||||||
Configure Additional Payment
|
| ||||||||||||||||||||||||||||||
Update Messaging for Additional Payments on Payment Step
|
|
Prerequisite Tasks
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
Set up a general component called AW Additional Payment Component.
If using Gift Cards
Set up a gift card payment product header in RTP|One and send this new header code to your Aspenware Representative.
Price the header at $0 and make it available for a long date range (i.e. out to 2050).
Don’t add any header rules.
The header needs to be set up for the Aspenware/Online sales location
Obtain existing gift card payment method code and send the new payment method code to your Aspenware Representative.
Ensure the Aspenware/Online location is added to the Payment Method and the Payment Authorization Profile.
Obtain new GL gift card clearing account. This must be a unique and new GL clearing account. Send the new GL clearing account to your Aspenware Representative to use for creating the GL export report.
Attach the new GL clearing account to the newly created gift card payment product header (created in step a).
Aspenware will add the header code and payment method code (created above) to the Unity rtp-config.json file.
| Info |
|---|
NOTE: Aspenware recommends that you follow RTP’s best practices when issuing or printing your gift cards. In addition to being unique, all gift card numbers should all:
|
...
| Info |
|---|
NOTE: Aspenware Commerce only supports a single gift card payment method code, GL clearing account, and product header for gift cards. |
For additional information and best practices for gift cards see Gift Card Setup Recommendations.
If using Stored Value:
Set up a stored value product header in RTP|One and send this new header code to your Aspenware Representative.
Price the header at $0 and make it available for a long date range (i.e. out to 2050).
Don’t add any header rules.
The header needs to be set up for the Aspenware/Online sales location
Obtain existing stored value payment method code and send the new payment method code to your Aspenware Representative.
Obtain new GL stored value clearing account. This must be a unique and new GL clearing account. Send the new GL clearing account to your Aspenware Representative to use for creating the GL export report.
Attach the new GL clearing account to the newly created stored value product header (created in step a).
Aspenware will add the header code and payment method code (created above) to the Unity rtp-config.json file.
| Info |
|---|
NOTE: Aspenware Commerce only supports a single stored value payment method code, GL clearing account, and product header for stored value. |
If using Vouchers:
Set up a voucher payment product header in RTP|One and send this new header code to your Aspenware Representative.
Price the header at $0 and make it available for a long date range (i.e. out to 2050).
Don’t add any header rules.
The header needs to be set up for the Aspenware/Online sales location
Obtain existing voucher payment method code and send the new payment method code to your Aspenware Representative.
Obtain new GL voucher clearing account. This must be a unique and new GL clearing account. Send the new GL clearing account to your Aspenware Representative to use for creating the GL export report.
Attach the new GL clearing account to the newly created voucher payment product header (created in step a).
Aspenware will add the header code and payment method code (created above) to the Unity rtp-config.json file.
| Info |
|---|
NOTE: Aspenware Commerce only supports a single payment voucher payment method code, GL clearing account, and product header for voucher payments. |
Share the following report with accounting contact(s) at the resort to see how accounting flows with alternate payments. If questions arise, connect with Kevin Vogle (k.vogle@aspenware.com)
...
Ensure the Additional Payments plugin is installed by going to Configuration > Local Plugins. If the plugin has the Uninstall button listed like the example below, it is installed. If it looks different from the example below, contact your Aspenware Representative to install this plugin on your test and live shops.
...
Detailed Setup Guide
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
1. Configure Additional Payment
Go to Configuration>Settings>All settings and search for ‘shoppingcartsettings.showgiftcardbox’ the following settings in Name. Set the Vaue to as follows.
Name | Value | Description |
|---|---|---|
shoppingcartsettings.showgiftcardbox | True | Enables the Gift Card and Voucher box on the payment step of checkout |
Checkout.additionalPaymentsConfiguration.AreGiftCardsActive | True | Enable payment with gift cards, also complete the plugin task below to enable this. |
Checkout.additionalPaymentsConfiguration.AreVouchersActive | True | Enable payment with vouchers, also complete the plugin task below to enable this. |
Checkout.additionalPaymentsConfiguration.IsStoredValueActive | True | Enable payment with stored value, also complete the plugin task below to enable this. |
Go to Aspenware Commerce > Additional Payments and enter the following:
Allow Multiple Additional Payments: Check to support accepting more than one voucher or gift card value to be entered in a single order. If restricting guests to using only one voucher or gift card per order, leave this unchecked.
Enabled Payment Types: Check each additional payment that should be turned on for your shop: Vouchers, Gift Card and Stored Value. Keep in mind that RTP|One pre-work (detailed above) is required before paying with any of these methods will work.
...
First, to update the messaging below the Apply button, configure the HTML widget titled ‘Gift Card and Voucher Help’ using the detailed instruction guide for HTML widgets: Configuration and Library: HTML Widgets
Second, to update messaging on the payments page for alternate payments, configure the following language strings using the detailed instruction guide for language strings: Language Strings Library
Resource name | Value | Description |
|---|---|---|
account.login.checkout.payment.storedvaluebalance | You have <strong>${balance}</strong> in snow cash available. Apply this to your order? | Display stored value balance to use for guest if available. |
account.login.checkout.payment.storedvaluelabel | Stored Value | Stored value header if stored value is configured for shop and guest has available stored value balance. |
account.login.checkout.payment.vouchergiftcardplaceholder | Gift Card or Voucher | Placeholder text inside the Voucher/Gift Card entry box |
| Info |
|---|
NOTE: If the messaging changes you made don’t take, ensure that both Gift Cards and Vouchers are enabled (in the step above). For example, even if you're not using Gift Cards, that’s fine, but in order to customize the messaging, it is required to have both Vouchers and Gift Cards enabled in the plugin (Detailed above). |
Common Troubleshooting
Q: How do I share payment value vouchers with customers in the
...
My Account section so they can use these vouchers for payment on the payment step?
For payment value vouchers, ensure they are set to a payment value/recipient in order for it to show in My Account. The Voucher Type being used also has to have a ‘Report' defined in its setup. It doesn't matter what report it is but it has to be defined as something in order for the voucher to show in My Account. We may also have to add some SQL security to the user we are using as there is a call into RTP to check the account holders’ vouchers in order to display them.
...
A: If an order fails to process to RTP on the day it was placed in Aspenware Commerce due to an order failure, the GL Clearing account can be out of sync. Aspenware can help identify orders that failed and were processed days later if you are questioning the GL Clearing Account data. Insert excerpt
Q: Can I pay with some of my order with an alternate payment and the rest with Affirm?
No, Affirm requires that the entire balance of the order be paid with Affirm if Affirm is the selected payment method.
Q: We do not want to allow guests to use stored value when purchasing season passes. Is there a way to restrict stored value on Aspenware for specific products or is this a global setting? If it is a global setting, is it possible to turn this feature off when we launch?
A: Unfortunately this is a store-wide setting and can't be restricted to specific products. To turn it off you just need to uncheck stored value in the additional payments section of Aspenware Administration.
...