WordPress.org
Get WordPress

Plugin Directory

Changeset 3435676


Ignore:
Timestamp:
01/09/2026 07:25:48 AM (3 months ago)
Author:
ipodguy79
Message:

2.0.1 cause i forgot readme

Location:
advanced-emt-payment-gateway/trunk
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • advanced-emt-payment-gateway/trunk/advanced-emt-payment-gateway.php

    r3435660 r3435676  
    55 * Plugin URI:  https://wordpress.org/plugins/advanced-emt-payment-gateway/
    66 * Description: Accept Interac e-Transfer / Email Money Transfer (EMT) in WooCommerce with dynamic secret answers, order notes, and customizable instructions. Supports Block and Classic checkout.
    7  * Version:     2.0.0
     7 * Version:     2.0.1
    88 * Author:      ipodguy79
    99 * Author URI:  https://profiles.wordpress.org/ipodguy79/

  • advanced-emt-payment-gateway/trunk/readme.txt

    r3435660 r3435676  
    11=== Interac e-Transfer / Email Money Transfer (EMT) Gateway for WooCommerce ===
    22Author: ipodguy79
    3 Tags: woocommerce, payment, canada, e-transfer, gateway
     3Tags: woocommerce, payment, canada, e-transfer, gateway, interac, etransfer
    44Requires at least: 5.8
    55Tested up to: 6.9
    … …  
    77WC requires at least: 6.0
    88WC tested up to: 8.6
    9 Stable tag: 2.0.0
     9Stable tag: 2.0.1
    1010License: GPL2 or later
    1111License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1212
    13 Accept Interac e-Transfer / Email Money Transfer (EMT) in WooCommerce. Block checkout, dynamic answers, clear instructions, optional discount.
     13Accept Interac e-Transfer / Email Money Transfer (EMT) in WooCommerce with dynamic answers, clear customer instructions, optional discount, and a Pro upgrade for automated matching.
    1414
    1515== Description ==
    1616
    17 A clean, reliable EMT gateway for Canadian stores. 
    18 Works with Classic and Block Checkout. Generates dynamic or static secret answers, shows instructions on Thank You, emails, and My Account, and optionally applies a checkout discount for EMT.
    19 
    20 **Highlights**
    21 - Block & Classic Checkout support
    22 - Dynamic or static secret answers
    23 - Placeholders: `[order]`, `[answer]`, `[discount]`
    24 - Optional EMT discount with message
     17A clean, reliable EMT gateway for Canadian WooCommerce stores.
     18
     19Customers place an order, then send an Interac e-Transfer. Your store shows clear payment instructions on:
     20- The Thank You page
     21- Order emails
     22- My Account → Order details
     23
     24You can use a static password/answer, or generate dynamic answers per order. You can also offer a discount to encourage EMT.
     25
     26= Core Features =
     27- Works with WooCommerce Classic Checkout and Block Checkout
     28- Static or dynamic secret answer
     29- Highly customizable instructions (with placeholders)
     30- Shows instructions in Thank You, emails, and My Account
     31- Optional EMT discount (percentage) + optional savings message
    2532- Admin/debug friendly; HPOS-ready; translatable
    2633
     34= Pro Upgrade (Automation & Convenience) =
     35If you want the “stop waking me at 3am” features, upgrade to Pro. Pro adds tools that help you match incoming deposit emails to the correct order automatically (IMAP inbox watching) and avoid “same total” collisions (Auto-Match Cents).
     36
     37You can upgrade from the plugin settings screen.
     38
    2739== Installation ==
    28 1. Upload to `/wp-content/plugins/advanced-emt-payment-gateway/` or install via WP Admin.
     40
     411. Upload to `/wp-content/plugins/advanced-emt-payment-gateway/` or install via WP Admin → Plugins → Add New.
    29422. Activate the plugin.
    30 3. Go to **WooCommerce → Settings → Payments**, enable **Email Money Transfer (EMT)**, and configure.
     433. Go to WooCommerce → Settings → Payments.
     444. Enable “Email Money Transfer (EMT)” and configure the settings.
     45
     46== Configuration (Recommended Setup) ==
     47
     48Go to:
     49WooCommerce → Settings → Payments → Email Money Transfer (EMT) → Manage
     50
     51= 1) Basic EMT Settings =
     52These are the settings most stores need:
     53
     54- Enable/Disable: turn EMT on.
     55- Title: what customers see at checkout (example: “Interac e-Transfer”).
     56- Description: short checkout text to reduce confusion (example: “Pay by EMT. Instructions shown after checkout.”).
     57- Secret Answer Mode:
     58  - Static: you enter one answer and customers use it.
     59  - Dynamic: the plugin generates an answer per order (less reuse, less confusion).
     60- Instructions:
     61  Write your “send the EMT to X email + use password Y” instructions here.
     62
     63= 2) Instruction Placeholders (Copy/Paste Safe) =
     64You can use placeholders inside your instructions:
     65
     66- [order]    → Order number
     67- [answer]   → The secret answer/password for that order
     68- [amount]   → Exact total the customer must send
     69- [discount] → Your discount percent
     70
     71Example instruction template:
     72Send [amount] to payments@yourdomain.com.
     73Security answer: [answer]
     74Include order #[order] in the message.
     75
     76= 3) EMT Discount (Optional) =
     77If you want to encourage EMT use:
     78- Discount Percent: enter a number like 3 (for 3%).
     79- Discount Message: optional. Use [discount] where you want the percent to appear.
     80  If blank, the plugin uses a default “Save X% …” message.
     81 
     82 
     83
     84== Pro Feature: Auto-Match Cents (Unique Totals) ==
     85
     86
     87
     88The biggest problem with “auto matching” is when multiple unpaid orders have the same total.
     89Auto-Match Cents solves this by applying a tiny extra discount (cents) so each EMT order total becomes unique.
     90
     91How it works:
     92- At checkout, Pro can add a small “cents” discount line (for example, -$0.07).
     93- The customer sends the exact total shown.
     94- When your deposit email arrives, the plugin can match the amount to the exact unpaid order.
     95
     96Settings:
     97- Enable Auto-Match Cents
     98- Auto-Match Min Cents (default 1 = $0.01)
     99- Auto-Match Max Cents (default 25 = $0.25)
     100- Auto-Match Window (Hours) (default 72)
     101  When picking cents, the plugin avoids totals already used by unpaid EMT orders created in this window.
     102- Auto-Match Line Label
     103  The label shown at checkout for the tiny cents discount (example: “EMT Auto-Match Discount”).
     104
     105Recommended values (most stores):
     106- Min: 1
     107- Max: 25
     108- Window: 72 hours
     109
     110Notes:
     111- This is still a DISCOUNT line (not a fee). It reduces the order total slightly.
     112- Keep the range small (1–25¢) so customers don’t feel “baited” or confused.
     113
     114
     115
     116== Pro Feature: Auto-Confirm Orders via Inbox (IMAP) ==
     117
     118SEE SCREENSHOT 7 ON HOW TO FIND THE 7 DAY FREE TRIAL (For a limited time)
     119
     120
     121
     122Pro can check a mailbox (via IMAP) for Interac deposit emails and automatically mark matching EMT orders as paid.
     123
     124IMPORTANT:
     125- This requires the PHP IMAP extension on your server.
     126- Credentials are stored in WordPress options. Use a dedicated mailbox if possible.
     127
     128= Best-Practice Setup (Do This Once) =
     1291) Create a dedicated mailbox used only for EMT deposit notifications.
     130   (Example: etransfer@yourdomain.com)
     1312) Ensure deposit notifications for that mailbox go ONLY to that mailbox.
     1323) Turn on Auto-Match Cents (recommended) so totals are unique.
     1334) Configure IMAP settings and click “Test IMAP Connection”.
     134
     135= IMAP Settings (Field-by-Field, Dummy-Proof) =
     136
     1371) IMAP Username
     138Usually your full email address (example: you@domain.com).
     139Some hosts use only the mailbox name—check your provider’s “Mail client setup” page.
     140
     1412) IMAP Password / App Password
     142Use your mailbox password for this email account.
     143If your email provider uses Two-Factor Authentication (2FA) and offers App Passwords (common with Gmail, Yahoo, Microsoft 365), you may need to use an App Password instead of your normal password.
     144Most “website email” accounts (cPanel/Plesk hosting email) do not have App Passwords—use the mailbox password you set in your hosting panel.
     145
     1463) IMAP Host
     147This must be your provider’s IMAP server.
     148Examples: imap.gmail.com, imap.mail.yahoo.com, outlook.office365.com, or mail.yourdomain.com
     149App Passwords do not fix a wrong host—make sure Host/Port/Encryption are correct first.
     150
     1514) IMAP Encryption
     152Most providers use SSL.
     153
     1545) IMAP Port
     155Most providers use 993 for IMAP over SSL.
     156
     1576) Mailbox / Folder
     158Default: INBOX
     159You can use a subfolder like INBOX/EMT if your mailbox supports it.
     160
     1617) Skip Certificate Validation (advanced)
     162*NOTE*- Only enable this if your mail server uses a self-signed/invalid certificate and the connection test fails.
     163Leaving it off is more secure.
     164
     1658) Inbox Check Interval (Minutes)
     166How often to check the mailbox (default 5).
     167Note: if your site relies on WP-Cron and has low traffic, the checks can be delayed. For best reliability, use server cron or WooCommerce Action Scheduler.
     168sites with regular visitors will not have to worry.
     169
     1709) Subject Keywords (comma separated)
     171Only process emails whose subject contains at least one keyword (case-insensitive).
     172Defaults include: Interac, e-Transfer, eTransfer, Autodeposit, Auto Deposit, Deposit
     173
     17410) Trusted Sender Addresses (comma separated)
     175Only emails from these senders can auto-confirm orders.
     176Default: notify@payments.interac.ca
     177Examples:
     178notify@payments.interac.ca, payments.interac.ca
     179
     18011) From Contains (optional)
     181An extra filter to reduce false positives (example: interac, notify, etransfer, yourbank)
     182
     18312) Mark Processed Emails as Seen
     184If enabled, processed emails are marked read/seen.
     185
     18613) Order Completion Method
     187Controls how the order is marked paid. (Payment Complete is recommended.)
     188
     18914) Matching Window (Hours)
     190Only match unpaid EMT orders created within this window.
     191
     192= IMAP Connection Test =
     193Click “Test IMAP Connection”.
     194You should see Connected OK (green) or an error message (red).
     195
     196== Troubleshooting (Common Problems) ==
     197
     198= “IMAP extension missing” =
     199Your server doesn’t have PHP IMAP enabled. Ask your host to enable the PHP IMAP extension.
     200
     201= “Authentication failed” =
     202- Wrong username/password, or you need an App Password.
     203- Username is your email address.
     204- If you have 2FA enabled, create an App Password and use it.
     205- Some providers block IMAP until you enable IMAP access in the mailbox settings.
     206
     207= “Could not connect / Host not found” =
     208- Wrong IMAP host.
     209- Wrong encryption or port.
     210Start with SSL + 993 and the provider’s documented host.
     211
     212= “Certificate / SSL error” =
     213- Try enabling “Skip Certificate Validation” ONLY if your host uses a self-signed/invalid cert.
     214
     215= Auto-Match isn’t finding matches =
     216- Make sure deposit notifications land in the mailbox/folder you configured.
     217- Confirm Trusted Senders includes the real sender address.
     218- Confirm Subject Keywords match your deposit email subjects.
     219- Enable Auto-Match Cents to prevent same-total collisions.
     220- Auto-Match is not going to match %100 of the orders, and that is mostly for security. if enough matches are not found it will be left for manual confirm.
    31221
    32222== Frequently Asked Questions ==
    … …  
    36226
    37227= Where do customers see EMT instructions? =
    38 On the Thank You page, in emails, and in **My Account** for the order.
     228On the Thank You page, in emails, and in My Account for the order.
    39229
    40230= Can I offer a discount for using EMT? =
    … …  
    42232
    43233= What placeholders can I use? =
    44 `[order]` (order number), `[answer]` (secret answer), `[discount]` (percent).
     234[order] (order number), [answer] (secret answer), [amount] (total to send), [discount] (percent).
     235
     236= Does Pro store my mailbox credentials? =
     237Yes. IMAP credentials are stored in WordPress options. Use a dedicated mailbox for EMT deposits if possible, gmail recommended.
    45238
    46239== Screenshots ==
    … …  
    502434. Thank You page showing EMT info
    512445. My Account order details with instructions
     2456. Pro: Auto-Match Cents settings
     2467. Pro: IMAP Auto-Confirm settings + Test Connection
    52247
    53248== Changelog ==
     249
     250= 1.1.3 =
     251* New (Pro): Optional IMAP inbox watcher to auto-confirm EMT orders by matching deposit emails to the order's expected total.
     252* New (Pro): Inbox watcher settings (host/port/encryption/folder/filters) and safe de-duplication.
     253
     254= 1.1.2 =
     255* New: [amount] placeholder for instructions (shows the exact total to send).
     256* New (Pro): Optional auto-match cents discount (1–25¢ by default) to make EMT totals unique for automatic inbox matching.
    54257
    55258= 1.1.1 =
    … …  
    69272== Upgrade Notice ==
    70273
    71 = 1.1.1 =
    72 Prevents HTML leaking into order notes/admin and adds a review prompt. No checkout UI changes needed.
     274= 2.0.1 =
     275Pro: Adds optional IMAP inbox auto-confirmation.
     276Adds optional auto-match cents + [amount] placeholder.
Note: See TracChangeset for help on using the changeset viewer.