Setup Checklist

Prerequisite Tasks

Arrive Tasks

• This function requires synchronization with Arrive/Parkwhiz and Hoorooh. If Arrive/Parkwiz or Hoorooh is down, or cannot connect for any reason, parking cannot be sold through Aspenware Commerce.

  While the integration with Hoorooh does act as a middle-layer enabling higher volumes to shop for Arrive Parking products at once, Arrive Parking does limit the number of times their data can be accessed, which could cause some orders to fail.

  1. Configure resort in Arrive Parking with Aspenware’s generated endpoint and key. Get these values from Configuration > Local Plugins. Locate the “Arrive Parking” plugin and click Configure. (Must configure configuration steps below)

  2. The API Key is listed in a read-only field at the bottom of the screen and can be regenerated by clicking ‘Generate New Webhook Key.' Make sure you select 'Save Settings’ after generating a new webhook key or making any changes to configuration values on this page.

  3. When sharing this with Arrive Parking, ensure that they add this API Key in a header called ‘parkwhiz-auth.'

• The refund URL provided to Arrive Parking is always "https://<site url>/arrive/bookings/cancel", where "<site url>" would be your resort domain, i.e. 'shop.resort.com.'

• The URL and API Key values will be different between production and test, with test values configured in the Arrive Parking sandbox environment and production values configured in production.

• Provide Aspenware with the following values from Arrive Parking.

  • Arrive URL (production and sandbox)

  • Client ID (production and sandbox)

  • Client Secret (production and sandbox)

  • Coupon Code (may be different between production and sandbox)

Hoorooh Tasks

• Provide Aspenware with Hoorooh’s endpoint(s) and key(s) specific to the resort.

  1. Availability URL (production and sandbox)

  2. Availability API Key (production and sandbox)

Infrastructure Tasks

• Install and Configure the Arrive Parking Plugin

  1. Go to Configuration > Local Plugins and change the “Group” filter to “Aspenware.”

  2. Locate the “Arrive Parking” plugin and click Install.

  3. Restart the application by clicking the green Restart application to apply changes button.

  4. Once complete, ensure the application is installed and enabled

Detailed Setup Guide

1. Configure Arrive Praking Plugin

2. Verify Payeezy is Installed and Active

3. Create Category for the Parking Product

4. Create Product for the Parking Product

5. Configure Arrive Parking Refund Email Template (Optional - only with Payeezy)

6. Add a Customized Parking Sales Report (Optional)

1. Configure the Arrive Plugin

• Go to Configuration > Local Plugins and change the “Group” filter to “Aspenware.”

• Locate the “Arrive Parking” plugin and click Configure.

• Configure the following fields: Note that these will be different between test and prod.

  1. Availability Url: Input URL obtained from Hoorooh.

  2. Availability Api Key: Input key obtained from Hoorooh.

  3. Arrive Url: Input URL obtained from Arrive.

  4. Client ID: Input Client ID obtained from Arrive.

  5. Client Secret: Input Client Secret obtained from Arrive.

  6. Arrive Coupon Code: Input Coupon Code obtained from Arrive.

  7. Arrive API Scopes: Input ‘partner’

  8. Refund Webhook API Key (Shared with Arrive Parking): Click Generate Key to populate this field. ONLY CLICK GENERATE KEY ONCE. This is a key generated by Aspenware Commerce for each store, and must be provided to Arrive, along with the refund URL, to complete the configuration. Note that refunds are only available to resorts using Payeezy as a payment provider.

• Click Save Settings.

2. Verify Payeezy is Installed and Active

• Go to Configuration > Payment Methods and search for Payeezy. Check to make sure that Is active is checked if you are using Payeezy as a payment gateway.

  

3. Create Category for the Parking Product

• For details on configuring a category, see the documentation on Configuration: Categories

• Choose a name for your category that is best for your resort, examples include Parking, Paid Parking, Reserved Parking, Parkwhiz Parking.

4. Create Product for the Parking Product

• Create a product shell following the instructions in the documentation for Configuring Products and then include the following specifics for Arrive Parking.

  1. Short Description: Enter the short description for the product. Note that HTML and Long Descriptions are not supported for Arrive Parking products and can cause PDP issues if used.
     

     

  2. Email description: Input the email content HTML messaging that guests should receive when purchasing this product. Guests will receive two emails, one from Aspenware for the order confirmation and a second from Arrive to manage their parking reservations. The Arrive email is controlled within Arrive’s platform.
     

     

  3. Published: Check to enable.

  4. Product tags: Enter tags if you want them displayed in the classification window.

  5. Product Template: Set to “Arrive Parking Product”, then click Save and Continue Edit. This will automatically generate the majority of required attributes for the product.
     

     

  6. Pictures: This product requires two images. Product images should follow standard product specifications - 1700 x 700 px and 275 KB. The remaining lot images are populated from Arrive and must be managed from the Arrive platform.

     1. The first product image that is uploaded is displayed as the product card image and also as the main product image on the PDP when the screen is scaled to display the image.

     2. The second image uploaded is displayed as the parking map image and is required to have the Title set to “Parking Map”.
        

        

  7. Product Attributes: The majority of attributes will automatically be added after the product template “Arrive Parking Product” is saved. Start Date will need to be configured manually with Text prompt [Date], Is Required DISABLED, and the Control type set as “Date Picker”.

• Price: Scroll down to the Price section on the Product detail page (PDP) and enter a value for Price. Parking pricing is supplied from Arrive via the API. The only price you need to define is the lowest price the parking is available for, so that it populates correctly when displayed with the label “STARTING AT”.

5. Configure Arrive Refund Email Template (Optional - Only with Payeezy)

• To configure the Arrive Refund email template go to Content Management>Message Templates and Edit to edit the ‘ArriveParkingRefund.CustomerNotification’ email template. 

• To edit the email HTML, go to Tools>Source Code and adjust the HTML from there in the Source code window. In the body portion of the email template, paste the following code and customize as desired.
  

  %Store.Name%. Order #%Order.OrderNumber% refunded <p><a href="%Store.URL%">%Store.Name%</a> <br /><br />Order #%Order.OrderNumber% has been just refunded<br /><br />Amount refunded: %Order.AmountRefunded%<br /><br />Date Ordered: %Order.CreatedOn%</p>

  Copy

• For more details on email configuration, refer to: https://hub.aspenware.net/main/Configuration:-Emails.1251868693.html

6. Add a Customized Parking Sales Report (Optional)

• In order to track revenue recognition across disparate fulfillment systems, contact your Aspenware Representative to add a customized parking sales report.

• Once added, go to nop4you > SQL REPORT MANAGER > Reports. There are 3 reports available for Arrive Parking:

  1. Online Prepaid Parking Export

  2. Online Prepaid Parking Refunds

  3. Online Prepaid Parking Export with Cancels
     

     

• Select Aspenware Reports>[Report Name] and enter/select the following:

  1. Enter from date and To date: This is the date range for the report you’d like to see.

  2. Select Payment Status: This enables the selection of the types of transactions you’d like to see.

  3. Click Generate or Export to Excel.
     

     

The report will list all relevant data for the Arrive Parking transactions.