WP Stripe Checkout

설명

Stripe Checkout plugin for WordPress allows you to accept payments with the Stripe payment gateway. With a simple shortcode, you can quickly start accepting payments on a pre-built, Stripe-hosted form that is SCA-ready and supports 3D Secure 2 authentication. This makes accepting credit card payments easier than ever with very little setup and effort.

Benefits of Stripe Payments

• Easy Stripe payment integration.
• Accept credit and debit card payments.
• Accept recurring subscription payments.
• Accept donation payments.
• Accept Apple Pay payments.
• Accept Google Pay payments.
• Accept Alipay payments.
• Accept WeChat Pay payments.
• Accept Bancontact payments.
• Accept EPS payments.
• Accept giropay payments.
• Accept iDEAL payments.
• Accept Przelewy24 payments.
• Accept Sofort payments.
• Accept Afterpay/Clearpay payments.
• Accept Boleto payments.
• Accept OXXO payments.
• Accept ACH Direct Debit payments.
• Accept Bacs Direct Debit payments.
• Accept BECS Debit payments.
• Accept Canadian pre-authorised debit (PAD) payments.
• Accept SEPA Direct Debit payments.
• Support Dynamic 3D Secure payment authentication.
• Support payment processing with Stripe test cards.
• Support phone number collection at checkout.
• Support user redeemable promotion codes at checkout.
• Localized for 34 languages.
• Automatically email Stripe receipts to your customers.
• Build conversion-optimized payment forms, hosted on Stripe.
• Simplified mobile-ready experience for customers.
• It works on its own, there is no complex setup like a membership/e-commerce plugin.
• No setup fees, monthly fees or hidden costs.
• Seamless transfer to your bank account.
• Easily Switch between live and sandbox mode for testing.
• Real-time fee reporting in your Stripe account.
• Display a logo of your brand or product on the Stripe payment page.
• Easy payouts for Stripe merchants.
• Enable Stripe invoicing after the payment.
• Send a purchase confirmation email to your customer after a transaction.
• Send a sale notification email to a chosen recipient (e.g. the seller) after a transaction.

WP Stripe Checkout Add-ons

• Variable Price
• Variable Quantity
• Submit Type
• Terms of Service

WordPress Stripe Plugin Configuration

Once you have activated the plugin, you need to configure some settings related to your Stripe merchant account. It’s located under “WP Stripe Checkout -> Settings -> General”.

• Test Mode: A checkbox that allows you to run Stripe transactions on your site in test mode using test API keys.
• Stripe Test Secret Key: Your Stripe secret key to run transactions in test mode
• Stripe Test Publishable Key: Your Stripe publishable key to run transactions in test mode
• Stripe Live Secret Key: Your Stripe secret key to run transactions in live mode
• Stripe Live Publishable Key: Your Stripe publishable key to run transactions in live mode
• Currency Code: The default currency code that will be used when accepting a payment
• Return URL: The page URL to which the customer will be redirected after a successful payment
• Stripe Webhook URL: The page URL to which Stripe will send notification after an event

Emails

Stripe checkout plugin comes with an “Emails” tab where you will be able to configure some email related settings.

Email Sender Options

In this section you can choose to customize the default From Name and From Email Address that will be used when sending an email.

Purchase Receipt Email

When this feature is enabled an email sent to the customer after completion of a successful purchase. Options you can customize here:

• The subject of the purchase receipt email
• The content type of the purchase receipt email. The default is “text/plain”. But you can also set it to “text/html”
• The body of the purchase receipt email.

Sale Notification Email

When this feature is enabled an email is sent to your chosen recipient after completion of a successful purchase. Options you can customize here:

• The subject of the sale notification email
• The content type of the sale notification email. The default is “text/plain”. But you can also set it to “text/html”
• The body of the sale notification email.

You can use various template tags in the body of an email to dynamically change its content. You can find the full list of available template tags in the Stripe plugin page.

Webhook Endpoint

