WP Simple Pay Documentation

Documentation, Reference Materials, and Tutorials for WP Simple Pay

How to Create Your First Payment Form

Now that you’ve installed WP Simple Pay, activated your license (if you purchased the Pro version), and connected your Stripe account, it’s time to create your first payment form.

Login to your WordPress admin, then go to WP Simple Pay → Add New. This will launch the payment form template explorer. For this example we will use the Payment Form template.

Select a template

Click on “Use Template” and the payment form editor will open using the payment template defaults.

Customizing General Options

In the General tab you can change the payment form’s Title, Description, Type, and Payment Confirmation settings.

Our selected Payment Form template creates an on-site embedded payment form and redirects users to the global confirmation page.

Customizing Payment Options

Select the Payment tab to adjust the available price options, and how your payment form accepts payments.

Go ahead and adjust the amount to be collected, or currency:

In this example, we will use a One-Time $15.00 amount. If you would like to offer more than one price option, simply click “Add Price” to add an additional price. When more than one price option is offered you may optionally set a custom label that is displayed when the price selector is output:

Next, enable the Payment Methods you would like to use to accept payments. To keep things simple for our first form, we will stick with a “Card” payment method:

Customizing Form Fields

Next, select the Form Fields tab. This is where you can add custom fields to facilitate collection of additional data, or output more information about the purchase.

If you haven’t already, go ahead and click the “Save Draft” button on the right-hand side of the screen to save the form before moving on.

When you selected the “Payment Form” payment template, these four fields were added to your form automatically:

  • Email Address
  • Price Selector
  • Payment Method
  • Checkout Button

Let’s go ahead and add one more custom field: a field to collect the customer’s name. Click Choose a field and select Name, then click Add Field to add it to the form.

Using the drag handle on the left side of the custom field, move the “Name” field above the other custom fields. Additionally, we can set the Label setting to Full Name and mark the field as Required.

For more information about custom fields, review the “Custom Form Fields” documentation.

Advanced Form Features

Since this is your first payment form we will not be discussing the advanced form features listed below. However, when you are ready, follow the links below to find out more information about these features.

Adding Your Payment Form to a Page

If you preview the payment form at this point, it should look similar the form below. Of course, your form title and description will be different if you changed them previously.

Payment form

Once you like how your payment form looks, make sure it’s published, so you can add it to a page.

While editing an existing page or after creating a new page, insert a new block and search for the “WP Simple Pay” block, then select it to add this block to the WordPress block editor.

Add form block

After the block is inserted, you’ll need to select which payment form you want to add to the page from a dropdown.

Select payment form

Once you select a payment form, a visual representation of the form will be displayed. Now you can continue editing the page as needed.

Add a Form with the Classic Editor or Non-block Theme

If you’d like to add a payment form using the “classic editor”, or if you are using a theme that doesn’t support using blocks, you can copy the shortcode from the payment form list, and embed the shortcode on any page.

Copy shortcode

Making A Test Payment

At this point you should still be in Test Mode unless you specifically disabled it. Read more about using Test Mode.

Now you are ready to view your form and make a test payment. While in Test Mode you can use any number of test card numbers provided by Stripe.

NOTE: Stripe provides international test card numbers that should be used to properly reflect the appropriate ZIP/Postal code configuration for your country or locale. For example, the 4242-4242-4242-4242 test card number is considered a US-based number and will display a 5-digit ZIP Code field.

Once you’ve submitted the payment form, Stripe will process the test payment, and you will see the default payment confirmation page. Read more about customizing the payment confirmation display.

You’ve created & tested your first form! Now what? See our list of “What Happens After A Payment” articles to learn what you can explore next.

If you are satisfied with the results of testing your form, you can take your form live so that it can begin processing live payments.

Still have questions? We’re here to help!

Last Modified:

Start Accepting Payments Today

Start accepting one-time and recurring payments or donations on your WordPress website.