Download the official plugin here: https://2waymicropay.com/wp/shared-files/1512/?2waymicropay-4.0.19.7.zip

2WayMicropay – Instructions

🚀 Getting Started

1. Configure API Connection – Go to Settings and enter your vendor credentials and Site API Key.
2. Connect – Save a valid Site API Key to connect this site to the Products API.
3. Set Up Premium Content – Edit any post or page and use the 2WayMicropay Settings box.
4. The 2WayMicropay settings for any page or post will appear either in the “Post” section (where status and tags are managed) or below the editor.

🌐 Products Portal Direct Access

You can also manage your products directly through the Products Portal: https://products.qixit.com

Log in with the same vendor credentials. The Products Portal allows you to:

• View all your products and their sales history
• Create and manage products manually
• View transaction reports and payouts
• Manage your account settings

⚙️ Content Types Explained

Type	Description	Best For
Regular (Free)	No paywall, content is freely accessible	Blog posts, teasers, general content
Pay Once, View Forever	User pays once and can access anytime	Articles, tutorials, downloads, ebooks
Pay Per View	User pays each time they view	Time-sensitive content, live streams, events
Limited hours	Users access expires after a time you set	Time-sensitive content, live streams, events
Session only	Users access expires upon page exit	Time-sensitive content, live streams, events

💰 Setting Prices on Posts/Pages

Method 1: Individual Post/Page Editor

1. Edit any post or page
2. Find the “2WayMicropay Settings” box in the sidebar
3. Select “Premium – Pay Once, View Forever” or “Premium – Pay Per View” or other options.
4. Set your price (min $0.01, max $100.00) in Qix Credits™.
5. Optionally check “Use Read More as paywall” to show free preview up to the <!–more–> tag
6. Publish/Update your post — the product is automatically synced to the Qixit 2WayMicropay™ API

Method 2: Bulk Actions (Multiple Posts/Pages)

1. Go to Posts → All Posts or Pages → All Pages
2. Check the boxes next to the posts/pages you want to monetize
3. From the Bulk Actions dropdown, select:
   • 2WayMicropay: Set Premium (Forever Access) – One-time purchase
   • 2WayMicropay: Set Premium (Pay Per View) – Pay each time
   • 2WayMicropay: Set as Free – Remove paywall
   • 2WayMicropay: Sync All to API – Register all selected products
4. Click Apply

📝 Using the “Read More” Paywall

The Read More paywall lets you show a free preview of your content:

1. In your post editor, add the <!–more–> tag (click “Read More” button in editor)
2. Content before the tag = FREE preview visible to all
3. Content after the tag = PREMIUM content behind paywall
4. Enable “Use Read More as paywall” in 2WayMicropay settings

Example Post Content:

This is the free teaser that everyone can read.
It hooks the reader and makes them want more!

<!--more-->

This is the premium content that readers
must pay to access. Include your best 
insights and exclusive content here!

📋 Available Shortcodesr]

 Paid Comments

Require users to pay before commenting on your posts/pages. When enabled, the comment form is locked until payment is complete.

How It Works

1. You enable paid comments on a post/page and set a price
2. Visitors see the comment section but must pay to unlock it
3. They click “Pay to Comment” and complete checkout in the purchase frame
4. They log in (or create a free account) and pay
5. After payment, they’re returned to your post with the comment form unlocked
6. Their comment is auto-approved (no moderation needed)

How to Enable Paid Comments

1. Edit a post or page
2. In the Qixit Micropayment Settings box, check “Require payment for comments”
3. Set the Comment Price (e.g., $0.05)
4. Save the post — the comment product is automatically synced to the API

Global Paid Comments Fallback (Site-Wide)

1. Go to 2WayMicropay Settings and enable “Global Paid Comments”.
2. Set a Default Comment Price used when a post/page has no per-post comment price.
3. When enabled, existing posts/pages are backfilled and future posts/pages inherit paid comments automatically.
4. The plugin uses a shared comments product as a fallback path (not a unique product for every page by default).

Priority order: explicit per-post settings and author-share comment products are used first; the global shared comments product is fallback only.

Per-post override: owners/editors can still change comment price per post, enable a per-post paid-comment product, or allow unpaid comments on a specific post/page.

What Users See

Before Payment	After Payment
Comment form is hidden”Pay $X to Comment” button shownExisting comments visible	✅ “Payment Confirmed!” messageComment form unlockedComment is auto-approved

Benefits for You

• 💰 Revenue – Monetize your comment sections
• 🛡️ Spam Prevention – Payment barrier stops spam bots
• ⚡ Less Moderation – Paid comments auto-approve
• 📧 Quality Engagement – Paying users post thoughtful comments

👥 Author Commerce

Author Commerce lets site owners monetize authors’ and contributors’ access. You can also share revenue with your authors and contributors. The workflow includes: paid onboarding rights, optional per-publish fees, and post-level revenue share when articles are viewed or comments are posted.

Owner Setup Checklist

