| Table of Contents |
|---|
Setup Checklist
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
1 |
|---|
. POS Tasks | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| |||||||||||||||||||||
2. Payment Provider Tasks | ||||||||||||||||||||||
|
|
|
| ||||||||||||||||||||||
3. Infrastructure Tasks | ||||||||||||||||||||||
| ||||||||||||||||||||||
3. Commerce Tasks | ||||||||||||||||||||||
|
|
|
|
Detailed Setup Guide
| Insert excerpt | ||||
|---|---|---|---|---|
|
...
1. Determine Payment Methods
...
|
POS Tasks
| Note |
|---|
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.
Payment Provider Tasks
Determine which additional payment methods will be supported for your resort. Possibilities include:
...
PayPal
ApplePayApple Pay
- GooglePay
Google Pay
...
1.
...
Configure
...
Google Pay in Braintree (optional)
Use debug merchant IDfor ID for test: 01234567890123456789
In production Braintree go to Settings > Processing > Google Pay and enable Google Pay.
In production, youYou'll also need to submit a support request with Google to register your domain and receive a merchant ID. - fill out this form: https://services. google.com/fb/forms/googlepaymentAPI/
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 payments.developers.google.com/signup HERE.
Send Aspenware your merchant ID.
2.
...
Configure
...
Apple Pay in Braintree (optional)
Set up an Apple Developer Account and Merchant and Certificate and upload your Certificate in Braintree.
Download the Certificate Signing Requesthttps://www.braintreegateway. com/merchants/xgw9z8r4t7g55n5g/processing/apple_pay/csr
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 I believe. 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 Pay in Braintree go to Settings > Processing > Apple Pay
Then host the domain association file from Apple on the shop.
Infrastructure Tasks
If on a version earlier than 2.27, work with your Aspenware Representative to ensure the following settings in the Azure appsettings.json file are set:
AllowStorageOfCC = TRUE
AllowTransferOfCC = TRUE
| Note |
|---|
IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work. |
Aspenware Commerce Tasks
Update Settings
Set up GL Report.
Configure Aspenware Commerce Payment Gateway
1. Update Settings
NOTE: You will need to determine if you will be using Aspenware Payment Plans with your Braintree implementation before updating the following settings.
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
Click Edit.
Set the Value as follows:
If Using Aspenware Payment Plans, set to FALSE
If NOT using Aspenware Payment plans, set to TRUE
Click Update.
| Note |
|---|
IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work. |
2. Set up GL Report
Work with your Aspenware Representative to set up the GL Report so you can reconcile GL reporting in the POS and payment gateway.
3. Configure Aspenware Commerce 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 the 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|One 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|One 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 se 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|One. The order is paid for, but the order has not been fulfilled, aka shipped. For ski, we send the order to RTP|One 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.
...