Prefill Form Fields (query strings) | Payment Page Documentation

You can easily prefill form fields on the payment form with the query strings and parameters below.

Examples#

You can read all about how query strings and their parameters work in the details below, but in the meantime, here are some examples you can copy/paste.

Let's say you want to accept a credit card payment from Stripe for $99/month and you already had that plan set up on your payment form. Here's the query string combination you would send to your customer or link on your site:

https://your-domain.com/?gateway=stripe&method=ccard&currency=usd&frequency=m_1&amount=99.00

Let's say you want to accept a custom invoice amount for €59.99, you've created a custom field labeled "Invoice ID" on your form, and you want to select SEPA as the payment method to be used automatically. You would give this link to your customer:

https://your-domain.com/?gateway=stripe&method=sepa&currency=eur&frequency=one-time&amount=59.99&invoice_id=xyz123

List of Query Strings and Parameters#

Here are all the query strings and their possible parameters, along with some examples and important notes.

Query String	Parameters	Notes
?email_address	Any email address
?first_name	Any string
?last_name	Any string
?gateway	stripe, paypal	* The ?gateway parameter must be used in conjunction with the ?method parameter.
?method	Stripe methods: ccard ach_direct_debit (Pro only; Stripe Financial Connections) sepa apple_pay google_pay alipay wechat PayPal methods: standard_checkout	* The ?gateway parameter must be used in conjunction with the ?method parameter. * Method availability is also constrained by the gateway, form settings, plan, account, country, currency, browser/device, HTTPS/domain requirements, and recurring eligibility.
?currency	Any 3-digit currency code. E.g. - usd, eur
?frequency	d_1 <- Daily w_1 <- Weekly m_1 <- Monthly m_3 <- Quarterly m_6 <- Every 6 months y_1 <- Annually y_3 <- Every 3 Years one-time <- One Time
?amount	Any currency value with or without a decimal. E.g. - 99.00	Match the currency, amount, and frequency to preselect a specific plan. Otherwise, the ?amount prefills the Custom Amount field.

Special Parameters#

Match Field Label#

If you've added a Custom Field on your payment form, you can prefill the field.

All you need to do is match the parameter to your field label by simplifying the label without any capitalization and using underscores instead of spaces.

For example, if your Custom Field Label is Invoice ID, then your query string should look like this:

your-domain.com/?invoice_id=xyz123

Replace xyz123 with whatever Invoice ID you actually want to record for the payment. For a Stripe payment handled by the released integration, the submitted custom-field value is included with the payment metadata. Verify the result on a test payment in your own Stripe account. Stripe controls its Dashboard interface, so this page does not use an outdated provider-dashboard screenshot as plugin evidence.

Unmatched Strings#

Any query strings that are unmatched to your form fields can be passed as an HTTP Request. Please read the corresponding documentation about setting up HTTP Requests on the form.

Http Requests