WP Stripe Kit Lite
Wordpress Plugin

Can I collect a product id?

Yes. This is an optional data point that you can add to each single item checkout button.

Can I collect shipping information?

Yes. This plugin uses the Stripe checkout process to collect name, address, city, state and postal code. You can use your Stripe Dashboard

Is collecting shipping information optional?

Yes. Shipping information is an optional item for each checkout button.

Can I change the checkout button label?

Yes. Every checkout button can have a unique label.

Can add quantites?

Yes. Each single item checkout button allows you to include the price and optionally a quanitity. The default quantity is 1. The total is computed for checkout.

Are sales or VAT taxes computed?

No. You need to include these taxes in the price.

Can I customize the checkout button styling?

Yes. We use the Best CSS Button Generator. You can copy the CSS properties and paste to try different button styles. We also provide a way to restore the original button CSS as a fallback if you do not want to keep your changes.

Can I have multiple payment buttons on a single page?

Yes.

Can I test without using real payment cards?

Yes. You can set the plugin to test mode and your Stripe Dashboard will show all the transactions in the test mode view. Stripe offers valid and fail testing card numbers. See Stripe Testing Card Numbers.

How do I fulfill orders?

You use the Stripe dashboard to retrieve payment, email and shipping information collected during checkout for your order or service fulfillment. Stripe offers [Stripe Integrations](https://stripe.com/docs/integrations “Stripe Integrations”) that can pass data to email services like Mailchimp and shipping services like EasyPost.

You also can use Stripe to export the data so you can use it in spreadsheets or import it into other software.

Is this a shopping cart?

This is not a shopping cart. You can create checkout buttons for single purchases of one or a bundle of products and services.

Can I use this to make my WordPress website a subscription service?

No. This plugin allows you to accept payments for subscription plans you set up in Stripe. Stripe then handles the recurring billing. This does not integrate the Stripe subscription plan with your WordPress and it does not capture login information for memberships.

Can I make changes to a payment or issue refunds?

You can use your Stripe Dashboard to make changes to the payment and issue refunds. Changes to the payment are based on the Stripe terms of service.

Does the customer get a receipt?

Yes, you can configure customer receipts in the Stripe dashboard. They are sent via email.

How do I know when a payment is made?

You can configure your Stripe account to send you notifications of completed transactions.

What currencies are supported?

Multiple currencies are available. See the Stripe Currency FAQ. You can set each single order checkout button to currencies that Stripe supports. You set the currency when you create subscription plans in your Stripe Dashboard.

Secured Site

1. Stripe requires (Transport Layer Security) TLS 1.2 for pages excepting live transactions. This means that they should start with https://. This is traditionally know as (Secure Socket Layer) SSL. Your web hosting service can configure TSL 1.2 on your website for an annual recurring fee.

2. PHP 5.5 or higher is recommended for optimal security and customer confidence.

3. You need a Stripe Account. Its free to get.

The term “SSL” continues to be used colloquially when referring to TLS. In either case its function is to protect transmitted data which is great news for your customer’s security.

TLS 1.2 is needed to meet the Payment Card Industry Data Security Standard) PCI-DSS which is also great news for your customer’s security.

If you do not have TLS 1.2 installed for your website, you can immediately start using this plugin to create checkout pages in a test mode. Then you can switch to live mode payment processing without any changes to your checkout pages.

Secure Site Requirements Help

The best place to get help with requirements is from you website hosting company. Leading hosting companies provide a service to install the SSL for your website.

To test your website, Stripe recommends that you use the SSL Server Test by Qualys SSL.

WordPress site that are converted to secure sites can result in mixed content warnings in web browsers. This means that you do not see the lock on the web page or the lock indicates a warning. This is often due to images and plugins that are not using “https”.

Stripe Account

You need to setup an Account with Stripe.

A Stripe account can be setup for testing only. All you need is an email address. This way you can experiment with this plugin and Stripe without providing a bank account.

A Stripe accounts that take real money will require a bank account and an approval by Stripe. The following video from the Stripe course for more information.

