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

Tasks

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

    Status
    colourBlue
    titleOPTIONAL

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

    Status
    colourRed
    titleREQUIRED

It doesn't need to be super in depth - just quote these in pre req steps haha
The resort needs to be on a tokenized version of RTP. They do this with with CardDog/TRI/First Data.Once that is done, we will need to update the Azure appsettings to 'AllowTransferofCC' from false to true and give it a test. The credit related settings in the UnityPeakProd rtp-config.json should also be validated when that switch occurs.  Testing should include verifying the RTP Credit
  • Ensure that you are using a non tokenized version of RTP|One (If RTP|One is tokenized, consider a tokenized credit provider)

    Status
    colourRed
    titlerequired

Status
colourGreen
titledETAILED SETUP

2. Infrastructure Tasks

  • Work with your Aspenware Representative to ensure that the Unity rtp-config.json file is setup properly. Ensure the following settings are set:

    Status
    colourRed
    titlerequired

    • EncryptPaymentCardTokenValue = TRUE

    • UsePaymentCardTokenTable = TRUE

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

  • If on a version earlier than 2.27, your Aspenware Representative will also need to set the following in the Azure appsettings.json file:

    • AllowStorageOfCC = TRUE

    • AllowTransferOfCC = TRUE

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

 A
  •  

    Status
    colourRed
    titlerequired

  • Perform a 'charge to the card on file' and a return

should also be performed in RTP
  • to verify those are working

(and maybe an auto-charge too if Copper does this but the card on file test may be sufficient).
  • .

    Status
    colourRed
    titlerequired

Status
colourGreen
title

dETAILED SETUP

detailed setup

2. INFRASTRUCTURE TASKS

3. Payment Provider Tasks

  • Set Up Authorize.net

    Status
    colourRed
    titlerequired

Status
colourGreen
titledetailed setup

3. COMMERCE TASKS

4. Commerce Tasks

  • If on a version 2.27 or later, set the following settings in Admin:

    Status
    colourRed
    titlerequired

    • AllowStorageOfCC = TRUE

    • AllowTransferOfCC = TRUE

  • Set up GL Report.

    Status
    colourRed
    titlerequired

  • Configure Aspenware Commerce Payment Gateway

    Status
    colourRed
    titleRequired

Status
colourGreen
titledetailed setup

Detailed Setup Guide

Insert excerpt
Detailed Setup Guide Excerpt
Detailed Setup Guide

...

Excerpt
nopaneltrue

POS Tasks

  • Determine whether or not your resort will be syncing credit cards to RTP|One.

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

  • Ensure that you are using a non-tokenized version of RTP|One. If RTP|One is tokenized, consider a different payment provider.

Infrastructure Tasks

  • Work with your Aspenware Representative to ensure that the Unity rtp-config.json appsettings.json file is set properly. Ensure the following settings are set accordingly:

    • EncryptPaymentCardTokenValue = TRUE

    • UsePaymentCardTokenTable = TRUE

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

...

  • If on a version earlier than 2.27, your Aspenware Representative will also need to set the following:

    • AllowStorageOfCC = TRUE

    • AllowTransferOfCC = TRUE

Note

IMPORTANT: AllowStorageofCC must be set to TRUE for the GL Export function to work.

  • 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

Note

IMPORTANT: It is recommended to disable the Hourly Velocity setting or set it to a larger number

...

. This has caused production issues in the past.

Info

NOTE: Your MSP is the company that acts as your financial institution. The MSP deposits funds into your bank account and maintains your Merchant Account. They are also the company that charges you the percentage discount rate on your batch settlements. For more information on this subject, see the Support Article about MSP and their role in the payment process in the article below: https://support.authorize.net/s/article/What-Is-the-Difference-Between-Authorize-Net-My-Reseller-Processor-and-Merchant-Service-Provider-MSP-Who-Do-I-Contact-with-Concerns-Regarding-My-Transactions

...

.

Commerce Tasks

1. Update Settings (for version 2.27 or later)

If you are running version 2.27 or later, you will need to update 2 credit card settings.

  • Go to Configuration > Settings > All settings

  • Search for “ofccC” to find AllowStorageOfCC and AllowTransferOfCC settings

    Image Added
  • Both settings should be set to TRUE. Click Edit to update settings as needed.

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 Payment Method

  • Go to Configuration > Payment Methods in Admin.

  • Click Edit on the Authorize.net payment gateway.

  • Check Is active and Save.  Ensure that only Authorize.net is set to ‘Is active.’

  • Select Configure on the Authorize.net payment method. 

  • To change or set up payment account, fill in the following fields:

    1. Use Sandbox: Should be checked for test and unchecked for production

    2. UseShippingAddressAsBilling: Unchecked

    3. Transaction Mode Values: Set to ‘Authorize and Capture’

    4. Transaction Key: Obtain from Authorize.net

    5. Login ID: Obtain from Authorize.net

    6. Additional Fee: Set to 0.00

    7. Additional Fee Percentage: Uncheck

    8. Requires Billing Address: Likely checked, but verify to be sure that it is required for checkout.  

    9. Requires Phone Number: Unchecked

  • Click Save.

4. Disable Update Credit Card Feature

The functionality to update a credit card through the customer’s My Account page is not supported with Authorize.net. Therefore, the Resort Charge Tab on My Account needs to be disabled. This can be done in one of two ways:

  • Method One

    1. Go to Configuration > Settings > All settings (Advanced).

    2. Search for the setting customersettings.hideresortchargetab

      Image Added
    3. Click Edit and change the setting value to TRUE to hide the tab.

    4. Click Update to save the setting change.

      Image Added
  • Method Two

    1. Go to Configuration > Customer Settings.

    2. Scroll down to Additional Customer Settings.

    3. Check the Hide Resort Charge Tab checkbox to hide the tab.

      Image Added
    4. Click Save.

5. Test Payment Method

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. 

Info

NOTE: Amex requires additional steps when configuring Authorize.net, so it is important not to skip testing Amex for live credit once configured. If Amex is declining but the other card types are working, reach out to Authorize.net support.

Common Troubleshooting

Q: What functionality is and isn’t available to me because of having Authorize.net as a Payment Provider?

A: Because Authorize.net encrypted credit cards can be stored in RTP|One as an alternate and primary credit card, functionality that is made possible by having a cc stored in RTP|One is supported. This functionality includes direct to lift product configurations and native RTP|One payment plans. Capturing cc for refunds in the POS is also supported. Unfortunately, because Authorize.net is not a tokenized provider, Aspenware has not and will not support a number of advanced features, most notably Aspenware Payment Plans and Subscriptions. Also, Apple Pay, Google Pay, Pay Pal, and storing CC for future e-commerce purchases is not currently supported with Authorize.net.

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-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 nopCommerce 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 nopCommerce - 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.

Q: When a customer updates their credit card for resort charge from My Account, it isn’t working. What’s going on?

A: Unfortunately, Authorize.net doesn’t support this feature. See Step 3 above to hide the Resort Charge tab in My Account to avoid confusion.

Insert excerpt
AE:Like this Page ExcerptAE:
Like this Page Excerpt
nopaneltrue

...