🧧

 

Red Envelope Payment Gateway

Installation & Configuration Guide — Version 2.22.3

What this plugin does: Accept Red Envelope wallet payments on your WooCommerce store. Prices and payments are in USDC on the AXY network — in the Ace wallet that dollar is called USDX — and buyers earn AXY rewards funded by your commission. AB2BC runs on a test network today: payments use test coins with no real-money value.

📋 Requirements

WordPress 5.8 or higher
WooCommerce 5.0 or higher
PHP 7.4 or higher
SSL Certificate Required (HTTPS)
AB2BC member wallet A wallet that has joined CITC (Ace) or M2C — the gateway only turns on for a member wallet. Merchant verification (KYM) is recommended.

⬇️ Step 1 — Download the Plugin

Download the latest version of the plugin ZIP file:

⬇️ Download ab2bc-red-envelope.zip

📦 Step 2 — Install the Plugin

  1. Log in to your WordPress Admin Dashboard.
  2. Go to Plugins → Add New → Upload Plugin.
  3. Click “Choose File” and select the ab2bc-red-envelope.zip file you downloaded.
  4. Click “Install Now” and wait for the upload to complete.
  5. Click “Activate Plugin”.
💡 Tip: If you are upgrading from a previous version, deactivate the old plugin first, delete it, then install the new version.

⚙️ Step 3 — Configure the Payment Gateway

  1. Go to WooCommerce → Settings → Payments.
  2. Find “Red Envelope Payment” in the list and click “Manage” (or toggle it on first).
  3. Configure the following settings:
Setting Description
Enable/Disable Toggle to enable Red Envelope payments.
Title The payment method name shown to customers at checkout (default: “Red Envelope Payment”).
Description Text displayed below the payment method on checkout.
Merchant Wallet Address Your wallet address — shown with a Copy button in the Ace wallet under Portals → WordPress Plugin. Payments settle there. Must be a verified M2C member wallet.
Consumer Reward Share % The buyer’s share of the reward pool your commission funds, paid in the store’s reward coin — AXY (default: 60%).
Merchant Commission % Commission percentage for the merchant (default: 50%).
Reward coin price (USDC) Price of 1 reward coin in USDC, used to show buyers their reward (default: 0.50 — AB2BC prices AXY at 0.50).
API Endpoint M2C Backend API URL (default: https://m2c.ab2bc.com/api).
RPC Endpoint AB2BC network endpoint used to verify payments — serves every AB2BC chain (default: https://genesis.ab2bc.com/api/rpc/AXY).

🔐 Step 4 — Verify Your Merchant Wallet

After entering your wallet address, click the “Verify Wallet” button in the gateway settings. The plugin will:

  • Check that your wallet is a registered M2C member.
  • Check your merchant verification (KYM) — recommended, not required.
  • Cache the verification for 12 hours (re-checked automatically twice daily).
✅ Important: The payment gateway will only be available to customers if your merchant wallet is verified. If verification fails, the gateway is automatically disabled and you will receive an email alert.

🎁 Step 5 — Configure Product Bonuses (Optional)

You can set custom reward percentages per product:

  1. Edit any WooCommerce product.
  2. Scroll to the “Red Envelope Bonus” panel in the Product Data section.
  3. Set a custom reward percentage for that specific product.
  4. Leave blank to use the global default.

🛒 How Checkout Works

  1. Customer selects “Red Envelope Payment” at checkout.
  2. A QR code is displayed with the USDC payment amount and your merchant wallet address.
  3. Customer scans the QR code with their Ace wallet (Send → Scan to Pay).
  4. Payment is sent in USDC on the AXY network (USDX in the Ace wallet) — settled directly to your wallet.
  5. The plugin automatically verifies the on-chain transaction and marks the order as paid.
  6. Customer receives AXY rewards in their wallet.

🔌 WooCommerce Blocks Support

The plugin fully supports the new WooCommerce Blocks checkout in addition to the classic checkout. No additional configuration is needed — it works out of the box with both checkout experiences.

🔑 M2C SSO Integration

The plugin includes optional Single Sign-On (SSO) integration with the M2C platform:

  • Customers can log in to your store using their M2C account.
  • Wallet addresses are automatically linked for seamless payments.
  • Configure SSO settings under WooCommerce → Settings → Payments → Red Envelope Payment.

📊 Transaction Monitoring

View all Red Envelope transactions from your WordPress admin:

  • Go to WooCommerce → AB2BC Transactions.
  • See payment status, amounts, wallet addresses, and on-chain TX hashes.
  • Use the “Test Connection” button to verify API connectivity.

❓ Troubleshooting

Issue Solution
Gateway not showing at checkout Ensure the gateway is enabled and your merchant wallet is verified. Check WooCommerce → Status for errors.
QR code not generating Verify your API Endpoint and RPC Endpoint are correct. Use “Test Connection” in AB2BC Transactions.
Payment not confirming Leave the RPC endpoint at its default (https://genesis.ab2bc.com/api/rpc/AXY) and check your server can reach it. Ensure the customer sent the exact USDC amount.
Merchant verification failed Ensure your wallet is registered as an M2C member at m2c.ab2bc.com. Retry verification after 15 minutes.
Plugin conflicts This plugin automatically resolves known conflicts with Payoneer Checkout and Codisto Connect. If other conflicts arise, check the WooCommerce error log.

📞 Support

Need help?