1. Download the wp-stripe-kit-lite.zip plugin file to your local computer.

2. Upload the wp-stripe-kit-lite.zip plugin file to your WordPress website using the WordPress plugins screen “Add New” button.

Alternatively in your WordPress /wp-content/plugins/ directory create the wp-stripe-kit-lite folder. Then upload the files in the uncompressed folder to the wp-stripe-kit-lite folder on your web server.

3. Activate the plugin through the ‘Plugins’ screen in WordPress.

4. Use the WP Stripe Kit Lite menu choice to open the settings page. You need to add your Stripe API keys.

Stripe: Get Your API Keys.

Choose Account settings and API Keys tab

WordPress: Configure Plugin.

• Select WP Stripe Kit Lite.
• Enter the Stripe API keys.
• Set the Live mode to Off for testing and to On when you are ready to have customers make orders.
• Select the “Save Changes” button.

5. Begin using by adding shortcodes into your WordPress pages and posts for processing payments. See documentation for more information.

Shortcode

The plugin requires that you use the WordPress text view to enter the shortcode for each checkout button as follows:

[wp-stripe-kit-lite]

Shortcode Attributes

Then you customize the shortcode by adding shortcode attributes for example:

[wp-stripe-kit-lite template="checkout-button"]

Shortcode Syntax

Shortcode start with a left square bracket [ and end with a right square bracket ].

The shortcode name wp-stripe-kit-litealways appears after the left square bracket with no space.

Shortcode attributes use the attribute_name="value" format. Spaces before or after the “=” symbol are optional. Double quotes are needed for values.

Shortcode attributes must follow the wp-stripe-kit-lite shortcode with one space.

More than one space following the wp-stripe-kit-lite shortcode is optional.

The shortcode with all attributes must go on one line. No line breaks are allowed.

All shortcode attributes must be before the right square bracket.

Shortcode attributes can be added in any order you choose.

Shortcode attributes need to be separated by a space.

More than one space separating attributes is optional.

Multiple shortcode appearing on the same page do not share attributes.

Shortcode Attribute Reference

template

This determines the type of checkout button. Optional. Values: checkout-button | subscription-button Default: checkout-button. Version: 1.0.0.

template="checkout-button"

product_id

Your product id. Optional. Values: Your product id. Notes: Only applies to checkout-button template. Version: 1.0.0.

product_id="abc-123"

stripe_plan_id

The subscription plan id. Required for subscription-button template. Values: Your Stripe subscription plan id. Notes: Only applies to subscription-button template. See Stripe Dashboard Plan. Important to note that if you setup the plan in your Stripe dashboard under test mode, you also need to set up the plan in your Stripe dashboard under live mode. Version: 1.0.0.

stripe_plan_id="basic-a"

description

Description appearing on checkout form and in customer receipts. Optional. Version: 1.0.0.

[description="Joe's Pizza Making eBook $9.99"]

descriptor

Customer bank statement descriptor. Optional. Default: description. Notes: Limited to 22 characters. Only applied to checkout-button template. Version: 1.0.0.

 descriptor="Joe's eBook"

name

Your company name to appear on checkout forms. Optional. Notes: Recommended. Version: 1.0.0.

 descriptor="Joe's Pizza"

currency_code

ISO currency code. Optional. Default: USD. Values: ISO currency codes. Notes: See the Stripe Currency FAQ for more information. Version: 1.0.0.

 currency_code="AUD"

price

Price per unit. Required. Value: Price in format 9.99. Notes: This is multiplied by the quantity. The checkout-button template uses this to compute the amount charged if the customer completes the checkout. For both checkout-button and subscription-button templates this allows Stripe to authorize the purchase. The customer is always charged the subscription plan price for the subscription-button template. Version: 1.0.0.

 price="9.99"

quantity

Quantity multiplied by price. Optional. Default: 1. Notes: Values other than 1 applies only to the checkout-button template. It is always 1 for the subscription-button template. Version: 1.0.0.

 quantity="4"

checkout_button_label

Label on the button. Optional. Default: Checkout.

 checkout_button_label="Joe's Pizza Making eBook $9.99"

stripe_capture_customer_data

Have Stripe capture billing and shipping data on checkout. Optional. Values: true | false. Default: false. Notes: Customer email address is collected regardless of value. Version: 1.0.0.

 stripe_capture_customer_data="true"

msg_loading

Message appears where button renders while Stripe Javascript is loading. Optional. Values: Any string with or without HTML. Default: Loading … . Notes: Generally is not seen unless network is poor. Version: 1.0.1.

 msg_loading="Loading Button"

msg_submitting

Message replaces button while processing the payment. Optional. Values: Any string with or without HTML. Default: Processing … . Notes: Not seen if either success_url or fail_url attribute is included. Version: 1.0.1.

 msg_submitting="Submitting . . ."

msg_success

Message replaces button if payment is successful. Optional. Values: Any string with or without HTML. Default: Thank you for your order!’ Notes: Not seen if either success_url or fail_url attribute is included. Version: 1.0.1.

 msg_submitting="Your pizza kit order is approved.<br>We will email you shipping information shortly."

msg_fail

Message replaces button if payment is successful. Optional. Values: Any string with or without HTML. Default: Something went horribly wrong! Version: 1.0.1.

 msg_submitting="An unexpected error occurred.<br>Contact support."

success_url

URL to redirect if checkout is successful. Optional. Values: true | false. Default: false. Notes: If false, the button is replaced with the msg_success attribute value. Version: 1.0.0.

 success_url="http://www.my_site.com/ebook-success-page"

fail_url

URL to redirect if checkout is unsuccessful. Optional. Values: true | false. Default: false. Notes: If false, the button is replaced with the msg_fail attribute value. Possible reasons for failed checkout include lack of internet access and declined payment. Check you Stripe Dashboard Log to investigate reasons. Version: 1.0.0.

 success_url="http://www.my_site.com/checkout-failure-page"

Shortcode Examples

Example #1: Checkout for EBook Purchase

In this case no customer data is captured and you plan to email the ebook or a link for the customer to obtain it. This is using the Austrian dollar for currency.

[wp-stripe-kit-lite template="checkout-button" product-id = "pie-book" name="Joe's Pizza" description="Joe's Pizza Making eBook $9.99" currency-code="AUD" descriptor="Pizza Making eBook" price="9.99" quantity="1" checkout_button_label="Joe's Pizza Making eBook $9.99"]

Example #2: Checkout for Mailed Product Purchase

In this case customer data is captured and you plan to email the ebook or a link for the customer to obtain it. This is defaulting to the US dollar for currency.

[wp-stripe-kit-lite template="checkout-button" name="Joe's Pizza" product_id="pie-s" price="39.99" quantity="1" description="Joe's Pizza Making Kit" descriptor="Pizza Making Kit" checkout_button_label="Joe's Pizza Making Kit $39.99" stripe-capture_customer_data="true" msg_success="Your Pizza Making Kit is being processed.<br>We will email you shipping information shortly."]

Example #3: Checkout for Mailed Product Purchase

This shows using the quanitity of 2 for an item priced at $4.99. The checkout will show $9.98 and the customer is charged that amount.

[wp-stripe-kit-lite template="checkout-button" name="Joe's Pizza" product_id="pie-s" price="4.99" quantity="2" description="Joe's Pizza Making Kit $4.99" descriptor="Pizza Making Kit" checkout_button_label="2 Joe's Pizza Pro Pans $4.99" stripe-capture_customer_data="true"]

Example #4: Subscription

In this case the customer is subscribing to the subscription plan “basic-a” that you setup in your Stripe Dashboard. The currency is US dollars.

[wp-stripe-kit-lite template="subscription-button" name="Joe's Pizzas" stripe-plan-id="pizza-basic" price="9.99" description="Pizza of The Month Subscription" checkout_button_label="Subscribe" stripe-capture-customer-data="true"]

Support for this plugin is handled on the WordPress plugin page for WP Stripe Kit Lite.