1. Go to Settings and open Author Commerce Settings.
2. Enable Author Commerce.
3. Moderation Policy checkbox. Decide if your are selling Contributor Rights or Author Rights.
   • Unchecked: Authors can post their articles immediately upon payment of the publication charge. No editor review required.
   • Checked: Contributors pay to request posting of their articles. Payment puts the article into pending status. An editor or admin must then approve the pending post before it is available to readers.
4. Set Author Rights Fee (one-time onboarding payment).
5. Optional: Set Per Publish Fee (charged only on first publication of a new post).
6. Set Default Author Revenue Share (%) for new premium content.
7. Optional: Enable Share Revenue from Comments and set Comment Revenue Share (%).
8. Enter Author Terms text shown on the author-rights purchase page.
9. Set Author Instructions URL as the post-payment destination page for all successful author-rights purchases.
10. Save settings.

Create the Author-Rights Purchase Page

1. Create a new WordPress page (for example: Become an Author).
2. Add  to collect applicant details (username, optional/required email based on settings, and new WordPress password).
3. Optionally add  for a simpler existing-user paywall button.
4. Publish the page and add it to site navigation or onboarding emails.
5. Purchase Author Rights validates required signup fields, then launches checkout.
6. The plugin creates/updates reusable site products: Purchase of Author Rights - [SiteName] and Payment for Publication of Article - [SiteName].
7. After successful payment callback, the new WordPress account is created and linked for payout mapping.

The contributor’s Qixit identity is captured from the successful payment callback and linked to their WordPress account for revenue-sharing payouts.

Users Admin: Qixit ID Mapping

• Go to Users to see a Qixit ID column for all users.
• Use the Author Access column to confirm whether each user is Contributor (approval required to publish) or Author (can publish).
• Edit any user profile to set/update Qixit ID / Username.
• This mapping is required for author revenue-sharing payouts.

How Publish Gating Works

• If onboarding fee is enabled and a contributor has no active entitlement, publish is blocked and they get a payment link.
• If publication fee is enabled, first publish is blocked until publication fee is paid.
• After publication fee payment, the editor unlock window is 15 minutes for that post.
• Admins and editors are never blocked by author-commerce gating.
• Signup form requires a WordPress password separate from the contributor’s 2WayMicropay password.

Owner Management of Author Share

1. Open a post/page and find the 2WayMicropay Settings metabox.
2. Set Author Share (%) per post (or keep default from settings).
3. Ensure the post author has a mapped Qixit ID (profile/user-meta or author settings table).
4. Save/update the post so the API payload includes affiliate split headers for that product.

If author share is set but no author Qixit ID is mapped, the metabox shows a warning and split payload is not sent until mapping is fixed.

Approval Toggle (On/Off)

• In Settings, Moderation Policy controls the WordPress role assigned after successful payment.
• In Settings, Author Instructions URL controls where all paid applicants land after checkout.
• In Settings, Signup Email Field controls whether email is required, optional, or hidden on the signup form.
• When OFF: after payment, account is created as Author and redirected to the Author Instructions URL.
• When ON: after payment, account is created as Contributor and redirected to the Author Instructions URL. Contributor posts require Editor/Admin approval to publish.

🖼️ Payout Image Links (Pay Visitors to Visit)

The payout image link is a special link you attach to an image on your site. When a visitor clicks the image, the 2WayMicropay platform pays them a small amount of real money or vendor credits for visiting the destination page. This is perfect for sponsored content, advertisements, or any scenario where you want to reward visitors.

How to Set Up a Payout Image Link

1. Log in to the Products Portal as a vendor
2. Create a new Payout Link (under the Payouts section)
3. Set the Pay Amount (what each visitor earns), Delivery URL (where the visitor goes), budget, and expiration date
4. Copy the generated payout link (it contains a PYID= parameter)
5. In your WordPress page/post, use the 

   ⚠️ 2WayMicropay Image: Missing purchase/payment link

    shortcode, setting the link attribute to the payout URL:

    

                
        
                                
                        

                                
                                - click to purchase
            
            Click to purchase
        
    
    

Visitors will see a price overlay on the image showing how much they will earn. Clicking the image opens the payment page where they log in (or create a free account) and receive the payment.

Payout Types

Type	What Visitor Receives	Budget Field
Real Funds	Actual money credited to their account (withdrawable)	Max Pay (total dollar budget across all recipients)
Vendor Credits (Promo)	Credits redeemable for purchases on this vendor’s site	Promo Budget (total credit budget across all recipients)

Active vs. Inactive Payout Links

A payout link is active as long as:

• The expiration date has not passed (or no expiration is set), and
• The total budget has not been exhausted, and
• The vendor has sufficient funds in their account

When a payout link becomes inactive, the plugin automatically changes its behavior:

State	Price Overlay	Click Destination
Active	Shown (e.g., “+ 5¢” or “+ 10¢ promo credits”)	Payout page → visitor earns payment → redirected to Delivery URL
Inactive (expired or budget exhausted)	Hidden — no price overlay is shown	Delivery URL directly (plain link, no payment process)

Key benefit: Once you attach a payout link to an image, you never need to update the WordPress post again. The image will always link to the destination page. When the payout is active, visitors earn money. When it expires or the budget runs out, visitors still reach the page — they just don’t earn anything. If you later extend the expiration date or add more budget in the Products Portal, the payout link automatically becomes active again.

