Setup Checklist
This section is a comprehensive and high level summary of all tasks and prerequisites required for this feature to function properly. This section is purposed for use after an administrator is familiar with configuring this feature as an “audit” checklist. For detailed set-up instructions, jump down to “Prerequisite Tasks” and “Detailed Setup Guide” and then follow up with this checklist to ensure all steps are completed.
1. POS Tasks | |
|---|---|
| DETAILED SETUP |
2. Infrastructure Tasks | |
| DETAILED SETUP |
3. Payment Provider Tasks | |
| DETAILED SETUP |
4. Commerce Tasks | |
| DETAILED SETUP |
Detailed Setup Guide
This section describes all required steps to set up the feature after prerequisite tasks have been completed.
Setup Checklist
This section is a comprehensive and high level summary of all tasks and prerequisites required for this feature to function properly. This section is purposed for use after an administrator is familiar with configuring this feature as an “audit” checklist. For detailed set-up instructions, jump down to “Prerequisite Tasks” and “Detailed Setup Guide” and then follow up with this checklist to ensure all steps are completed.
| |
|---|---|
| DETAILED SETUP |
| |
| DETAILED SETUP |
| |
| DETAILED SETUP |
| |
| DETAILED SETUP |
Detailed Setup Guide
This section describes all required steps to set up the feature after prerequisite tasks have been completed.
POS Tasks
IMPORTANT: Syncing Braintreetokens to the POS to use for refunds or resort charge is not possible. This is due to POS technical limitations with storing Braintree tokens that would require the POS to engage in development activities to support.
Complete POS accounting tasks for products sold online.
Infrastructure Tasks
Update the store’s appsettings.json under the Ecommerce node. The store application service must be restarted after changing any value in appsettings.json.
Update the Azure appsettings to 'AllowStorageofCC' to false.
Update the Azure appsettings to 'AllowTransferofCC' to false.
Validate the credit related settings in the UnityPeakProd rtp-config.json when that switch occurs.
PAYMENT PROVIDER TASKS
Determine which additional payment methods will be supported for your resort. Possibilities include:
PayPal
ApplePay
GooglePay
(Optional) Configure GooglePay in Braintree
Use debug merchant ID for test: 01234567890123456789
In production Braintree go to Settings > Processing > Google Pay and enable Google Pay.
You'll also need to submit a support request with Google to register your domain and receive a merchant ID. - fill out this form.
Send Aspenware test site and production site to Google
Google approves submissions for APIs. They will need to ensure it adheres to their Acceptable Use Policy
Once approved, you’ll send Google an email address to be used for production access.
Once they approve you, you can sign up for a developer account HERE.
Send Aspenware your merchant ID.
(Optional) Configure ApplePay in Braintree
Set up Apple Developer Account and Merchant and Certificate and upload your Certificate in Braintree.
Download the Certificate Signing Request.
Sign in to your Developer Center in Safari. (You may need an Apple Developer Account to do this.)
Create an Apple Pay Merchant ID - You'll first need a developer center account to do this. They recommend using separate Apple Pay Merchant IDs for sandbox and production to ensure that your sandbox app cannot create production transactions.
Generate a new Apple Pay Certificate in Apple's developer portal - again you'll do this within your developer center.
in Braintree production, Select Apple Pay Certificate and click Continue.
In the drop-down, choose the appropriate Apple Merchant ID for your Braintree environment (Sandbox or Production) and click Continue.
Under Payment Processing Certificate, click Create Certificate.
Upload the CSR that you downloaded from Braintree in the first step above. You must use the CSR we provide. Do not create a CSR file yourself.
Download the new Apple Pay Certificate and upload it when setting up Apple Pay in Braintree go to Settings > Processing > Apple Pay
Then host the domain association file from Apple on the shop.
Aspenware Commerce Tasks
Work with your Aspenware Representative to set up the GL Report so you can reconcile GL reporting in the POS and payment gateway.
Go to Configuration > Payment Methods in Admin.
Click Edit on the Braintree payment gateway.
Check Is active the for Braintree and Save. Ensure that only Braintree is set to Is active.
Select Configure on the Braintree payment method.
To change or set up payment account, fill in the following fields:
Use Sandbox: Should be checked for test and unchecked for prod
Merchant ID: Obtain from Braintree
Private Key: Obtain from Braintree
Public Key: Obtain from Braintree
Additional Fee: Set to 0.00
Additional fee. Use percentage: Unchecked
Requires Billing Address: Unchecked
Requires Phone Number: Unchecked
Click Save.
Test a live credit card for each type of accepted credit card (Visa, Amex, Discover, Mastercard) to ensure gateway is processing payments properly once setup is completed.
Common Troubleshooting
Q: What functionality is and isn’t available to me because of having Braintree as a Payment Provider?
A: Good news is that using Braintree allows you to enable a number of advanced features, most notably Payment Plans, Saving a credit card to use on future e-commerce transactions, Apple Pay, Google Pay and Pay Pal. Some limitations with using Braintree are that in order to store a token for being charged at a later date, a minimum $1 transaction must be completed to store the card, so any product that enrolls you in a Payment Plan must have a minimum $1 deposit. Unfortunately, because some functionality is made possible by having a token stored in the POS, and neither RTP nor Siriusware support storing Braintree tokens, resort charge, direct to lift, and capturing tokens for refunds in the POS is not supported.
Q: When I look at an order status in Aspenware Commerce Order Details, the status is set to pending rather than complete? What’s wrong with this order?
A: The true indicator of whether a product made it to RTP successfully is the order queue. If you see orders showing as Pending in the Sales>Orders area, check if any products in these orders have Shipping checked on the product editor
This won't cause problems per-say but is really only used for retail products that are shipped, so it shouldn't be checked. Because Nopcommerce is often used as a retail platform, what processing means in Nop is similar to what Open means in RTP. The order is paid for, but the order has not been fulfilled, aka shipped. For ski, we send the order to RTP for fulfillment and don't do any fulfillment in NOP - we use the delivery plugin for shipping ski media and ignore Nopcommerce shipping, so it's not a problem, but my guess is that if you uncheck shipping on these products and save it, you will start seeing these orders show as completed.
Like this page? Click the like button below. Don't like this page and/or want to give feedback about this page, leave a comment below and Aspenware will address to improve this article.