Versions Compared

Key

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

...

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

1. POS TASKSTasks

  • Decide if you are syncing credit cards to RTP|One. (Tokenized RTP|One DB required)

    Status
    colourRed
    titlerequired

  • 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

  • If storing primary CC for resort charge and DTL, ensure resort charge Authorization and other configuration is complete.

    Status
    colourBlue
    titleOptional

Status
colourGreen
titledetailed setup

2. INFRASTRUCTURE TASKS. 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 '

    AllowTransferofCC
    • AllowStorageofCC' from false to true and give it a test. 

      Status
      colourRed
      titleREQUIRED

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

    Status
    colourRed
    titleREQUIRED

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

    Status
    colourRed
    titleREQUIRED

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

    Status
    colourRed
    titleREQUIRED

Status
colourGreen
titledetailed setup

3. SET UP PAYMENT PROVIDERPayment Provider Tasks

  • Set up Payeezy and Complete Configuration to allow your Aspenware Commerce test and prod stores to use your sandbox and production Payeezy.

    Status
    colourRed
    titleRequired

Status
colourGreen
titledetailed setup

2.

COMMERCE TASKS

Commerce Tasks

  • Set up GL report with your Aspenware Representative.

    Status
    colourRed
    titlerequired

  • Configure Aspenware Commerce Payment Gateway

    Status
    colourRed
    titleRequired

Status
colourGreen
titledetailed setup

Detailed Setup Guide

Insert excerpt
AE:Detailed Setup Guide Excerpt
AE:Detailed Setup Guide Excerpt
nopaneltrue

POS

...

Tasks

  • Decide if you are syncing credit cards to RTP|One. (Tokenized RTP|One DB required)

  • 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

  • Follow Payeezy getting started guide: https://support.aspenware.com/en/support/solutions/articles/42000064327-getting-started-with-payeezy

  • Set up a merchant account on the Payeezy site to get a Merchant ID.

  • Contact Aspenware Representative to set up an API dev account.

  • Add Merchant to Aspenware dev account by emailing Payeezy. Email payeezyboarding@firstdata.com to request having the client added as a merchant on our dev account. Include:

  • Payeezy will confirm the request and follow up with an email (May take a few days)

  • Then, Submit PaymentJS integration request following these steps under Step 4 in this guide exactly

  • When integration request complete, Email Payeezy to Confirm Values Match Merchant account values. (only required if issues with payment)

  • Once done Aspenware will get API credentials from dev account. 

    • Get API key from Payeezy:

      • Go to the Admin tab

      • Click on terminal

      • Pull the API access info and the gateway ID information to give to Aspenware so we can configure it to your website. If you cannot remember your password,  you can call the Payeezy Helpdesk at 855-448-3493 opt. 

      • Make note of this key for future Commerce configuration.

    key, API Secret, JS Key,and Token from the Payeezy developer account. 

  • Obtain TaToken from Payeezy and make note of this for future Commerce configuration. 

    • The transarmor token (tatoken) can be located in customer’s existing Payeezy account by logging in at https://globalgatewaye4.firstdata.com/terminal and clicking on the terminal to view the details. The TA token will be a 4 character code.

  • If using CVV2 verification (recommended)

    • Complete the steps within Step 7 in this guide.

  • Change Payeezy from test to live when ready: To process live transactions, your APIs will need to be configured as follows:

    • Log into https://developer.payeezy.com

    • Navigate to the “APIs” page

    • Select your API and then

    • “Edit <API>”

    • Make sure that ‘Live’ is checked.

...

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 the Configuration > Payment > Payment Methods page.

  • Click Edit on the Payeezy payment gateway.

  • Check Is active on the desired payment method and click Save.  Ensure that only the desired payment method is set to ‘is active.’

  • Select ‘Configure’ on the desired payment method. 

  • Complete the following fields:

    1. Use Sandbox: - Should be checked for ‘test’ and unchecked for ‘prod’

    2. API Key: Obtained in previous step above orget from Payeezy Obtain from Aspenware Payeezy developer Account

    3. API Secret: Obtain from Aspenware Payeezy developer Account

    4. JS Key: Obtain from Aspenware Payeezy developer Account

    5. TaToken: Obtained in previous step above or get from Payeezy Resort’s Payeezy account.

    6. Token: Obtain from Aspenware Payeezy

    7. URL: Obtain from Payeezy

    8. developer Account

    9. Requires Billing Address: This is likely required, so check to make sure it is collected for checkout.  

    10. Requires Phone Number: Check if phone number is required at checkout.

  • 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; I set up address verification settings in my Payeezy portal and it’s not enforcing AVS for online orders.

A: We support CVV2. (Set up guide within Step 7). We don't support AVS. This change occurred when we updated to the new, more secure version of the Payeezy integration (payments.js).

Q: Why is it required to close the store every-time Aspenware does a deployment because I am on Payeezy?

A: As part of Aspenware’s push certification process a live credit check and confirmation is required before we “flip” the new version live. Typically Aspenware will run these tests in a staging environment prior to flipping the code live, however, because Payeezy has added security measures that require that the domain a payment is made from match the prod domain (i.e. shop.yourresort.com) this check cannot be made in staging. Our process for this check for Payeezy customers is to flip the new code live, close the store, run the transaction. As soon as the resort accounting contact confirms that they see the transaction in the Payeezy gateway, we open the store back up.

Q: We have been hearing from guests that they can not use Discover cards to buy products online.  

Looks like you need to set the config to accept Discover cards:

​See Step 8c: https://docs.google.com/document/d/1vgCMI3bYbUNYWVL4gtMcgLggubwelRp99o3qGaoKTHk/edit?usp=sharing

Uncheck the S code on cvv2 filters if you want to accept Discover (in Payeezy):

...


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

Q: I’m moving to tokenization in RTP|One, what’s the process for syncing the tokens from the e-commerce store to RTP|One for resort charge and returns?

A: Step 1: Resort needs to tokenize their RTPOne db.

Step 2: Once that is done, we will need to update the Azure appsettings to 'AllowTransferofCC' from false to true.  The credit-related settings in the UnityPeakProd rtp-config.json should also be validated when that switch occurs.  

Step 3: Test it. Testing should include verifying the RTP Credit Card Profile visually looks correct and that the data in the PaymentCardToken table looks good.  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).

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

...