Shortcode Attributes

Attribute	Required	Description
src	Yes	URL of the image to display
link	Yes	The payout URL (contains PYID=) or a plain URL
width	No	Image width in pixels or CSS value (e.g., 600 or 100%)
height	No	Image height in pixels
alt	No	Alt text for the image

Troubleshooting Payout Links

No price overlay showing on the imageThe payout is most likely inactive (expired or budget exhausted). Check the payout settings in the Products Portal. Extending the expiration date or adding budget will restore the overlay automatically on next page load.Image clicks go directly to the destination without the payout pageThis is normal behavior when the payout is inactive. The plugin falls back to the Delivery URL so visitors still reach the destination.Payout says “Promo budget exhausted” or “Promotion has expired”The payout link has run out of budget or passed its expiration date. Increase the budget or extend the date in the Products Portal to reactivate it.

🎮 Pay-Per-Play (Games, Songs, Videos)

Use the 

⚠️ Pay-Per-Play: Missing product ID (pid attribute)

Example: Pay-Per-Play YouTube Video

Embed a YouTube video that requires payment to watch:

    

        
        
        

            
            
            
            
            
            

                
                
                    ▶ Watch Video
                
                
                
                    5 cents                
                
                                
                    Premium Video                
                            
        
        
        
        

        
        
    
    
        

Example: Pay-Per-Play Audio (Song or Speech)

Embed a public domain audio file (song, speech, or podcast) that requires payment to listen:

    

        
        
        

            
            
            
            
            
            

                
                
                    ▶ Listen Now
                
                
                
                    2 cents                
                
                                
                    I Have a Dream - MLK                
                            
        
        
        
        

        
        
    
    
        

Product Portal Setup

Before using Pay-Per-Play, you must create the product in the Products Portal:

1. Log in to the Products Portal
2. Create a new product or edit an existing one
3. Set the price (e.g., $0.05)
4. Important: Set Access Type to “Pay Per Play (Single Use Only)”
5. Delivery URL is optional. Leave it blank when the content is embedded via shortcode (the shortcode content IS the delivery). If you provide a Delivery URL, it will also open in a new window after payment.
6. Copy the Product GUID and use it in the pid attribute

Delivery URL behavior:

• Shortcode + no Delivery URL: Embedded content (game, audio, video) reveals after payment. This is the typical setup.
• Shortcode + Delivery URL: Embedded content reveals AND the Delivery URL opens in a new window.
• Standalone link + Delivery URL: The Delivery URL opens in a new window (the URL is what the buyer is paying for).
• Standalone link + no Delivery URL: Error — there is nothing to deliver. Always set a Delivery URL when not using the shortcode.

JavaScript API for Game Developers

If you're embedding a custom game, you can call QixitFrontend.resetPayPerPlay(containerId) when the game ends to show the placeholder again and require payment for the next play.

// Call this from your game when play ends:
window.parent.QixitFrontend.resetPayPerPlay('qixit-payperplay-1');

🎨 Branding Integration (Developer Stan

🖼️ Micro-Frame Purchase Flow

When visitors click a "Buy" button or "Read more..." link on premium content, a compact purchase frame (380×180 pixels) appears directly on the page—no redirects or popups needed.

How It Works

1. Visitor clicks a purchase link/button
2. A small iframe appears near the click point
3. The PurchaseFast page loads inside the frame
4. If not logged in, a compact login form appears
5. After login, one-click purchase confirmation
6. Content unlocks automatically upon successful payment

Read More Style

Enable the "Use Read More tag" option in the post editor to show free content above the <!--more--> tag, with an inline "Read more..." link that opens the micro-frame. This creates a natural paywall break point.

Tooltip Preview

"Read more..." links include a hover tooltip showing the price before clicking, e.g., "Pay 5 cents to continue reading".

Products Portal

The micro-frame loads from the Products Portal at https://products.qixit.com.

❓ Troubleshooting

"Not Connected" error

The Settings page shows Connected when the Site API Key validates for this account context. Vendor username/password are no longer probed during status checks, preventing IP/email step-up challenges for plugin traffic. For troubleshooting only, use "Test API Connection" in Advanced Diagnostics.

"Not authenticated" after entering credentialsSave settings after updating Site API Key so the connection status can revalidate immediately.

Paywall not showing

Make sure the post type is set to Premium (not Regular). Products sync automatically when you save; look for the green "✅ Synced to API" badge.

Payment link not working. Verify the product is synced (green badge in the Qixit Micropayment Settings box). Re-saving the post triggers a fresh sync.

Payout image link shows no overlay and goes straight to destination, The payout is inactive: either the expiration date has passed, the budget has been exhausted, or the vendor has insufficient funds. Check the payout settings in the Products Portal (products.qixit.com). Extending the date or adding budget reactivates the payout automatically.

Payout image link shows no overlay and the image is not clickable. If no Delivery URL was set on the payout link, the link becomes unclickable when inactive. Set a Delivery URL in the Products Portal to ensure the image always links somewhere.

Read More not workingMake sure you added the <!--more--> tag in your post AND enabled "Use Read More as paywall" in settings.