Collapse Menu
Docs Home
Extensibility Options
Contact Support

Vendor Notifications

Overview

This article teaches you how to use the Vendor Notifications feature.

The Vendor Notifications feature allows you to configure customizable email messages that FastSpring will send to you (or to specified third-party email addresses) each time certain triggering events occur. For example, you can configure a custom notice to be sent to a specific email address (or a list of addresses) each time a specific product is purchased. 

You can also configure the email addresses to be used for all other (non-custom) messages from FastSpring to you via the Email Settings menu.

To configure Vendor Notifications, click the Settings menu in the FastSpring App and then select the Email Settings tab.

 

Default Settings

The Default Settings section displays the primary contact email address for the account by default.

You can click the EDIT command to configure the following settings:

SettingDescription
Outbound BCC Address

Optionally, specify one or more email addresses to be BCC'd on all outgoing customer-facing email messages (e.g., new order receipts and fulfillment email messages).

 Tip

It is a good idea to enter an exclusive email address that is only used for this purpose. Or, create a mail routing rule to file these messages automatically. Entering an address here results in all customer-facing messages being copied to the specified address(es).
Primary Account ContactView and edit the First NameLast Name, and Email address of the primary contact person for your account. (This affects all of your Stores, not just the current one.)
Store Notification Addresses

If your account has more than one Store, you can configure separate Default Email Addresses and Alert Email Addresses for each Store.

  • Default Email Address - Enter one or more email addresses (use commas to separate multiple addresses) to be used for all Store notifications by default.
  • Alert Email Address - Optionally, enter separate email addresses to be used for particular alert messages (e.g., low license availability). If you specify one or more Alert Email Addresses, FastSpring will not send alert messages to the Default Email Address(es). However, all other Store messages will still be sent there.

 

 

Custom Emails

The Custom Emails section lists all custom vendor notifications (there are none configured by default). It allows you to add new notifications or edit notifications you have previously created. In the example image below, we have already created a custom notification to be sent when returns are completed for a specific product.

 

To Configure a Custom Vendor Notification

You can create new vendor notifications using the following process. The images below provide an example of creating a notification to be sent when a particular product is purchased.

  1. Click ADD in the Custom Emails section. The Setup page appears.


     
  2. Click the drop-down selector for the Event Type and choose which type of event will trigger messages via this notification.


     
  3. Click Next. This completes the creation of a basic notification. Next, you can customize it.
  4. Three pages of options become available: GeneralConditions, and Advanced. You can click  at any time (on any page) to save your changes.
  5. The Custom Email Template section, which contains the notification template that controls the content of the messages, appears at the bottom of all three pages.


     
  6. Context-specific help is available based on the Event Type selected in step 2. In this example, clicking the order link opens a popup window that lists some of the order object variables you can reference in the Contents of the notification.

     Tip

    If you need to include order tags in a template for the Order Completed event type, enter #{order.customList} in the Contents field of the template.

    If you need to include product attributes in a template for the Order Completed event type, enter #{baseItem.customList} in the Contents field between the <repeat value="#{order.baseItems}" var="baseItem"> and the corresponding </repeat>.
     
  7. The Subject field lets you control the subject line of messages to be sent via this notification.
  8. The Contents area lets you control the actual contents of messages to be sent via this notification.
  9. On the General tab, the Name field lets you optionally enter a name for the new notification.


     
  10. The Email Address List field lets you optionally enter one or more email addresses to which messages are to be sent via this notification. If you enter more than one address, use commas to separate them. If you leave this field blank (which is the default value), FastSpring will send messages for this notification to the default address for the Store.
  11. The Conditions page allows you to configure the specific circumstances under which messages are to be sent for this notification. In the Applicable Site field, you can click the drop-down and select the Store to which the notification applies (or select Applies to all to have the notification apply to all Stores).


     
  12. In the Rule Applicability field, you can specify whether the notification applies for Rebills Only (meaning automatic scheduled subscription transactions), Non-Rebills Only (meaning new orders), or all orders (Always Applies).
  13. The Products field lets you specify the products to which this notification applies. Optional: You can click Add Product to open the Add Product popup window. There, you can click a drop-down selector to choose a specific product and then click Add.


     
  14. You can specify more than one product by repeating this step. If you do not specify any product, then the notification applies to all transactions matching the selected Event Type.
  15. The Condition Expression field lets you optionally enter an expression using logical evaluation to further narrow the circumstances under which messages are to be sent for this notification. As with the Custom Email Template section of the page, context-specific help is available based on the selected Event Type. In the example image above, clicking the order link would open a popup window that lists some of the order object variables you can reference in the Condition Expression.
  16. The Advanced page lets you control the character encoding for messages sent via this notification. Controlling the character encoding may be helpful in some cases when you plan to implement a script to parse the incoming notification messages. Click the drop-down selector for the Character Encoding field and select whether the messages are to use UTF-8 encoding (the default value) or ISO-8859-1 encoding.
  17. Click  when you have finished, to save your changes. The new notification appears on the Vendor Notifications page.


     

Try FastSpring

Get a free account and see why FastSpring is the ecommerce partner of choice for software providers around the world. Try our full-service ecommerce solution today to unlock revenue growth for your online company.