Title: Minimal Stripe Wrapper
Author: jerrystewart99
Published: <strong>2025 年 3 月 12 日</strong>
Last modified: 2026 年 6 月 5 日

---

搜索插件

![](https://ps.w.org/minimal-stripe-wrapper/assets/icon-256x256.png?rev=3561689)

# Minimal Stripe Wrapper

 作者：[jerrystewart99](https://profiles.wordpress.org/jerrystewart99/)

[下载](https://downloads.wordpress.org/plugin/minimal-stripe-wrapper.1.2.0.zip)

 * [详情](https://cn.wordpress.org/plugins/minimal-stripe-wrapper/#description)
 * [评价](https://cn.wordpress.org/plugins/minimal-stripe-wrapper/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/minimal-stripe-wrapper/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/minimal-stripe-wrapper/#developers)

 [支持](https://wordpress.org/support/plugin/minimal-stripe-wrapper/)

## 描述

Minimal Stripe Wrapper (MSW) is a lightweight and secure WordPress plugin designed
to streamline Stripe payments with minimal setup and maximum flexibility. Unlike
complex, feature-heavy payment plugins, MSW provides a low-footprint solution that
leverages Stripe Checkout, ensuring the highest level of security while keeping 
your site’s payment workflow simple and efficient.

Please visit the full [Plugin Documentation](https://plugins.webworkz.nz) page.

#### Features

 * Single payments via Stripe-hosted Checkout
 * No card or payment information are stored locally.
 * Can use Stripe Test mode for sandbox testing.
 * Can automatically add a surcharge to cover the Stripe transaction fee.
 * Will work with either logged in users (eg. a membership site) or not logged in
   users (eg. a donation)
 * Includes a shortcode Donate Form with variable amount.
 * Downloadable transactions history in the WP dashboard for tracking and cross-
   referencing transactions.

#### Security

 * Uses Stripe-hosted forms. No card data touches your server.
 * Rate-limiting for extra protection.
 * Stripe secret keys are stored encrypted.
 * Uses the WordPress REST API with corresponding validation checks in addition 
   to Stripe validation.

### External services

This plugin connects to the Stripe API in order to initiate a Stripe Checkout session
and to receive a Webhook response.

You may specify what information is supplied to Stripe.

The minimum information you must supply is the payment amount.

You may optionally include a Users email, product name and quantity.

Where an email is not supplied, Stripe will require the user to enter an email.

See also the [Stripe Consumer Terms of Service](https://stripe.com/legal/consumer)
and the [Stripe Privacy Policy](https://stripe.com/privacy)

### How it Works

You can initiate a Stripe payment with any of these methods:

 1. The Gutenberg block element ‘Minimal Stripe Button’
 2. By using any clickable element of your choice (eg. a <button> or <a>)
 3. By using the shortcode-generated button.
 4. By using an action hook.
 5. By using the shortcode-generated donate-form.

#### Method 1: A Gutenberg block element

Add to your page using the WordPress block editor.

#### Method 2: Use an existing clickable element

Add a css class to any clickable target element.
 eg. Use the page builder of your
choice (eg. A Divi Button).

    ```
    class="mswr-stripe-payment"
    ```

Then add a filter hook to enter/modify your specific payment details.

For example:

    ```
    add_filter( 'mswr_pre_stripe_checkout', function( $args ) {

      // add payment details
      $args[ 'amount' ] = $amount;              // use the smallest unit of your currency. ie. $123.45 => '12345'
      $args[ 'currency' ] = 'nzd';              // iso 4217 currency code
      $args[ 'email' ] = abc@test.com;          // eg. wp_get_current_user()->user_email;
      $args[ 'product' ] = 'Your Product/Service name'; // will appear on the Stripe Checkput page
      $args[ 'user_meta' ] = 'Membership Renewal';  // user-defined tag that can help identify a transaction in the Stripe webhook callback

      return $args;
    });
    ```

#### Method 3: Using a shortcode-generated button

This method requires no php code. You can however, optionally add a php hook (as
above) to modify the Stripe parameters and to perform extra actions on the Stripe
webhook callback.

Example shortcode:

    ```
    [mswr_stripe_button amount="1234" currency="usd" email="abc@test.com" product="Sample Product" quantity="2"  success_url="/payment_success" cancelled_url="/payment_cancelled"]
    ```

#### Method 4: WP hook

A developer method.
 Use PHP from your code to fire a WordPress ‘action’ which initiates
a Stripe Checkout session with the specified Stripe arguments

Action hook: `mswr_initiate_stripe_payment`

Example:

    ```
    $args = [ 'amount' => '12345' ];
    add_action( 'mswr_initiate_stripe_payment', $args );
    ```

…

### Hooks available in Minimal Stripe Wrapper

    ```
    1. mswr_initiate_stripe_payment
    2. mswr_pre_stripe_checkout
    3. mswr_{\$type}
    4. mswr_shortcode_html
    ```

#### Method 5: Donate Form

Shortcode generated Donate Form where the user can select the amount to pay.

See the [Plugin Documentation](https://plugins.webworkz.nz) for a full description

## 屏幕截图

[⌊Minimal Stripe Wrapper : Options page⌉⌊Minimal Stripe Wrapper : Options page⌉[

Minimal Stripe Wrapper : Options page

[⌊Example of a Button to invoke Minimal Stripe Wrapper⌉⌊Example of a Button to invoke
Minimal Stripe Wrapper⌉[

Example of a Button to invoke Minimal Stripe Wrapper

[⌊Example of the Stripe Checkout page⌉⌊Example of the Stripe Checkout page⌉[

Example of the Stripe Checkout page

[⌊Transaction Log Admin Page⌉⌊Transaction Log Admin Page⌉[

Transaction Log Admin Page

[⌊Donate Form⌉⌊Donate Form⌉[

Donate Form

[⌊Gutenberg Block Minimal Stripe Button⌉⌊Gutenberg Block Minimal Stripe Button⌉[

Gutenberg Block Minimal Stripe Button

## 区块

该插件提供了 1 个区块.

 *   Minimal Stripe Button A button to initiate a Stripe payment.

## 安装

Minimal Stripe Wrapper just as you would any other WP Plugin:

 1. [Download Minimal Stripe Wrapper](https://wordpress.org/plugins/minimal-stripe-wrapper)
    from WordPress.org.
 2. Unzip the .zip file.
 3. Upload the Plugin folder (minimal-stripe-wrapper/) to the wp-content/plugins folder.
 4. Go to [Plugins Admin Panel](https://codex.wordpress.org/Administration_Panels#Plugins)
    and find the newly uploaded Plugin, “Minimal Stripe Wrapper” in the list.
 5. Click Activate Plugin to activate it.

## 常见问题

### How do I use this plugin?

 * Install and activate
 * Setup the pluing settings page
 * Choose your scenario and implement it as described
 * See also the [Plugin Documentation](https://plugins.webworkz.nz)

### How to uninstall the plugin?

Simply deactivate and delete the plugin. It will clean up nicely and leave no trace.
*
WARNING Deleting the plugin will also delete your Stripe keys and all data associated
with this plugin.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Minimal Stripe Wrapper」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ jerrystewart99 ](https://profiles.wordpress.org/jerrystewart99/)

[帮助将「Minimal Stripe Wrapper」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/minimal-stripe-wrapper)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/minimal-stripe-wrapper/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/minimal-stripe-wrapper/)，或通过
[RSS](https://plugins.trac.wordpress.org/log/minimal-stripe-wrapper/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/minimal-stripe-wrapper/)。

## 更新日志

#### 1.2.0

Tested up to 7.0
 * Improved: CSV export on the Transactions screen is now more 
robust and produces cleaner output. * Improved: Hardened database queries and admin
actions for the WordPress.org Plugin Check standards. * Improved: Currency handling
normalised across all payment entry points. * Security: Additional input validation
and output escaping throughout. * Fixed: Minor display and form-handling issues 
on the donation form. * Fixed: Database upgrade routine now tracks versions reliably.

#### 1.1.9

 * Fixed: The mswr_transaction_complete action was being fired incorrectly for
    
   checkout.session.completed events due to $args[‘session_id’] being set before
   the completed subtype check, causing a spurious transaction update with status‘
   pending’. Fixed by moving the session_id assignment inside the non-completed 
   branch only, so completed events leave $args unset as originally intended.

#### 1.1.8

Added DB upgrader to facilitate a schema change in mswr_transactions table: Change
user_meta from varchar(255) to TEXT.
 Tabulate Settings page to permit inclusion
of further gateways. (This to accomodate the meta-poli-payments plugin for POLi 
Payments — NZ banking only) Minor changes for code robustness

#### 1.1.7

Changed mswr_initiate_stripe_payment from a filter to an action to align with WordPress
hook semantics. If you were using add_filter() on this hook, please update to add_action().

Add support for Meta-Membership (yet to be released) plugin

#### 1.1.6

Add Gutenberg block for button

#### 1.1.5

Add click-to-copy link for Stripe endpoint
 fix: donate form redirection, js console
error

#### 1.1.4

added transactions csv download
 bugfix identifying client IP

#### 1.1.3

added Donate Form shortcode
 bugfix on rate limiter

#### 1.1.2

bugfix: mswr_initiate_stripe_payment is now a filter not an action in order to return
the checkout URL

#### 1.1.1

small fix to readme.txt

#### 1.1.0

add transactions log and system log pages to dashboard

#### 1.0

Inital Release

## 额外信息

 *  版本 **1.2.0**
 *  最后更新：**4 天前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 6.2 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/minimal-stripe-wrapper/)
 * 标签
 * [credit card](https://cn.wordpress.org/plugins/tags/credit-card/)[donation](https://cn.wordpress.org/plugins/tags/donation/)
   [membership](https://cn.wordpress.org/plugins/tags/membership/)[payment](https://cn.wordpress.org/plugins/tags/payment/)
   [stripe](https://cn.wordpress.org/plugins/tags/stripe/)
 *  [高级视图](https://cn.wordpress.org/plugins/minimal-stripe-wrapper/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/minimal-stripe-wrapper/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/minimal-stripe-wrapper/reviews/)

## 贡献者

 *   [ jerrystewart99 ](https://profiles.wordpress.org/jerrystewart99/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/minimal-stripe-wrapper/)