WP Payment Pal Documentation
← Back to site

Quick Checkout Shortcode

The [wppal_checkout] shortcode is an alternative way to display payment forms. This guide covers its usage and options.

Reading time: 3 minutes | Difficulty: Beginner

Overview

The [wppal_checkout] shortcode is an alternative way to display payment forms. This guide covers its usage and options.

Prerequisites

  • At least one payment form created
  • Understanding of shortcode basics

Basic Usage

[wppal_checkout form_id="123"]

This is functionally equivalent to [wppal_form id="123"].

Shortcode Comparison

Shortcode Attribute Notes
[wppal_form] id="123" Primary shortcode
[wppal_checkout] form_id="123" Alternative shortcode

Both display the same form in the same way.

When to Use Each

Use [wppal_form]

  • Simpler syntax
  • Primary/recommended
  • id attribute

Use [wppal_checkout]

  • Personal preference
  • More descriptive name
  • form_id attribute

Examples

Standard Form

[wppal_checkout form_id="42"]

In Page Content

<h2>Complete Your Purchase</h2>
[wppal_checkout form_id="42"]

Multiple Forms

[wppal_checkout form_id="10"]
[wppal_checkout form_id="20"]

Attributes

form_id (Required)

The ID of the payment form to display:

[wppal_checkout form_id="123"]

Display Output

The shortcode outputs the same as [wppal_form]:

  • Embedded forms display inline
  • Overlay forms show button
  • Respects form type setting

Finding the Form ID

  1. Go to Payment Forms
  2. Find your form
  3. Check the ID column
  4. Use in shortcode

Where to Place

Page/Post Editor

  1. Add Shortcode block
  2. Enter shortcode
  3. Publish/update

Widgets

  1. Add Text widget
  2. Paste shortcode
  3. Save

PHP Templates

<?php echo do_shortcode('[wppal_checkout form_id="123"]'); ?>

Practical Examples

Product Purchase

<div class="product-checkout">
  <h3>Buy Now - $49</h3>
  [wppal_checkout form_id="55"]
</div>

Donation Widget

<div class="sidebar-donate">
  <p>Support our cause</p>
  [wppal_checkout form_id="33"]
</div>

Membership Signup

<section class="membership">
  <h2>Join Today</h2>
  <p>Get access to all premium content.</p>
  [wppal_checkout form_id="88"]
</section>

Mixing Shortcodes

You can use both shortcode types on the same site:

Page 1: [wppal_form id="10"]
Page 2: [wppal_checkout form_id="20"]

Both work fine simultaneously.

Shortcode Generator

In the form editor or forms list:

  1. Find the Shortcode column
  2. Copy the provided shortcode
  3. This gives you the correct format

Common Issues

Form Not Showing

  • Check form_id is correct
  • Verify form is published
  • Check form restrictions

Shortcode Displays as Text

  • Verify attribute syntax
  • Check for curly quotes
  • Ensure plugin is active

Wrong Form Displays

  • Double-check the form_id
  • Each form has a unique ID

Troubleshooting Steps

  1. Verify shortcode syntax
  2. Confirm form ID exists
  3. Check form is published
  4. Test without caching
  5. Check browser console

Best Practices

  1. Use consistent shortcode – Pick one style
  2. Copy from admin – Avoid typos
  3. Test after placing – Verify it works
  4. Document IDs – Know which ID is which

Which Shortcode to Choose?

For most users, either works fine. Choose based on:

  • What you remember easier
  • What documentation/tutorials used
  • Team preference

Both are fully supported.

What’s Next?