WP Manifestindependent plugin directory
manifest / ecommerce / wcfm-stripe-kyc

WCFM Stripe Identity KYC self-updates

WordPress plugin for Stripe Identity verification with WCFM Marketplace integration - Auto-updatable via GitHub releases

by Barterdash · github.com/mashal-saeed/wcfm-stripe-kyc · website

0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/mashal-saeed/wcfm-stripe-kyc/archive/refs/heads/main.zip

Ships its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.

WordPress plugin that integrates Stripe Identity Verification with WCFM Marketplace. Vendors must verify their identity before publishing products.

✨ Features

  • Stripe Identity Integration - Secure identity verification via Stripe
  • WCFM Integration - Works seamlessly with WCFM Marketplace
  • Product Publishing Control - Blocks unverified vendors from publishing
  • Admin Dashboard - Manage vendors and view verification statistics
  • Smart Popup System - Blocks product uploads until KYC is complete
  • Dashboard Warnings - Persistent KYC reminders in vendor dashboard
  • Shortcode Support - Display verification button anywhere with [bd_stripe_kyc_button]

📋 Requirements

  • WordPress 6.0+
  • PHP 7.4+
  • WCFM Marketplace plugin
  • WooCommerce plugin
  • Stripe account with Identity Verification
  • SSL certificate (for production)

� Quieck Setup

1. Install Plugin

  1. Upload plugin folder to /wp-content/plugins/
  2. Activate plugin in WordPress Admin → Plugins
  3. Look for "Stripe KYC" in admin sidebar

2. Configure Stripe

  1. Go to Stripe KYC → Settings
  2. Add your Stripe API keys:
    • Publishable Key: pk_live_... or pk_test_...
    • Secret Key: sk_live_... or sk_test_...
    • Webhook Secret: whsec_...
  3. Save settings

3. Setup Webhook

  1. Go to Stripe Dashboard → Webhooks
  2. Add endpoint: https://yoursite.com/wp-json/wcfm-stripe-kyc/v1/stripe-webhook
  3. Select events:
    • identity.verification_session.verified
    • identity.verification_session.requires_input
    • identity.verification_session.canceled
  4. Copy webhook secret to plugin settings

🎯 How It Works

For Vendors

  1. Verification Required: Vendors see verification button in WCFM dashboard
  2. Stripe Verification: Click button → redirected to Stripe Identity verification
  3. Automatic Updates: Status updated automatically via webhooks
  4. Product Publishing: Only verified vendors can publish products
  5. Popup Reminders: Unverified vendors get popup when trying to upload products

For Admins

  1. Dashboard: View verification statistics and manage vendors
  2. Settings: Configure Stripe API keys and verification rules
  3. Vendor Management: See all vendors and their verification status

📝 Shortcode Usage

Display verification button anywhere on your site:

Primary Shortcode (Recommended)

[bd_stripe_kyc_button]

With Custom Text

[bd_stripe_kyc_button text="Complete KYC Verification"]

With Custom CSS Class

[bd_stripe_kyc_button class="my-custom-class"]

Advanced Shortcode (Full Features)

[wcfm_stripe_verify_button]

Advanced Options

[wcfm_stripe_verify_button text="Complete Your Verification"]
[wcfm_stripe_verify_button vendor_id="123"]
[wcfm_stripe_verify_button show_status="no"]
[wcfm_stripe_verify_button class="my-custom-class"]

Development

This plugin is built following WordPress coding standards and includes:

  • Comprehensive error handling
  • Secure API communication
  • Property-based testing
  • Unit test coverage
  • Modular architecture

Production Deployment

Pre-Launch Checklist

  1. Test in Staging: Always test the complete verification flow in a staging environment first
  2. Verify Webhook: Test webhook delivery using Stripe's webhook testing tools
  3. Check Dependencies: Ensure WCFM Marketplace and WooCommerce are updated
  4. SSL Verification: Confirm SSL certificate is valid and working
  5. Backup Database: Create a full backup before activation

Go-Live Steps

  1. Upload plugin files to production server
  2. Activate plugin in WordPress admin
  3. Configure live Stripe API keys
  4. Set up production webhook endpoint
  5. Test with a real vendor account
  6. Monitor error logs for first 24 hours

❓ Common Issues

Plugin Not Showing in Sidebar?

  • Check if you have Administrator role
  • Ensure WCFM Marketplace is active
  • Verify plugin files uploaded correctly

Settings Not Saving?

  • Must have Administrator permissions
  • Check API key format (pklive... / sklive...)
  • SSL required for production mode

Verification Not Working?

  • Verify Stripe API keys are correct
  • Check webhook URL is accessible
  • Confirm webhook events are selected in Stripe

📞 Support

Need Help?

  • Email: support@barterdash.com
  • Include: WordPress version, PHP version, error messages

📄 License

GPL v2 or later


Made by Barterdash 🚀