Skip to main content

How to pre-fill checkout parameters

Learn how to pre-fill checkout fields using query parameters to create customised payment links in Legl Pay.

Written by Tess Brown
Updated over a week ago

Overview

Pre-filling checkout parameters allows you to customise your Legl Pay checkout links by automatically populating specific fields. This is useful when sending payment links to clients, as it reduces input errors and streamlines the payment experience.

No additional setup is required if you are already using Legl Pay.


How to pre-fill checkout parameters

Follow these steps to configure your checkout link using query parameters:

1. Start with your base checkout URL

Use your firm’s checkout URL. For example:

https://lawfirm.legl.com/pay/checkout

2. Add a question mark (?)

Add a question mark (?) to the end of the URL to indicate that parameters will follow:

https://lawfirm.legl.com/pay/checkout?

3. Add your first parameter

Use the relevant key for the field you want to pre-fill:

  • Invoice Reference: i

  • Matter Reference: m

  • Custom Reference: c

  • Amount: a

Follow the parameter key with an equals sign (=) and then the corresponding value. For example, to pre-fill an invoice reference:

https://lawfirm.legl.com/pay/checkout?i=LGL0023

4. Add additional parameters (if required)

To include more than one parameter, use an ampersand (&) between them.

For example, to pre-fill:

  • Invoice Reference: LGL0023

  • Amount: 1042.50

Your final URL would be:

https://lawfirm.legl.com/pay/checkout?i=LGL0023&a=1042.50

5. Share the customised link

Send this link to your client via email, SMS, or through your billing system.


What happens next

When your client opens the customised link:

  • The specified fields will be automatically populated.

  • Any pre-filled fields will be locked in read-only mode.

  • The client will not be able to edit those values.

Each parameter operates independently, allowing you to include only the fields you require.


Example uses

You may use pre-filled checkout parameters in the following scenarios:

  • Pre-filled client payment links
    Include invoice, matter, or custom references to reduce errors and improve reconciliation.

  • Third-party billing system integrations
    Generate customised checkout links directly from your billing system without requiring technical development resources.

This provides a more seamless and efficient payment experience for both your firm and your clients.


Important information

  • Pre-filled fields are locked and cannot be edited by the client.

  • Parameters must be formatted correctly (for example, using & between multiple parameters).

  • The amount should be entered as a numeric value (for example, 1042.50).

This functionality is available to all Legl Pay clients and does not require additional configuration.

If you need further assistance, please contact your Customer Success Manager or the Legl Support team at [email protected].

Did this answer your question?