Go to “Developers > Webhooks > Add endpoint” and insert the URL shown in the plugin settings. Select this event – “checkout.session.completed” and click “Add endpoint”. This is where Stripe will send a notification after a checkout payment is successful.

You will also need to add the “checkout.session.async_payment_succeeded” and “checkout.session.async_payment_failed” events if you plan to use a payment method where there can be a delay in payment confirmation. For example:

• Bacs Direct Debit
• Boleto
• Canadian pre-authorised debits
• OXXO
• SEPA Direct Debit
• SOFORT
• ACH Direct Debit

For detailed setup instructions please visit the Stripe WordPress plugin page.

How to use Stripe Checkout (Option 1)

The easiest way to start accepting Stripe payments is to create a product in the plugin interface (Stripe Checkout > All Products > Add New).

Once you have created a product, add the shortcode for it to a post/page.

[wp_stripe_checkout id="1"]

Replace the value of “id” with your product ID.

Product Display Template

The template parameter in the shortcode allows you to use a pre-designed display template to showcase your product.

[wp_stripe_checkout id="1" template="1"]

Replace the value of “template” with your preferred display template id.

How to use Stripe Checkout (Option 2)

If you do not wish to create a product you can get started by adding the following shortcode to a post/page:

[wp_stripe_checkout_session name="My Product" price="2.99"]

Replace the value of “name” with your product name and “price” with the actual product price.

Shortcode Parameters

You can add additional parameters in the shortcode to customize your Stripe payment button.

