This article is for an older version of the plugin
If you're looking for the latest version of the documentation, click here

Creating a one-time payment form

A step-by-step guide about creating a one-time payment form for selling one-off products.

Introduction

In this tutorial, we’ll show you how to create and customize a one-time payment form.

Creating a one-time payment form in 8 easy steps

We recommend going through the following steps:

  1. Switch to test API mode
  2. Create products/prices on the Stripe dashboard
  3. Create form
  4. Add products to form
  5. Insert form shortcode into a page
  6. Test-drive form
  7. Customize form
  8. Switch to live API mode

1. Switch to test API mode

This tutorial assumes that you’ve already configured your Stripe API keys.

You can switch to test mode on the “Full Stripe / Settings / Stripe account” page in WP admin:

Switch the plugin to test API mode

2. Create products/prices on the Stripe dashboard

Do you plan to sell products on the one-time payment form?
If you have a different use case - like paying invoices - then you can skip this step

You can add one-off products on the Stripe dashboard.
Make sure that you’re in test mode also in Stripe.

Go to the “Products / Overview” page, and press the “+ Add product” button:

Create one-off products on the 'Products / Overview' page on the Stripe dashboard by pressing the '+Add product' button

Fill in the essential fields of the product and price, and press the “Save product” button:

When creating a Stripe product, fill in the essential fields, and press the 'Save product' button

Please make sure that:

  • The product name is entered
  • Standard pricing is selected as the pricing model
  • One-time price is selected as the price type

You can create price variations for your product, and you can create as many products as needed.

3. Create form

You can create a one-time payment form on the “Full Stripe / Forms” page in WP admin, by pressing the “Add form” button:

Create a new form by pressing the 'Add form' button on the 'Full Stripe / Forms' page

On the next page, enter form name and display name, and select a form layout, and press the “Create & edit form” button:

You can enter name and display name for the one-time payment form, plus select the form layout

You can compare and learn the difference between form layouts here.

4. Add products to form

Once your newly created form is saved, you’re redirected to edit the form.

Do you plan to sell products on the one-time payment form?
If you have a different use case, then go to the ‘Use cases’ section

You can add your products to the form on the “Payment” tab by pressing the “Add products from Stripe” button:

Press the 'Add products from Stripe' button on the 'Payment' tab to add products to the form

The dialog fetches the products from Stripe, you can select several products, and add them to the form at once:

You can select several one-time products, and add them to the form at once

When the form is saved, you’re ready to try it out.

For all customization options of the form, please go to the Customization section.

5. Insert form shortcode into a page

You can obtain the form shortcode on the “Full Stripe / Forms” page.

Please visit our dedicated knowledge base article on how to use shortcodes.

6. Test-drive form

Once the form shortcode is inserted into a page, you can open the page, and test your form.

The form is fully-functional in test mode, and you can make payments using test cards to simulate every possible payment outcome.

No need to refund your payment after testing either.

7. Customize form

Now that the form is up and running, you can customize the form if needed:

8. Switch to live API mode

When you’re ready to go into production, there are only two things left to do:

  1. Copy your Stripe products to live mode
  2. Switch the plugin to live mode

You can flip the switch on the “Full Stripe / Settings / Stripe account” page in WP admin:

Switch the plugin to live API mode

Still not finding the solution?

Our support team is happy to help you.

Contact support

Feature requests are always welcome!
We consider each feature request carefully, and examine how it fits the roadmap for the plugin.