This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)
The Custom Orders feature lets you create a pre-populated shopping cart for a specific customer, and provides a link you can email to the customer. Each custom order can contain any number of products, and pricing can be overridden or coupons can be applied. You can also pass custom order tags (e.g., for inclusion in webhooks or API responses) and override the customer's default country and currency using custom orders.
Creating a Custom Order
To create a custom order, select the Activity menu of the Dashboard, and then select the Orders tab. Click the link for the Custom Orders page, on the left-hand side.
Clicking opens the Create Custom Order popup dialog.
- Title - This field is for internal use; enter a name that will allow you to identify the specific custom order.
- Products in the Order - Select this field and begin typing the name of the first product to be included in the order. You can then click to choose the desired product from the drop-down list that appears, and optionally specify the Quantity to be included in the order. Additional products can be added to the order in the same way. Once a product has been selected, you can optionally choose to override the product's normal price by selecting the Override unit price check box and entering the desired price in the applicable currency.
- Assign Coupon to the Order - If desired, an existing coupon can be applied to the order. Enter the coupon code (not the coupon path / ID).
Tags - Optionally, enter custom order tags as key / value pairings. These will be stored as part of the order record and return in the optional wehbooks (e.g. order.completed) and API responses.
NoteThe sum of the number of characters entered into the Key and the Value fields must not exceed approximately 4,000 characters.
Customer Information - The customer's First Name, Last Name and E-mail address are all required fields when creating a custom order. You can optionally provide the customer's Phone Number and Company. You can also select a specific Customer Country and Order Currency if desired; otherwise, the Storefront's default currency will be used.
TipIf you enter the email address of a customer that already has a FastSpring account with you, the First Name, Last Name and Company (if any) that you enter for the custom order will overwrite / update the existing customer account record.
Once the information is complete, click ADD and the newly created custom order will appear in a list under custom orders.
Providing the customer with a link to the custom order
For any custom order that is currently Enabled - meaning the order has not yet been processed and has not been disabled - you can click the gray URL field to obtain the custom order's complete URL, which can then be provided to the customer as a link.
Disabling and deleting custom orders
Once a complete transaction has been processed via the custom order's URL, the custom order's status will change from to . If you need to temporarily disable an enabled custom order, click the drop-down next to and select Switch to .
You can also click the DELETE command to permanently delete a custom order; any associate transaction that has previously been processed will not be affected.