Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Setup Checklist

Insert excerpt
AE:Set-up ChecklistAE:
Set-up Checklist
nopaneltrue

1. POS

TASKS
  • Decide if you are syncing credit cards to RTP|One.

    Status
    colourRed
    titlerequired

  • Tasks

    • Complete POS accounting tasks for products sold online needs to be completed

    Status
    colourRed
    titleREQUIRED
    Ensure that you are using a tokenized version of RTP|One with CardDog/TRI/First Data.
    • Status
      colourRed
      titleREQUIRED

    Status
    colourGreen
    titledetailed setup

    2.

    INFRASTRUCTURE TASKSUpdate the Azure appsettings to 'AllowTransferofCC' from false to true and give it a test. 

    Payment Provider Tasks

    • Determine if ApplePay, GooglePay or PayPal will be used.

      Status
      colourRed
      title

    REQUIREDValidate the credit related settings in the UnityPeakProd rtp-config.json when that switch occurs.  
    • required

    • Configure GooglePay in Braintree

      Status
      colour

    Red
    • Blue
      title

    REQUIREDTesting should include verifying the RTP|One Credit Card Profile visually looks correct and that the data in the PaymentCardToken table looks good. 
    • optional

    • Configure ApplePay in Braintree

      Status
      colour

    Red
    • Blue
      title

    REQUIREDPerform a 'charge to the card on file' and a return to verify those are working. titleREQUIRED Statuscolour
    • optional

    Status
    colour

    Red

    Green
    titledetailed setup

    3.

    PAYMENT PROVIDER TASKS
    • Determing if ApplePay, GooglePay or PayPal will be used.

      Status
      colourRed
      titlerequired

    • Configure GooglePay in Braintree

      Status
      colourBlue
      titleoptional

    • Configure ApplePay in Braintree

      Status
      colourBlue
      titleoptional

    Status
    colourGreen
    titledetailed setup

    4. COMMERCE TASKS

    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

    3. Commerce Tasks

    1. Update Settings

      Status
      colourRed
      titleREQUIRED

      1. For version 2.27 or later, in Configuration > Settings > All Settings, configure the following:

        1. ecommercesettings.allowstorageofcc = TRUE

        2. ecommercesettings.allowtransferofcc = FALSE

    2. Set up GL Report.

      Status
      colourRed
      titlerequired

    3. Configure Aspenware Commerce Payment Gateway

      Status
      colourRed
      titleRequired

    Status
    colourGreen
    titledetailed setup

    Detailed Setup Guide

    POS TASKS

    ...

    Insert excerpt
    Detailed Setup Guide Excerpt
    Detailed Setup Guide Excerpt
    nopaneltrue

    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 needs to be completed.

    • Ensure that you are using a tokenized version of RTP|One with CardDog/TRI/First Data.

    INFRASTRUCTURE TASKS

    • Update the Azure appsettings to 'AllowTransferofCC' from false to true and give it a test. 

    • Validate the credit related settings in the UnityPeakProd rtp-config.json when that switch occurs.  

    • Testing should include verifying the RTP|One Credit Card Profile visually looks correct and that the data in the PaymentCardToken table looks good. 

    • Perform a 'charge to the card on file' and a return to verify those are working.

    PAYMENT PROVIDER TASKS

    • .

    Payment Provider Tasks

    Determine which additional payment methods will be supported for your resort. Possibilities include:

    • PayPal

      ApplePay
    • Apple Pay

    • GooglePay

    • (Optional) Configure GooglePay in BraintreeGoogle 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, you

      You'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.(Optional) Configure ApplePay

    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 Request

      https://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

    1. Update Settings

    2. Set up GL Report.

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

      1. Search for ecommercesettings.allowtransferofcc

        Image Added

         

        1. Click Edit.

          Image Added

           

        2. Set the Value to FALSE and click Update.

          Image Added

      2. Search for ecommercesettings.allowstorageofcc

        Image Added

         

        1. Click Edit.

    ...

        1. Image Added

           

        2. Set the Value as follows:

          1. If Using Aspenware Payment Plans, set to FALSE

          2. If NOT using Aspenware Payment plans, set to TRUE

            Image Added
        3. 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.

    ...