> For the complete documentation index, see [llms.txt](https://verified-crypto-checkout.gitbook.io/verified-crypto-checkout/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://verified-crypto-checkout.gitbook.io/verified-crypto-checkout/verified-crypto-checkout-plugin-guide.md). # VERIFIED Crypto Checkout Plugin Guide #### The Most Feature Rich Card to Crypto WooCommerce OnRamp Available Accept Credit Cards via Crypto Online and In Person (without hardware) — Up and Running in Minutes **This is not a replacement to standard credit card processing. Think of this plugin as a tool to receive payment by cards, but it will not be as seamless as a standard credit card processing gateway based on the following friction points:** 1. *Some credit card providers do not allow crypto purchases (and may charge cash advance fees).* 2. *All crypto platforms will require first time users to do KYC (rarely will they avoid it on small transactions and maybe if already used a service like Link for Stripe on other sites).* 3. *The plugin will redirect off site for payment not embedded fully at checkout. (We try to make this as smooth as possible with Thank-You Receipt Pages (Step 6))* {% hint style="info" %} Overall note for all merchants, it is best to **guide customers to use debit** when possible since there is a possibility of customers being charged a cash advance fee for certain credit card to crypto purchases (not all, but sometimes). Also, some credit cards do not allow crypto purchases but nearly all debit cards will be approved. Also, the **safest bet for having a valid crypto provider for your customers is to enable Auto-Routing** gateway, which presents all available providers to your customer. It is also the only gateway that is easy for a customer to refresh and try another provider by keeping a window open that they can refresh to try a different provider. {% endhint %} #### This Guide Covers Installation • Configuration • Hosted Waiting Room & Thank-You Page • Payment Links • Order Requests • Auto Recovery • Subscriptions • Missed Payment Protection **v1.56.43+ — August 2026** We always love adding features that merchants want and are available for help, reach out below for assistance or to recommend features. [VERIFIED Support Board + AI Chat](https://verifiedcryptocheckout.com/support-tickets/) {% hint style="info" %} Our AI chat is trained on all our documents and plugin code so is often smarter than us with instant answers. If need a human within the chat just say "human agent." {% endhint %} A product of VERIFIED Credit Card Processing ## **What This Plugin Does**
VERIFIED Crypto Checkout lets your customers pay by credit card (Visa, Mastercard, Apple Pay, Google Pay) at your WooCommerce checkout. The payment is processed by a licensed crypto on-ramp provider and you receive USDC stablecoin directly to your Polygon wallet — instantly, with no chargebacks. VERIFIED Crypto Checkout is software infrastructure only. VERIFIED Credit Card Processing LLC does not custody funds and does not collect or store customer payment data. We log only merchant URL, order value, infrastructure fee calculations, affiliate payout allocations, and blockchain transaction hashes for accounting purposes. The Software integrates third-party and white-labeled components not controlled by Company. All payment activity occurs exclusively on independent hosted checkout platforms. Use of this software is subject to our [Terms of Service](https://verifiedcryptocheckout.com/terms/). ### **What's in This Guide** | **Section** | **Coverage** | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Steps 1–5** | Install the plugin, select and configure payment providers, understand Auto-Routing, and configure fees | | **Step 6** | VERIFIED Thank-You Page — configure the hosted waiting room, automatic order confirmation, receipt detail, alternate-provider option, and return-to-checkout behavior | | **Steps 7-8** | Track payments in WooCommerce order details and complete the pre-launch checklist | | **Step 9** | Customer KYC friction — including the Secure Card Checkout notice shown at checkout | | **Step 10** | Crypto Ledger — your transaction dashboard | | **Step 11** | Request Payment — standalone payment links and invoices | | **Step 12** | Request Payment for Orders — send payment links from order screens | | **Step 13** | In Person QR Payments | | **Step 14** | Subscription Payments — recurring billing via email-based renewals | | **Step 15** | Automated Checkout Recovery — recover unpaid orders with no-login Pay Now emails and optional incentives | | **Step 16** | Missed Payment Protection — on-chain fallback check when a provider webhook may have been missed | | **FAQ** | Frequently asked questions covering all features | | **Appendix** | KYC requirements by provider — research reference | ## **Step 1 — Install the Plugin** You will receive your plugin from our site, an agent, or the Wordpress Repository as a .zip file from VERIFIED. Upload the file directly into WordPress admin. As shown in the video below, installation literally takes a minute to get up and running with payments. If for any reason you need help technical help with our plugin you can visit our [support AI ticketing board](https://verifiedcryptocheckout.com/support-tickets/) to get immediate answers or reach a human. * Go to Plugins → Add New → Upload Plugin. * Choose your .zip file and click Install Now. * Click Activate Plugin once installed. * Go to Payments → Select VERIFIED Crypto Checkout Gateway **Easiest gateway to select to get started is Auto-Routing**, also most reliable for your customers. Select it add your wallet and enable to get payments within a minute of activation. Auto-Routing remains the broadest option because it presents the available provider choices for the customer’s region. When the VERIFIED Thank-You Page is enabled and a customer begins with a specific provider, the waiting room that shows before order confirmation on the Thank-You page also offers a **Try a different provider** without creating a second WooCommerce order. {% embed url="" %} ## **Step 2 — Choose Your Payment Provider(s)** Go to WooCommerce → Settings → Payments. All available VERIFIED Crypto Checkout gateways are listed. Enable one, several, or all. The **safest bet to always have an option live for your customer is to select Auto-Routing**, this provides all solutions that are available to the customer. Our plugin is available globally so some gateways will not be relevant to your customers, please enable them wisely. Picking an individual gateway would make it safer for customers to not accidentally face KYC on return visit by selecting another provider on accident, but sometimes a provider goes down so may not be available at checkout. {% hint style="info" %} **Enabling auto-routing is the safest way to guarantee an option for your customer at checkout**. Only risk is they may pick a different provider on their next return visit and do KYC again. Some providers do go down and we look to have customer fallback to auto-routing by default, but if seeing any issues enable auto-routing instead of an individual gateway. {% endhint %} | **Provider** | **Key Notes** | **Best For** | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Auto-Routing** | Shows a provider selection screen to the customer. They choose from options available for their region. | **Safest option to enable, since guarantees customer seeing all available provider solutions.** Also necessary for international / multi-geography stores. | | Coinbase | Highly trusted US-based provider with strong bank relationships and high authorization reliability. Supports debit cards, bank transfers, and native Coinbase accounts. Requires users to sign in to or create a Coinbase account to add and use payment methods. KYC is required for most users but is streamlined, especially for existing Coinbase customers. | US merchants prioritizing reliability and high approval rates, especially for customers who already have a Coinbase account or are comfortable creating one and completing verification. If enabling only one US gateway this is the most reliable for card approval. | | Stripe (USA) | Widely trusted brand, lowest US fees. Some customers will have done Stripe Link and not known so can skip KYC. But for new users KYC flow often requests a Social Security Number early. | US merchants comfortable with SSN KYC | |

Topper

| Extensive geographical converage including the US as well. Offers Apple Pay and competitive fees. | US, Canada, other geographies comparable to Stripe, just lesser brand awareness although UpHold (their parent company is growing). | | All Others | Ramp, Transak, Banxa, Guardarian, Bitnovo, Cryptix, Unlimit, Utorg, Kryptonim, and more. See Appendix. We are also adding new providers regularly. | Specific regions or segments | | **Single-Region Stores** If your customers are primarily in one geographic area, enabling a single specific provider rather than Auto-Routing will skip one step for the customer. A customer who completes KYC with a specific provider will be recognized on return visits — meaning faster, friction-free checkout next time. The only issue is that sometimes a single provider may go offline, so still safest method for always up checkout experience is auto-routing even though it adds another step in checkout for customer to select their provider. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | {% hint style="info" %} If you ever have trouble with any gateway, or are forced into debit card only then try a different gateway. Sometimes crypto providers will adjust their KYC or transaction rules or have added security measures another provider will not at that time. Also, with our backup payment option in auto-recovery emails it is worth offering various providers as payment backups in emails they receive. {% endhint %}
## **Step 3 — Configure Your Gateway** To get up and running with accepting funds all you need to do is go into a gateway settings and enable activate, then add your wallet. All other features in this guide are bonus settings but to get payments it only takes these actions.
Click Manage next to any enabled gateway and complete the key fields: | **Field** | **What to Enter** | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Enable / Disable | Check the box to activate this payment method at checkout. | | Title | The label customers see at checkout. Customize as needed. | | Description | Optional short text shown under the title at checkout. A key place to set customer expectations — see Step 9. | | Service Fee | Controls the 4% VERIFIED infrastructure fee. "Store covers all fees" means you absorb it. "Customer pays fees" adds a 4% line item to the order total. | | Wallet Address | Your Polygon USDC wallet address. All payments are sent here. Double-check before saving. | | Replace Default Logo URL | Customize logo shown alongside gateway option at checkout, this replaces the default one. | ## **Step 4 — Understanding the Auto-Routing Flow** When a customer selects Auto-Routing at checkout and clicks Place Order, they are taken to a hosted screen showing available providers for their region. The customer selects a provider, then completes payment on that provider's checkout. This solution is good for when you have customers from many geographic regions, since it showcases the proper providers for their location but it adds another step in checkout in comparison to enabling a direct gateway (because the customer has to pick their provider of choice and then move to the provider checkout). | **Returning Customer KYC Risk** With Auto-Routing, a customer can pick a different provider on each visit. If they choose a different provider than previously used, they will need to complete KYC again. If repeat-customer conversion is a priority, a single dedicated provider is a better choice. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
## **Step 5 — How Fees Work** Within each gateway settings you have the option to pass the infrastructure fee to the customer. By default the fee is set to be paid by the store but with one click can push the fee as a cart line item to the customer. This does not adjust the crypto provider fee, which will always be paid by you as the merchant. Also, when you do enable the 4% to the customer it goes into the order total so the crypto provider takes a minor portion as part of their fees (since order total increases overall).
| **Fee** | **Who Pays** | **Details** | | ------------------------------ | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Crypto provider conversion fee | Always merchant | Each provider charges its own fee to convert card payment to USDC. Deducted from settlement amount. Cannot be passed to customer. | | VERIFIED 4% infrastructure fee | Merchant or customer | Controlled by the Service Fee setting in your gateway configuration. | ## **Step 6 —** VERIFIED Thank-You Page The VERIFIED Thank-You Page is an optional, merchant-branded hosted page that sits beside the provider checkout experience. It opens the independent provider payment page, monitors the existing WooCommerce order for confirmation, and changes into a receipt after WooCommerce confirms payment. {% hint style="info" %} This page is optional and can be turned off, but was created so the customer has a bridge between the crypto provider page and also your store. This page is branded with your logo and store name (editable in settings, but by default uses info in woocommerce settings) so that the customer sees a payment confirmation and product receipt with your branding. **NOTE: Image below shows our store branding from our demo site, but on your site will show your logo and store name.** {% endhint %}
### 6.1 What the Customer Experiences
1. The customer selects a VERIFIED payment method and clicks **Place Order**. 2. WooCommerce creates the order and sends the customer to the merchant-branded waiting room. 3. The secure provider payment page opens. With the recommended **New tab** setting, the waiting room remains open in the original tab. 4. The customer completes payment on the independent provider page. Card and identity information stays on that provider’s hosted checkout. 5. The waiting room checks the existing WooCommerce order for status updates. It does not change the order. 6. When WooCommerce confirms the payment, the waiting room changes into a receipt and offers a **Return to store** button. This design does not depend on the provider redirecting the customer back after payment. The waiting room is already open and receives the result from WooCommerce. ### Step 6.2 Configure the Page
1. In WordPress, go to **WooCommerce → VERIFIED Thank-You Page**. 2. Review the branding, payment-window, receipt, and cart-return settings described below. 3. Click **Save changes**. 4. If want to disable page can do so on this page. 5. Place a controlled test order that meets the selected provider’s minimum and confirm both the pending and paid states before promoting the feature to customers. There are multiple levels of detail possible for the receipt, we recommend the full receipt mode for most details for your customers. If the feature is switched off, checkout uses the previous direct provider redirect. If page registration fails, the plugin also falls back to the direct provider redirect automatically. ### Step 6.3 If the Hosted Page Is Unavailable The feature is designed to fail safely. If it is disabled, unavailable, or unable to register the order, the customer is sent directly to the provider page using the previous checkout behavior. Payment routing and settlement continue through the existing gateway flow. Merchants can look for the following WooCommerce order note when the fallback is used: > Thank-you page registration failed; direct provider redirect used. An occasional fallback does not mean the payment failed. It means the hosted waiting room was not used for that attempt. ## **Step 7 — What Happens After Payment** After completing payment at the provider's page, customers are not automatically redirected back to your website. It is not possible for us to have the customer come back to your site at payment completion, but when order status adjusts automatically in your site they will receive an email confirmation. * Customer completes card payment on the provider's checkout page. * Provider converts to USDC and sends on-chain to your Polygon wallet. * Once confirmed on the blockchain, your WooCommerce order is automatically marked as Paid. * Customer receives a standard WooCommerce order confirmation email. | **Tell Your Customers** After completing payment, you do not need to return to our website. Once your payment confirms on the blockchain (usually a few minutes), your order will be automatically processed and you will receive a confirmation email. You can safely close the payment page. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | {% hint style="info" %} As long as their payment is confirmed on the blockchain, our plugin will see that they have paid. Our plugin first gets the webhook info from the crypto provider that confirms the payment, this works for 99% of all orders. Sometimes the crypto provider website may have issues relaying the information to your site and a customer paid but your order status does not update, our plugin looks out for this issue by searching the chain for a confirmed transaction for any orders in pending. If this happens and our site sees a payment but a "pending status" for the order you will get an email telling you to manually review the order on your site. {% endhint %} ## **Step 8 — Tracking Payments in Your Order Details** | **Field** | **What It Shows** | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Encrypted reference / tracking code | A secure encoded string linking this order to the checkout session on the provider's platform. | | Temporary wallet address | The intermediate address the provider used to route USDC to your wallet. | | Converted amount | The actual USDC amount sent on-chain. | | Track Payment on Polygonscan | Button linking to the public blockchain record: exact USDC amount, wallet addresses, transaction hash, and block timestamp. |
## **Pre-Launch Checklist** * Plugin installed and activated * At least one gateway enabled in WooCommerce → Settings → Payments * Polygon USDC wallet address entered correctly in gateway settings * Service Fee setting confirmed (recommend: Store covers all fees) * Test transaction completed successfully * Customize Thank-You Page / Waiting Room if desired (Step 6) * Customer notice added explaining no redirect occurs after payment (Step 7) * Gateway Description field updated with KYC expectation wording (Step 9) * Auto-Routing vs single provider decision made based on customer geography * Order confirmation email reviewed for correct payment expectations ## **Step 9 — Customer KYC Friction** When a customer pays through VERIFIED Crypto Checkout, the payment is processed by an independent crypto on-ramp provider. These providers are regulated financial services businesses and must follow Know Your Customer (KYC) and Anti-Money Laundering (AML) regulations. With our plugin we are always adding features aimed at lowering this friction and autmating checkout recovery for when a customer doesn't finish the KYC process. ### **The Three Sources of Checkout Friction** #### **First purchase usually requires KYC** On a customer's first transaction with a provider, they will typically be asked to verify their identity — personal details, government ID, and selfie. Most complete this in 1–3 minutes. Return visits to the same provider are significantly faster with zero or limited KYC. {% hint style="info" %} We've seen other on ramp plugins claim "zero KYC" and have even reached out to them to find out how, what we learned is they most often use MoonPay and claim low orders don't see KYC or use Stripe and since Link is widely used claim no KYC since users already have accounts. This is not true, Apple Pay may help limit KYC and sometimes it may be possible for a provider to avoid it on very small transactions but no one has a compliant way to get around KYC. If you want their "zero KYC" option use our Stripe option but understand it isn't actually without KYC. {% endhint %} #### **Some credit cards block crypto purchases** Many banks decline crypto purchases on credit cards. Debit cards (Visa or Mastercard) generally have higher approval rates. If a customer's card is declined, recommend they try a debit card. #### **Customers briefly leave your site** After clicking Place Order, customers are redirected to the provider's hosted checkout page. They receive a confirmation email once the on-chain transaction confirms. ### **9.1 Secure Card Checkout Notice at Checkout** VERIFIED automatically shows a "Secure Card Checkout" notice directly above the Place Order button whenever a VERIFIED gateway is selected. This notice sets customer expectations before they click — reducing abandonment caused by surprise at the provider's page. It appears automatically in both Classic and Blocks checkouts. No setup required (but customization available, see next section). ![](/files/83ntjVf9EnsuUFm5mSfn) *The Secure Card Checkout notice shown above the Place Order button when a VERIFIED gateway is selected.* The notice covers all six key expectations: off-site payment, confirmation email, first-purchase ID check, returning-customer speed, debit card fallback, and product privacy. #### Customize KYC Secure Card Checkout Notice We understand that you want all elements shown to your customers to fit your brand and website. With our goal of showcasing to customers clearly the steps of KYC it was still important for us to do so in a way that you could easily adjust the appearance to match your site. Within the payment settings of your gateway selection you have easy options to adjust the design coloring of the notice. Also, you can easily copy these settings across all gateways.
## **Step 10 — Crypto Ledger** Access at WooCommerce → VERIFIED Ledger. Consolidated view of all payments processed through your VERIFIED gateways. To activate the ledger transaction logging must be enabled. For plugins provided by partner agents and payment processing companies this is not needed. For plugin downloaded from the Wordpress repository you will need to allow **Transaction Logging** from within the gateway settings. Without this box being checked our plugin cannot keep a log of your transactions.
| **Field** | **What It Shows** | | ---------------- | -------------------------------------------------------------- | | Date / Time | When the checkout session was initiated. | | Order ID | Links directly to the WooCommerce order. | | Provider | Which on-ramp provider was used. | | Amount (USDC) | The USDC amount sent on-chain to your wallet. | | Status | Confirmed, Pending, or Failed, based on on-chain confirmation. | | Polygonscan Link | Direct link to the public blockchain record. | | **Reconciliation** The Ledger is useful for month-end reconciliation. Cross-reference USDC received in your Polygon wallet against WooCommerce order records. If an order shows Pending in WooCommerce but the Ledger shows a confirmed transaction, contact VERIFIED support with the transaction hash and order ID. | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | #### Step 10a - Export Ledger Report
From our VERIFIED Ledger you can export a report of your transactions as a CSV or Excel file. This can be filtered by the option fo date, status, event type (paid/initialized) and will hold all important transaction details. This is a great tool for accounting/bookkeeping and general auditing. ## **Step 11 — Request Payment — Payment Links & Invoices** Go to WooCommerce → Request Payment. Generate a payment link or send a branded invoice to any customer without them going through your store checkout. Useful for custom service invoices and off-site requests. Sending links through the Request Payment menu item is not tied to orders in anyway it is just a way to send direct payment requests and invoices. These have no integration to WooCommerce products or orders, if you want to send requests tied to products or orders use the feature described below from within the "Edit Order" screen.
## **Step 12 — Request Payment for Orders** Send payment links directly from any WooCommerce order screen — like a virtual terminal. Build an order in admin or recover an abandoned checkout, then send the customer a one-click Pay Now email. No login required.
The email template for these requests are handled in the WooCommerce email settings (all our plugin emails have templates within WooCommerce settings). The default text shown below is what is setup out of the box but would be specific to your site branding.
### **Three Use Cases** #### **Virtual Terminal** Create a new order in WooCommerce → Orders → Add New. Add billing details and line items. Select a VERIFIED gateway and click Send Payment Request. #### **Cart Recovery** When a customer starts checkout but never completes payment, open the order and click Send Payment Request to email a direct Pay Now link. #### **Edit and Re-Request** Edit order line items or totals, then click Send Payment Request. The meta box warns you the order was modified since the last request. The customer always pays the current total. ### Payment Link Sending Log When you send any links from the order details, there is a log of each email sent directly in order details.
## Step 13 - QR In Person Payments We know some merchants use their WooCommerce for in store or pop-up events so we wanted to offer a solution to get in person payments. From your order details screen right below the Send Payment Links tool there is a In-Person QR Code Payment tool.
This tool defaults to the auto-routing gateway but when select the dropdown can also choose any other gateway you have enabled. We envision stores using this on their main computer and sharing the monitor or using an in store tablet device. Once you press the Display QR Code for Customer a light-box opens.
The customer can scan the QR code with their own device and pay securely. The order will update after payment is received. If you know the customer paid refresh the page to see if the status shows "Processing." An order may take a few seconds or about a minute after confirmed on blockchain to update the order status. ## **Step 14 — Subscription Payments** VERIFIED Crypto Checkout is the first subscription solution where every renewal settles on-chain in USDC. Instead of auto-charging stored cards, VERIFIED sends customers a renewal reminder email before each due date containing a direct Pay Now link — no login, no cart. We integrate directly with WooCommerce Subscriptions and Subscriptions for WooCommerce. Download their plugins and our gateways are active for subscription products. With on chain subscriptions there are no chargebacks, since customer approves each purchase and is buying USDC. We have come up with the easiest way for a customer to renew, with tokenized one-click no login links in their email. They just click to pay and because they did KYC on their first visit they should have zero or low KYC on return for the renewal payment.
### **Renewal Reminder Schedule** Emails send automatically with no need to setup on your end. The time before renewal is caluclated by the plugin and gives the customer ample time to pay but also doesn't hound them with a million emails. Each subscription renewal has 2 emails automated to send, but if they pay on the first email the next email is automatically canceled. | **Billing Interval** | **Reminder Schedule** | | -------------------- | -------------------------------------------- | | Monthly or longer | 7 days before • 3 days before • 1 day before | | Weekly (4–7 days) | 3 days before • 1 day before | | Every 2–3 days | 1 day before • 4 hours before | | Daily | 4 hours before • 15 minutes before | ## **Step 15 — Automated Checkout Recovery** Automatically recover eligible unpaid VERIFIED orders by sending customers a no-login Pay Now email after a configurable delay. Optionally include a one-time discount or shipping credit. Every send, suppression, and incentive is logged directly on the order. This works for motivating any customers that fell out of checkout because of fear of KYC or otherwise. Look at this as a way to recover any pending orders on auto-pilot. Also, since sometimes a customer has other issues besides KYC at the crypto provider we allow you to select backup gateway options to showcase in the email. This tells the customer if they had any issues with the main provider, they can try the other two easily by the click of a button to pay. If an order has a large total you can even set a special disclaimer that will tell the customer they may want to try one of the other providers since they may allow larger order sizes. ### **15.1 How It Works** When a customer places a VERIFIED order but does not complete payment, the plugin schedules a recovery check after your configured delay (default: 60 minutes). At that point it evaluates whether the order is still eligible, optionally applies an incentive, then sends a branded no-login Pay Now email. One recovery email per order maximum. Off by default on all gateways. **Automatically in recovery emails we offer a backup payment option to use the auto-routing gateway which will let the customer select from any available providers.** This guarantees they have a chance to try another provider if they didn't like or had issues with first provider experience. Also, can select any backup gateway (2 max) just make sure you add a wallet to those gateways before setting as your backup. The gateways themselves do not need to be enabled on your checkout when used for a backup. These will be shown along with the auto-routing backup option. ### **15.2 Who Receives the Recovery Email** By default, only first-time VERIFIED customers receive the recovery email — customers who have never completed a VERIFIED purchase before on any gateway tied to the same account or billing email. This is the recommended setting, since these are the users who usually fall out of checkout because of KYC. ### **15.3 Configuring Auto Recovery (Per Gateway)** Auto recovery is configured separately for each VERIFIED gateway under WooCommerce → Settings → Payments → \[your gateway]. Scroll to the Auto Recovery Emails section: | **Setting** | **Default** | **Description** | | ------------------------------------------------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Enable auto recovery | Off | Automatically send one recovery email for eligible unpaid VERIFIED orders on this gateway. | | Recovery email delay | 60 minutes | How long to wait after a checkout attempt. Configurable in minutes, hours, or days. | | Do not send after | 3 days | Prevents stale recovery emails on older unpaid orders. | | Eligible order statuses | Pending Payment | Pending Payment is recommended. Failed is risky — the provider may already have charged the customer. | | First-time VERIFIED customers only | On | Only sends to customers who have never completed a prior VERIFIED purchase. Recommended. | | Enable recovery incentive | Off | Apply a one-time discount or shipping credit before the email is sent. No code required. | | Incentive type | Fixed | Fixed discount amount, percentage discount, or shipping credit. | | Maximum discount cap | Blank | Caps percentage discounts so the incentive stays predictable. | | Minimum order total for incentive | Blank | Only applies the incentive if the order reaches this amount. | | Incentive display label | Your Recovery Savings | Label shown in the recovery email and order notes. | | Apply recovery settings to all VERIFIED gateways | Off | One-time convenience: copies the current gateway's recovery setup — including email design, delays, discounts, and banner style — to every other VERIFIED gateway. Resets to off automatically after applying. | ![](/files/30NQtGugYIrqEzPmmOOn)

Auto Recovery Email and banner style settings in a gateway's configuration page.

| **Apply to All Gateways** The "Apply recovery settings to all VERIFIED gateways" checkbox is a one-time convenience tool. When you save gateway settings with this checked, the current recovery configuration is copied to every other VERIFIED gateway in your store. The checkbox resets to off automatically. You can still fine-tune individual gateways afterwards — different providers have different minimums and KYC friction levels, so different delays or discounts may perform better per gateway. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **15.4 Recovery Email Banner Style** When a recovery incentive is active, the recovery email shows a visual discount banner.
The banner's colours, icon, badge text, and CTA language are fully customizable per gateway: * Banner background color — default: dark green (#065f46) * Banner text color — default: white * Badge color — default: green (#059669) * Banner icon — gift box, lightning, lock, card, or none * Badge text — e.g. "Savings Applied" * CTA headline — e.g. "Finish Your Order Instantly — No Login Required" * CTA subtext (when incentive active) — e.g. "Complete Purchase + Save Money" * Banner helper text — e.g. "Your savings have already been applied — no code required." ### **15.5 The Recovery Email Incentive** When an incentive is configured and the order qualifies, the plugin automatically applies the discount to the order before generating the Pay Now link. The recovery email shows: original total (struck through), discount amount, updated total, service fee (if applicable), and amount due today. | **Important: Incentives are order-only** The recovery incentive only affects the specific order it was applied to. It does not change future subscription renewal pricing or any other orders for that customer. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### **15.6 Smart Recovery - Backup Options** You have the ability to select other options for your customers to try on their recovery attempt. We added this feature because we know that a person may come across distrust or issues with one provider, so in an attempt to motivate them to complete their order you as the merchant can select backup providers. {% hint style="info" %} AUTOMATICALLY whenever auto-recovery emails are enabled we offer auto-routing as a backup option to merchants. This allows them a guaranteed way to try other payment providers if they didn't like the first one or had troubles. {% endhint %} | Setting | Action | | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Show Backup Payment Options** | This shows within the recovery email backup payment options. Check box to enable. | | **Backup Providers** | This shows all gateways from VERIFIED and you can select up to 2 as backups. | | **Large Order Threshold** | Set dollar amount that should be considered large, this is what tells the plugin when to show the "Large Order Guidance Text" above the backup providers section of the email. (Only shows for orders at or above this dollar value.)A | | **Apply Backup Payment Settings to All VERIFIED Gateways** | Copy the backup providers to all gateways. You may not want to do this, since certain gateways only work in specific geographic regions. | {% hint style="info" %} When adding a backup gateway option make sure you add your wallet address to the gateways selected as backups. Selecting a backup gateway here does not enable it on frontend at checkout for the customer it only offers it as an option within the email. If you want any of the backup gateways enabled on checkout for the customer you still have to visit the settings of that gateway and enable manually. {% endhint %}
### **15.7 Viewing Recovery Status on an Order** Every order eligible for auto recovery shows an Auto Recovery panel in the VERIFIED Crypto Checkout meta box on the order edit screen. Three states are shown: #### **Scheduled** The recovery check has been scheduled and is waiting for the delay window to elapse. ![](/files/d1a8238460c0b59d4386babc3d788de53ec19c40)

Auto Recovery panel showing a scheduled check.

#### **Sent** The recovery email was sent. The panel shows the send time, which incentive was applied (if any), the service fee, and the exact amount sent in the email. ![](/files/0b7f3ec2ff2f11312530f49ecd7971113f1ed90a)

Auto Recovery panel after a recovery email was sent, showing incentive, fee, and amount due.

#### **Not Sent (Suppressed)** The check ran but the order was not eligible. The panel shows the specific reason — for example, "Customer already completed a VERIFIED purchase before," "Order exceeded the stale cutoff window," or "Auto recovery was manually suppressed for this order." | **Per-Order Override** Any order can have auto recovery suppressed manually. In the Auto Recovery panel, check "Suppress auto recovery for this order" and save. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **15.8 Recovered Revenue Totals** Each gateway's settings page shows a Recovered Revenue Totals section at the bottom of the auto recovery configuration: recovery emails sent, recovered paid orders, and total recovered revenue for that gateway.
## **Step 16 — Missed Payment Protection** An optional fallback that checks the Polygon blockchain directly for pending VERIFIED orders that may have been paid but whose provider webhook never reached your store. This feature never auto-completes orders — it only notifies the admin to review and act manually. {% hint style="info" %} To be safe we have the default for this set at 2 hours, but recommend adjusting it to as short as you feel comfortable to be notified. The sooner you are notified the better chance you have to update order quickly, but may end up with an unnecessary email if you set it too early. Below is our recommended settings for sooner delivery. {% endhint %} ### **16.1 The Problem This Solves** When a customer completes payment on a provider's page, the provider sends a webhook to your store to confirm the payment. If that webhook fails — due to a server outage, firewall, or timeout — the order stays permanently in Pending Payment status. The merchant never fulfills the order. The customer paid but hears nothing. To be clear the webhook failure rate is very very low but we wanted to be extra safe so added this layer of payment confidence for when it does fail. Today you can already verify any order manually using the Track Payment on Polygonscan button in the VERIFIED Crypto Checkout meta box. Missed Payment Protection automates this check for stuck orders. ### **16.2 How It Works** * A scheduled scanner runs at your configured frequency (default: every 3 hours). * It looks for pending VERIFIED orders older than the configured minimum age (default: 2 hours) that had a real checkout attempt but no on-chain check yet. * For each qualifying order, it queries the Polygon blockchain directly for USDC transfers to the order's temporary wallet address. * If a matching transfer is found: an order note is written with the transaction hash and a Polygonscan link, and a single admin alert email is sent. * If no transfer is found: an order note records that the check ran. Auto Recovery continues to handle the order through its normal flow. * The admin reviews the alert, verifies on Polygonscan, and manually marks the order as Processing if correct. | **Manual review only — no auto-completion** Even when Missed Payment Protection finds a matching on-chain transfer, it never changes the order status automatically. The admin always reviews and acts. This is intentional — the plugin cannot independently verify that the amount is exactly correct or that the provider has not already issued a refund. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **16.3 Setup** Go to WooCommerce → Missed Payment Protection. Configure the settings and click Save Changes:
{% hint style="info" %} A [free Polygonscan API key](https://etherscan.io/apis?id=137) is optional but recommended for reliability - public endpoints can rate-limit on busier stores, so a key makes the lookups more consistent. Without one it still runs and never affects checkout; worst case it just adds an order note that it couldn't finish a check, so you review manually. \~2 minutes to add if a merchant wants maximum reliability. {% endhint %} *The Missed Payment Protection settings page under WooCommerce.* | **Setting** | **Default** | **Description** | | ------------------------------ | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Enable missed webhook check | On (Recommended) | Activates the on-chain scanner. Recommended: enabled. | | Minimum order age before check | 2 hours | How long to wait before checking. Set long enough for normal provider confirmations to arrive first. 2 hours recommended. | | Scanner frequency | Every 3 hours | How often the scanner runs. Catches missed webhooks within a business day. | | Alert email recipient | Admin email | Where to send stuck order alerts. Change to route to your finance team or a dedicated inbox. | | Polygonscan API key (optional) | Blank | Leave blank to use the free public Polygon RPC (no registration required). Add a free key for more consistent detection on high-volume stores. | | **No API key required** The public Polygon RPC endpoint (polygon-rpc.com) is used by default at no cost and with no registration. The free Polygonscan API key is optional — it covers up to 100,000 queries per day, far beyond any realistic order volume. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ### **16.4 The Admin Alert Email** When a matching on-chain transfer is found, the admin receives a single email titled "Possible paid order stuck in Pending — review #\[order number]." ![](/files/89dc1cc1fa8455f7448f72c9f788479a26577183) *The admin alert email sent when a matching on-chain USDC transfer is found for a stuck pending order.* The email contains: order number and customer name, USDC amount found on-chain, a direct Polygonscan link to the specific transaction, the temporary wallet address, a link to the WooCommerce order edit screen, and clear instructions to verify and manually mark as Processing if correct. The email fires exactly once per order. If the scanner runs again before you act, no second email is sent. ### **16.5 Order Note and Meta Box** Every check outcome writes a permanent order note. The VERIFIED Crypto Checkout meta box on the order edit screen shows the on-chain check status: transfer found (with tx hash and Polygonscan link), nothing found, or check failed with advice to review manually. ## **Frequently Asked Questions** **Do my customers need a crypto wallet?** No. Customers pay through an independent hosted provider using a credit card, debit card, Apple Pay, Google Pay, or another method supported by that provider. The provider handles the conversion to crypto. The merchant—not the customer—needs a compatible wallet to receive settlement. **What is the minimum transaction amount?** Minimums vary by provider, payment method, currency, and customer location. Do not rely on a fixed minimum for every VERIFIED gateway. The plugin and hosted provider will determine whether the order qualifies for the selected payment option. **Will customers have to verify their identity every time?** Not necessarily. Identity-verification requirements are controlled by the independent provider. A first purchase may require identification and a liveness check. Returning customers using the same provider often have a faster experience, but reduced or skipped verification is not guaranteed. Using a consistent provider can reduce repeat verification. Auto-Routing provides broader provider availability but may route a returning customer to a provider they have not used before. **The provider checkout shows a different crypto or settlement amount than my store. Is this a problem?** Not necessarily. WooCommerce sends the order amount to the hosted provider, but the provider may separately display the crypto purchase amount, exchange rate, conversion fee, or estimated settlement. Provider conversion fees are generally deducted from the crypto settlement sent to the merchant wallet. The customer’s card issuer may also apply separate cash-advance, foreign-exchange, or crypto-purchase charges that are outside WooCommerce and VERIFIED. Review the WooCommerce order total, provider confirmation, transaction record, and amount received in your wallet before treating a significant discrepancy as an error. **A customer’s card was declined. What should I tell them?** Ask the customer to try a Visa or Mastercard debit card, another supported payment method, or a different provider. Some banks restrict crypto-related credit-card transactions, while debit cards often have higher approval rates. A decline is controlled by the customer’s bank or the independent provider. VERIFIED cannot override it or guarantee that another payment method will be approved. **Can I send a payment link for an unpaid or abandoned order?** Yes. Use the **Request Payment for Order** feature described in Step 12. Open the WooCommerce order, select an enabled VERIFIED gateway, and send the customer a tokenized Pay Now link. You can use this for abandoned orders, manually created orders, phone orders, or edited orders that still require payment. **Can VERIFIED recover abandoned checkouts automatically?** Yes. Automated Checkout Recovery is covered in Step 15. When an eligible first-time customer reaches a provider but does not complete payment, the plugin can send one recovery email after the configured delay. Merchants can configure eligible order statuses, timing, email appearance, backup payment options, and an optional fixed discount, percentage discount, or shipping credit. **Does every abandoned order receive an automatic recovery email?** No. The order must meet the merchant’s recovery settings and eligibility rules. Automated recovery generally applies to first-time VERIFIED customers who reached the provider but did not complete payment. Customers with a previous successful VERIFIED purchase and subscription renewal orders are excluded from the standard abandoned-checkout recovery flow. **I have several VERIFIED gateways. Do I need to configure recovery settings on each one?** No. Configure the recovery settings on one gateway and select **Apply recovery settings to all VERIFIED gateways** before saving. The plugin copies the recovery configuration to the other VERIFIED gateways. Their existing enabled or disabled status is not changed, and the copy checkbox resets after the settings are applied. **What if a recovery email was sent but the order still was not paid?** Automated Checkout Recovery sends a maximum of one automatic recovery email per eligible order. If a manual follow-up is appropriate, open the order and use the **Request Payment for Order** feature from Step 12. Check the order status and wallet before sending another payment request to avoid requesting payment for an order that may already have settled. **What happens if a payment confirmation webhook never reaches my store?** Missed Payment Protection, covered in Step 16, checks eligible pending and recently cancelled VERIFIED orders for matching on-chain settlement. When matching funds are found, the plugin adds an order note and sends the merchant an administrative alert for review. This fallback does not automatically complete the order. Confirm the settlement in the merchant wallet before changing the order status or fulfilling the order. **Are VERIFIED Pay Now links secure?** Each Pay Now link uses a 192-bit random token stored as a SHA-256 hash. The link is associated with a specific WooCommerce order and expires after seven days. The customer does not need to enter a WordPress password. Payment is still completed on the independent provider’s hosted checkout, and card data does not pass through the merchant’s WordPress site. **Can I issue a refund through the plugin?** No. Confirmed blockchain settlements cannot be automatically reversed through WooCommerce. If a refund is appropriate, the merchant must arrange it separately and verify the correct refund destination with the customer. Do not automatically return funds to the originating blockchain address because that address may belong to an intermediary or hosted provider. **Does a customer need an account for subscription payments?** A WooCommerce subscription is normally associated with a customer account so the customer and merchant can manage the subscription. The VERIFIED renewal email contains a secure tokenized Pay Now link, so the customer normally does not need to manually enter a WordPress username and password to complete that renewal payment. Subscription functionality is covered in Step 14. **What is the VERIFIED Thank-You Page and hosted waiting room?** The VERIFIED Thank-You Page, covered in Step 6, is a merchant-branded customer-experience layer for WooCommerce checkout. After the customer places an order, the waiting room opens the independent provider checkout and monitors the existing WooCommerce order. When WooCommerce confirms payment, the waiting room becomes a receipt. The page does not process card data, custody funds, or determine whether the order is paid. **Is the VERIFIED Thank-You Page enabled automatically?** Yes. In the current plugin release, version 1.56.43, the branded Thank-You Page is enabled by default for new installations. Existing stores are also enabled and receive an administrative notice with an option to turn it off. Merchants can enable, disable, or configure it at **WooCommerce → VERIFIED Thank-You Page**. Turning it off restores the previous direct-provider redirect experience. **Does the VERIFIED Thank-You Page mark the order paid?** No. The Thank-You Page and waiting room are read-only. WooCommerce remains the system of record. The provider callback, on-chain verifier, and settlement safeguards determine the order status. The waiting room only displays the status reported by WooCommerce. **Why should the Thank-You Page open the provider checkout in a new tab?** The **New tab** option is recommended because it keeps the merchant-branded waiting room open while the customer completes payment on the independent provider page. The waiting room can continue monitoring the WooCommerce order and become the receipt when payment is confirmed. With **Same tab**, the customer leaves the waiting room and may not see the automatic receipt unless they return to it. **What does the customer see in the VERIFIED waiting room?** The waiting room can display the merchant’s store name, logo, configured colours, order number, order total, and current payment status. It explains that payment is completed in the secure provider window and checks WooCommerce for confirmation. When payment is confirmed, the waiting room changes into the merchant’s selected receipt format. **What information appears on the VERIFIED Thank-You Page receipt?** The merchant selects the receipt detail level under **WooCommerce → VERIFIED Thank-You Page**. **Minimal** provides a limited order receipt. **Standard** adds order totals such as subtotal, shipping, tax, and item count. **Full** can show product images, item names, quantities, line totals, subtotal, shipping, tax, total, billing name and address, payment method, verified on-chain amount, and a settlement transaction linked to the appropriate block explorer. Payment information appears only when it is available for the order. **Who can view the VERIFIED Thank-You Page receipt?** Anyone holding the temporary thank-you link may be able to view the selected receipt detail during the link’s 48-hour life. Because the Full receipt can include product and billing details, merchants should select the receipt level appropriate for their privacy and customer-service requirements. Use Standard or Minimal when the additional Full-receipt information is unnecessary. **Does the VERIFIED waiting room work with Auto-Routing?** Yes. Auto-Routing can use the branded waiting room and paid receipt. The separate **Try a different provider** option is not displayed when Auto-Routing was the original payment method because the customer is already using the provider chooser. **What does “Try a different provider” do in the VERIFIED waiting room?** When the customer started with a specific provider, **Try a different provider** opens the hosted Auto-Routing chooser for the same WooCommerce order and payment destination. It does not create another WooCommerce order. The customer must complete payment with one provider only. **Can a customer pay twice through the “Try a different provider” option?** Yes. A duplicate settlement is possible if the customer starts payment in two provider windows and completes both. The waiting room warns the customer to use one provider only and hides its payment options after WooCommerce confirms the first payment. However, it cannot stop another provider payment that is already in progress. If two payments settle, WooCommerce still has one order, but both settlements may reach the merchant wallet. The merchant must reconcile the transactions and arrange any appropriate refund manually. **What does “Back to checkout” do in the VERIFIED waiting room?** By default, **Back to checkout** opens WooCommerce’s payment page for the same pending order. The customer can review that order and select another available payment method without creating a new WooCommerce order. This is the recommended return path for most stores. **What does the Thank-You Page’s optional Cart restore setting do?** Cart restore repopulates an empty cart from the unpaid order and sends the customer to the normal WooCommerce checkout. Completing the restored checkout creates a new WooCommerce order and leaves the original order pending for the store’s normal cleanup process. Product availability, price, shipping, and tax are recalculated, and an existing non-empty cart is not overwritten. Most stores should leave Cart restore disabled and use the default same-order payment page. **What happens if the VERIFIED hosted waiting room is unavailable?** The plugin falls back to the previous direct-provider redirect. The customer can continue payment through the existing gateway flow; only the waiting-room and automatic receipt experience is skipped for that attempt. The Thank-You Page is designed as a customer-experience layer and cannot replace or interrupt the underlying payment and settlement flow. ## **Appendix — KYC Requirements by Provider** | **Important** This is a research reference, not a guarantee. Provider KYC policies can change at any time. Always verify the current flow with a test transaction before relying on this table for customer-facing communications. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Provider** | **Initial Verification** | **Higher-Tier Checks** | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | Stripe | Some users get to skip since have Stripe/Link accounts already. Name, DOB, address, government ID, selfie. SSN required for US customers. | Enhanced review for high-value or flagged transactions | | Ramp Network | Name, phone, government ID, selfie / liveness check | Proof of address and source-of-funds for higher limits | | Transak | Lite KYC (name, DOB, phone) or Standard KYC with ID + selfie | Proof of address and financial documentation | | Banxa | Personal details, passport or license upload, selfie check | Proof of funds for large transactions | | Guardarian | Email, personal details, government ID upload | Proof of address for higher-value purchases | | Simplex | Email, government ID upload, selfie verification | Additional review or questionnaire if flagged | | Topper (Uphold) | Account registration, email, government ID | Address verification depending on jurisdiction | | Bitnovo | Full name, DOB, address, ID upload (front/back), 3D selfie | Proof of address for higher-value purchases | | Cryptix | No verification under $700. Above: personal details, ID, selfie (FINTRAC MSB, Canada) | Enhanced due diligence for larger transactions | | Unlimit (GateFi) | Personal info, government ID, selfie | Proof of residence and compliance review | | Utorg | Personal details, government ID, selfie | Manual review depending on risk signals | | Kryptonim | Government ID and selfie | Proof of address or source-of-funds by region | | Sardine | Phone/email, government ID, selfie, device risk analysis | Sanctions screening and fraud analysis | | TransFi | Government ID and proof of address | Enhanced due diligence for higher-risk transactions | | Binance | Existing Binance account with KYC completed on Binance.com | Proof of address or source-of-funds for higher tiers | | Robinhood Connect | Existing Robinhood account with verification completed | Additional verification by transaction size | | Revolut Ramp | Revolut account KYC or integrated identity verification | Typically none if Revolut already verified | | Interac (Canada) | Government ID photo and biometric selfie | Depends on participating provider | | UPI (India) | KYC-verified bank account and identity confirmation | PAN or address verification may be required |