Can I pre-fill customer information, which I've already collected, in the order process?

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
    • contact_company
    • contact_email
    • contact_phone

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

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 form POST. You will not directly be using the example HTML form POST below, but rather will need to generate its equivalent with some dynamic programming language, like PHP, JavaScript, C#/.NET, using the values you already have stored in your database. You must include inputs with values for operation, destination, and at least one product.

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="julie@testcompany.com"/>
<input name="contact_phone" value="8885551212"/>
</form>

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. 

Example URL:

https://sites.fastspring.com/julie/instant/fontmaker?contact_fname=TestFirstName&contact_lname=TestLastName&contact_company=Company%20ABC&contact_email=julie@testcompany.com&contact_phone=8885551212

Information automatically captured in order process:

97.png

Have more questions? Submit a request

Comments

Powered by Zendesk