This article applies to Classic Commerce. (Looking for Contextual Commerce documentation?)
Go to SpringBoard's Store Home » Products and Pages » select a product » View Additional Page Linking Options. Only Option 6: Create Order API and Option 3: Short Order Process will allow you to pre-populate some of the fields in the order process based on information you might already have collected from the customer. No other order flows will allow you to pre-populate the fields.
Optional Customer Information:
Customer information may be passed in via these specific parameters:
- contact_fname: customer's first name
- contact_lname: customer's last name
Note: These are the only customer parameters available to be passed into the order process. There are no parameters for address or payment information. To use the pre-fill functionality, we require that you at least pass contact_fname and contact_lname. In other words, you cannot pre-fill a customer's email address without pre-filling the first and last name.
Sample Code - Option 6: Create Order API
Example Form POST:
<form method="POST" action="http://sites.fastspring.com/julie/api/order">
<input name="operation" value="create"/>
<input name="destination" value="contents"/>
<input name="product_1_path" value="/fontmaker">
<input name="contact_fname" value="TestFirstName"/>
<input name="contact_lname" value="TestLastName"/>
<input name="contact_company" value="Company ABC"/>
<input name="contact_email" value="firstname.lastname@example.org"/>
<input name="contact_phone" value="8885551212"/>
Sample Code - Option 3: Short Order Process
You can pre-fill values via a URL when using the Short Order Process, which begins all links with https. This option is limited to this order process because we want customer information to go directly to the order form. A few guidelines:
- The first parameter must begin with a ?
- Each additional parameter must be separated by an &
- Spaces can be accomplished with %20
In this example, the company ID is julie and the product's Partial URL Path Name is fontmaker. The shopping cart order form will be pre-populated with the customer's information for first and last name, company, email address, and phone number. If you do not want to pass in a value for one of these, omit the value from the URL.
Information automatically captured in order process: