Documentation

It’s very easy to setup Buy Now for Stripe to help you process credit cards on your WordPress website.

All you need to do is register for a free account, connect Buy Now for Stripe to your Stripe account, install the Buy Now for Stripe WordPress plugin, and add a shortcode to a page on your site … that’s it.

Here’s information on each one of these steps:

Connecting your Stripe account

After you’ve registered for a free account, all you need to do to connect your account to Stripe is:

Install & activate the plugin on your site

Once you’ve completed the connection process then you’re ready to start using the Buy Now for Stripe plugin on your WordPress website.

Here’s how you can do that:

Download the current version of the plugin from your account and copy your Buy Now for Stripe API Key:

Install and activate it just like a normal WordPress plugin (either via “Plugins”->”Add New”->”Upload” in your WordPress admin or FTP)

Visit “Buy Now”->”Options” in your WordPress admin and paste the API (copied in step 1) into the “API Key” field:

Add the “Buy Now” Form Shortcode

Now that you’ve connected your account to Stripe and you’ve installed the plugin you can now start putting buy now forms anywhere on your site.

All you need to do is go to any post or page editor on your wordpress website and click this button to generate your Buy Now form shortcode:

This button will bring up this dialog which can be used to easily configure your Buy Now for Stripe Buy Now form shortcode:

Here’s a small video that will show you how easy it is to embed a payment form onto your website:

Options

termsrequired

This can be any text that describes the payment terms of what is to be purchased with the buy now button. This text will display on the payment information collection form.

descriptionrequired

This can be any text that describes what is being purchased with the buy now button. This text will display on the payment information collection form.

pricerequired

This indicates the price of the item being purchased. This is used by the payment processing system.

return_urlrequired

This is the url that the user will be redirected to once the payment has completed successfully. This is typically the thank you page that the [buy-now-thank-you] shortcode can be used on to display a thank you message.

cancel_urlrequired

This is the url that the user will be redirected to if they cancel out of the payment.

livemode

This determines whether test or live transactions will be run by the payment form. Can either be set to “true” or “false” — defaults to “false”.

sale_notice_emails

A comma separated list of valid email addresses that will be used to send admin sale notifications to. If this option isn’t set then no payment notification will go out to the admins.

button

The text that is used for the “Buy Now” button. Defaults to “Buy Now”.

currency

The currency to be used in this payment. Defaults to USD (for United States Dollars).

show_name

Indicates whether or not the first name / last name fields will show up on the payment form. Defaults to false.

show_address

Indicates whether or not the address fields will show up on the payment form. Defaults to false.

aweber

Indicates whether or not the AWeber signup checkbox will show up on the payment form. Defaults to false.

aweber_message

Determines what the message is that will appear with your AWeber signup checkbox.

aweber_list

Sets the name of the AWeber list you’re posting the customer info to.

mailchimp

Indicates whether or not the Mailchimp signup checkbox will show up on the payment form. Defaults to false.

mailchimp_apikey

Sets the Mailchimp API key you’ll be using with this form.

mailchimp_list_id

Sets the id of the Mailchimp list you’re posting the customer info to.

mailchimp_message

Determines what the message is that will appear with your Mailchimp signup checkbox.

The Buy Now for Stripe Thank You Page Shortcode

Here’s an example of a Buy Now for Stripe short code form:

[buy-now-thank-you]

This shortcode is only visible on a page that the Buy Now for Stripe payment process redirects to. This shortcode merely outputs the contents of the customer email on the thank you page.

Customer Email Customization

When a sale is made, Buy Now for Stripe will automatically send an email out to the customer. By default, this email is pretty much a receipt … but it can be customized very easily.

The variables available for replacement in this email message are:

{$first_name}

The first name of the customer.

{$txn_num}

The charge id of the Stripe transaction.

{$txn_date}

The date the transaction completed.

{$txn_price}

The amount of the transaction.

{$txn_desc}

The description of the transaction (whatever you setup in the payment form shortcode earlier)

{$txn_email}

The email address of the customer.

{$txn_buyer_name}

The full name of the customer.

{$txn_company}

The name of the company this transaction was paid to. This comes from the value you setup on your Buy Now for Stripe account page.

{$txn_receipt}

This will display the receipt table that appears in the default customer receipt email. This table displays the following data for the customer: name, price, description, payee (company), invoice (Stripe charge id), and email.

{$txn_shipping_info}

If shipping info has been selected in the shortcode, this will display any information collected for these fields.

{$buy-now-aws-url}

If the AWS access and secret key have been setup in the Buy Now for Stripe options, this will generate an S3 url in your email. Can actually embed options into this just like the accompanying shortcode that you can read about below

{$buy-now-aws-link}

If the AWS access and secret key have been setup in the Buy Now for Stripe options, this will generate an HTML link to an S3 url in your email. Can actually embed options into this just like the accompanying shortcode that you can read about below

Buy Now for Stripe AWS URL Shortcode

If the AWS access and secret key have been setup in the Buy Now for Stripe options, this will generate an S3 url in your email. Can actually embed options into this just like the accompanying shortcode.

AWS urls can be setup in 2 ways … either as expiring urls or urls that will be unaccessible after a certain number of downloads. You just need to specify the S3 Bucket the file is in and then the path within the bucket to the file.

Here’s an example of how you’d setup a url to a file on Amazon S3 that will expire in 60 minutes as a shortcode:

[buy-now-aws-url bucket="cool" path="myebook.zip" expires="60:00"]

Here’s an example of how you’d setup a url to a file on Amazon S3 that will expire in 60 minutes as a replacement (for use within the customer email):

{$buy-now-aws-url bucket="cool" path="myebook.zip" expires="60:00"}

Here’s an example of how you’d setup a url to a file on Amazon S3 that is good for 10 downloads as a shortcode:

[buy-now-aws-url bucket="cool" path="myebook.zip" maxdownloads="10"]

Here’s an example of how you’d setup a url to a file on Amazon S3 that is good for 10 downloads as a replacement (for use within the customer email):

{$buy-now-aws-url bucket="cool" path="myebook.zip" maxdownloads="10"}

Buy Now for Stripe AWS Link Shortcode

If the AWS access and secret key have been setup in the Buy Now for Stripe options, this will generate an HTML link to an S3 url in your email. Can actually embed options into this just like the accompanying shortcode.

AWS links can be setup in 2 ways … either as expiring links or links that will be unaccessible after a certain number of downloads. You just need to specify the S3 Bucket the file is in and then the path within the bucket to the file.

Here’s an example of how you’d setup an HTML link to a file on Amazon S3 that will expire in 60 minutes as a shortcode:

[buy-now-aws-link bucket="cool" path="myebook.zip" expires="60:00"]

Here’s an example of how you’d setup an HTML link to a file on Amazon S3 that will expire in 60 minutes as a replacement (for use within the customer email):

{$buy-now-aws-link bucket="cool" path="myebook.zip" expires="60:00"}

Here’s an example of how you’d setup an HTML link to a file on Amazon S3 that is good for 10 downloads as a shortcode:

[buy-now-aws-link bucket="cool" path="myebook.zip" maxdownloads="10"]

Here’s an example of how you’d setup an HTML link to a file on Amazon S3 that is good for 10 downloads as a replacement (for use within the customer email):