Versions Compared

Old Version 11

changes.mady.by.user Sarah Holst

Saved on

compared with

New Version 12

changes.mady.by.user Leigh Bush

Saved on

Key

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

This guide will review how to set up Ikon Pass Friends & Family in Aspenware Commerce. For more information general product setup (including discounts and hidden categories) see Configuring Products in the Aspenware Commerce Documentation or for general release notes, see {Link to Release Notes}.

...

Dev mode allows test users to see guest entitlement with more detail. This is not meant to be used in a production environment and should be unchecked when in production.

...

...

Descriptions and images

Feature Detail Header 1

Paragraph

Feature Detail Header 2

Paragraph

Configuration Guide

Prerequisite Steps

...

Infrastructure Tasks

Alterra must whitelist all resort IP addresses prior to component working Leigh Bush - create meeting to align

...

  • Install the IKON Friends & Family Plugin

    1. Go to > Aspenware Commerce > Configuration > Local Plugins

      1. Locate “IKON Friends & Family” under the Aspenware Group and select Install.

  • Once installed Enable the plugin by selecting Edit next to the listed plugin and ensure the Is enabled checkbox is selected.

  • Now that the plugin is ready to be configured, ensure that you have the product set up that will be used for the Ikon Friends & Family component. To do this:

    1. Set up the product as you would normally. (See Configuring Products for basic product setup.)

    2. Note the product ID in the URL on the product configuration page.

    3. Copy the product ID and add it to the Product ID field in Aspenware Commerce > Configuration > Local Plugins > IKON Friends & Family

  • Go back to the plugin (Aspenware Commerce > Configuration > Local Plugins > IKON Friends & Family) and select Configure.

  • Under the General tab enter the two-letter abbreviation for your resort (if you do not know this abbreviation contact your Ikon pass representative).

    1. (note to documents and service: currently this image is hard-coded, and may be removed for the deploy - regardless, no matter what is put there nothing changes)

    2. Select Save.

  • Go to the Language tab (second tab)..

    1. Enter the language you would like to appear in the bottom “toast” message when the responses noted above each text box are returned. See the example below.

    2. Select Save.

...

  • Go to the Ikon Login Configuration (third configuration tab).

    1. Enter the appropriate URL or endpoint as follows:

      1. Login Domain: https://account.ikonpass.com

      2. Login Endpoint: /login

      3. Redirect URI: resort-pdp-url/login-callback

    2. Select Save.

...

Note

IMPORTANT: For the redirect URI be sure to enter the URL from your resort’s PDP followed by “/login-callback”callback”. This will return the logged-in Ikon Pass guest to the appropriate page.

  • https://[url to your friends and family tickets here]/login-callback

  • For example: https://myresort.com/ikon-friends-and-family-tix/login-callback

  • Go to the Ikon Entitlement API Configuration (fourth configuration tab).

    1. Here you will get most values from your Ikon representative, while blackout dates will change according to year and pass type. See the image below for an example.

      1. Entitlements API domain: https://api.ikonpass.com

      2. Entitlements Client ID: provided by Ikon Pass

      3. Entitlements Token Endpoint: /token

      4. Entitlements Vouchers Endpoint: /v2/available-vouchers

      5. Ikon Pass Entitlement Type ID: this will likely be a three-digit number provided by Ikon Pass

      6. Ikon Pass Blackout Dates: provided by Ikon Pass

      7. Ikon Base Plus Pass Entitlement Type ID: number provided by Ikon Pass

      8. Ikon Base PlusPass Plus Pass Blackout Dates: provided by Ikon Pass

      9. Ikon Base Pass Entitlement Type ID: number provided by Ikon Pass

      10. Ikon Base Pass Blackout Dates: provided by Ikon Pass

      11. Ikon Local Pass Entitlement Type ID: provided by Ikon Pass

      12. Ikon Local Pass Blackout Dates: your local resort’s blackout dates

Info

NOTE: Blackout dates must be written in the following format mm/dd/yyyy.

...

  • Go to the Ikon Redemption API Configuration tab (fifth configuration tab).

    1. Enter the following values in the fields Note: The fields below will be prepopulated with default values for TEST. You will need to enter your Client ID and Secret provided by Ikon Pass and adjust the urls when deploying to production, (see example below):

      1. Redemption Api Domain:

        1. TEST: https://api-central-entitlements-uat.azurewebsites.net

        2. PROD: https://api-central-entitlements.azurewebsites.net

      2. Redemption Token Api Domain:

        1. TEST: https://api-identityserver4.azurewebsites.net

        2. PROD: https://api-identityserver4-uat.azurewebsites.net

      3. Redemption Client Id: provided by Ikon Pass

      4. Redemption Client Secret: provided by Ikon Pass

      5. Redemption Token Endpoint: /connect/token

      6. Redemption Single Voucher Endpoint: /v1/redemptions/manual

      7. Redemption Grant Type: client_credentials

      8. Redemption Scope: write_entitlements

      9. Redemption Type Id: 6

Common Troubleshooting guide

...