• button_text – The text displayed inside the button (e.g. button_text=”Pay Now”). The default is “Buy Now”.
• button_image – The image that will act as the button (e.g. button_image=”https://example.com/wp-content/uploads/pay-now-button.png”). The default is a plain button with the text “Buy Now”.
• success_url – The URL to which Stripe will redirect upon completion of a successful payment (e.g. success_url=”https://example.com/success”). The default is the Return URL specified in the settings.
• cancel_url – The URL to which Stripe will redirect after a payment is canceled. (e.g. cancel_url=”https://example.com/payment-canceled”). The default is the home URL for your site.
• billing_address – Specify whether Checkout should collect the customer’s billing address. (e.g. billing_address=”required”). The default is “” (Checkout will only attempt to collect the billing address when necessary).
• phone_number_collection – Specify whether Checkout should collect the customer’s phone number. (e.g. phone_number_collection=”true”).
• class – Custom CSS classes for the button (e.g. class=”btn”). Multiple CSS classes can be added in a space-delimited format (e.g. class=”btn btn2 btn3″).

How to use Stripe Checkout (Option 3)

Step 1: Enable Checkout in the Dashboard

To begin using Checkout, log into the Stripe Dashboard and navigate to the Checkout settings (Settings > Stripe apps > CHECKOUT). From here you can enable the client integration and customize the look and feel of your checkout page.

Step 2: Create a Product

Navigate to the “Products” section in the Dashboard and create a new product (New > One-time purchase products). When you create a product in the Dashboard, Stripe creates a Price ID for it. You will need to use this Price ID in shortcode to create a button.

Step 3: Add a Webhook Endpoint

Go to “Developers > Webhooks > Add endpoint” and insert the URL shown in the plugin settings. Select this event – “checkout.session.completed” and click “Add endpoint”. This is where Stripe will send notification after a checkout payment is successful.

Step 4: Add a Checkout Shortcode

In order to create a Stripe checkout button you can add the following shortcode to a post/page:

[wp_stripe_checkout_v3 price="price_UY9NozbEy7T3PUlk"]

price – Price ID of the product created in your Stripe account.

To create a checkout button for accepting recurring subscription payments, you need to set the “mode” parameter to “subscription” in the shortcode:

[wp_stripe_checkout_v3 price="price_UY9NozbEy7T3PUlk" mode="subscription"]

The product in question must also be of type “Recurring” in your Stripe account.

Shortcode Parameters

You can add additional parameters in the shortcode to customize your Stripe checkout button.

• button_text – The text displayed inside the button (e.g. button_text=”Pay Now”). The default is “Buy Now”.
• button_image – The image that will act as the button (e.g. button_image=”https://example.com/wp-content/uploads/pay-now-button.png”). The default is a plain button with the text “Buy Now”.
• success_url – The URL to which Stripe will redirect upon completion of a successful payment (e.g. success_url=”https://example.com/success”). The default is the Return URL specified in the settings.
• cancel_url – The URL to which Stripe will redirect after a payment is canceled. (e.g. cancel_url=”https://example.com/payment-canceled”). The default is the home URL for your site.
• mode – The mode of the checkout (e.g. mode=”subscription”). The default is “payment”.
• locale – The locale that will be used to localize the display of Checkout (e.g. locale=”en”). The default is “auto” (Stripe detects the locale of the browser).
• billing_address – Specify whether Checkout should collect the customer’s billing address. (e.g. billing_address=”required”). The default is “” (Checkout will only attempt to collect the billing address when necessary).
• shipping_address – Specify whether Checkout should collect the customer’s shipping address. (e.g. shipping_address=”required”).
• shipping_countries – If you only wish to ship to certain countries you can specify their country codes. (e.g. shipping_countries=”‘US'” or shipping_countries=”‘US’,’GB’,’AU'”).
• class – Custom CSS classes for the button (e.g. class=”btn”). Multiple CSS classes can be added in a space-delimited format (e.g. class=”btn btn2 btn3″).

For detailed setup instructions please visit the Stripe payments plugin page.

Legacy Stripe Checkout

Stripe Checkout Form is a beautiful payment form specifically designed for desktop, tablet, and mobile devices. Your customer never go to an external payment page for making the payments. They stay on your site and enter their credit card in a secure payment form to complete the payment.

All payment submissions are made via a secure HTTPS connection. However, in order to fully protect sensitive customer data, you must serve the page containing the Stripe payment form over HTTPS. In short, the address of the page containing the Stripe checkout form must start with “https://” rather than just “http://”.

In order to create a Stripe payment button you can add the following shortcode to a post/page:

[wp_stripe_checkout item_name="Champion Men's Jersey T-Shirt" description="Short-sleeve t-shirt in athletic fit featuring ribbed crew neckline and logo at chest" amount="59.99" label="Pay Now"]

In order to accept donations for a cause you can use the shortcode like the following:

[wp_stripe_checkout item_name="Watsi's medical work" description="Donations for Watsi's medical work" amount="1.00" label="Donate to Watsi"]

You can add additional parameters in the shortcode to customize your stripe payment button.

• item_name – The name of the item you are selling.
• name – The name of your company or website.
• image – A URL pointing to a image of your brand or product(128x128px recommended). The recommended image types are .gif, .jpg, and .png.
• locale– Specify auto to display Checkout in the customer’s preferred language, if available (English is used by default).
• currency – The currency of the item (e.g. currency=”USD”). If not specified it will take the default currency code from the settings.
• billing-address – Specify whether Checkout form should collect the customer’s billing address (e.g. billing-address=”true”). The default is false.
• shipping-address – Specify whether Checkout form should collect the customer’s shipping address (e.g. shipping-address=”true”). The default is false.
• panel-label – The label of the payment button in the Checkout form (e.g. panel-label=”Pay $2.00″). Checkout does not translate custom labels to the customer’s preferred language.
• zip-code – Specify whether Checkout form should validate the customer’s billing postal code (e.g. zip-code=”true”). The default is false.
• label – The text that is displayed on the blue payment button (e.g. label=”Buy Now”). Default is “Pay with Card”. Checkout does not translate this label at the moment.
• allow-remember-me – Specify whether to exclude the option to “Remember Me” for future purchases (e.g. allow-remember-me=”false”). The default is true.
• bitcoin – Specify whether Checkout form should accept Bitcoin (e.g. bitcoin=”true”). The default is false.
• success_url – Specify whether Checkout form should redirect the customer to a different url upon completion of a successful payment (e.g. success_url=”https://example.com/success”). The default is the Return URL specified in the settings.

For detailed setup instructions please visit the Stripe plugin documentation page.