# VERIFIED Crypto Checkout Plugin Guide #### The Most Feature Rich Card to Crypto WooCommerce OnRamp Available Accept Credit Cards via Crypto — Up and Running in Minutes {% 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. {% endhint %} #### This Guide Covers Installation • Configuration • Payment Links • Order Requests • Auto Recovery • Subscriptions **v1.56+ — April 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–8** | Install, configure, and go live with VERIFIED Crypto Checkout | | **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** | Subscription Payments — recurring billing via email-based renewals | | **Step 14** | Automated Checkout Recovery — recover unpaid orders with no-login Pay Now emails and optional incentives | | **Step 15** | 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. {% 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. If possible based on your target customers would be best to only enable one gateway that is ideal for their location and your product prices, so as to not ever make them do KYC multiple times on accident (by them selecting a different provider on a return visit). Our plugin is available globally so some gateways will not be relevant to your customers, please enable them wisely. | **Provider** | **Key Notes** | **Best For** | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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. | | MoonPay (USA) | Common US option. Apple Pay, Google Pay, Visa, Mastercard. $20 minimum. Smooth KYC flow. | US merchants, orders $20+ | | Stripe (USA) | Widely trusted brand, lowest US fees. 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 and MoonPay Just lesser brand awareness although UpHold (their parent company is growing). | | Auto-Routing | Shows a provider selection screen to the customer. They choose from options available for their region. | International / multi-geography stores | | 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, enable a single specific provider rather than Auto-Routing. A customer who completes KYC with a specific provider will be recognized on return visits — meaning faster, friction-free checkout next time. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | {% 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 — 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 7 — 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. |
## **Step 8 — 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 * Customer notice added explaining no redirect occurs after payment (Step 6) * 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. 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 MoonPay 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). ![](https://1231517345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGOxAWfdGh9Nfwnf7Ppgl%2Fuploads%2Fn23Wf0qtlLTstFjZQXra%2FScreenshot%202026-04-05%20at%202.54.04%E2%80%AFPM.png?alt=media\&token=aa537062-8b0d-431a-83eb-048292b75859) *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. | **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 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 — 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 14 — 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. ### **14.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. ### **14.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. ### **14.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. | ![](https://1231517345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGOxAWfdGh9Nfwnf7Ppgl%2Fuploads%2FBqbaJz6sCE1r9pQAmyZz%2FWooCommerce-settings-%E2%80%B9-VERIFIED-Crypto-Checkout-%E2%80%94-WordPress.png?alt=media\&token=86892e39-e79c-4d0a-960f-55997a07954e)

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. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **14.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." ### **14.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. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### **14.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 %}
### **14.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. ![](https://content.gitbook.com/content/GOxAWfdGh9Nfwnf7Ppgl/blobs/o9PMTCv7eNrwZAuuREIw/Unknown%20image)

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. ![](https://content.gitbook.com/content/GOxAWfdGh9Nfwnf7Ppgl/blobs/N6ty5xlmtu8T46MEgyRU/Unknown%20image)

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. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **14.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 15 — 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. ### **15.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. ### **15.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. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ### **15.3 Setup** Go to WooCommerce → Missed Payment Protection. Configure the settings and click Save Changes: ![](https://content.gitbook.com/content/GOxAWfdGh9Nfwnf7Ppgl/blobs/BL1HwuwcKRy0v6FtPvrU/Unknown%20image) *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. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ### **15.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]." ![](https://content.gitbook.com/content/GOxAWfdGh9Nfwnf7Ppgl/blobs/PY0Kcl6GJDvyI3wnRlCx/Unknown%20image) *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. ### **15.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 with their credit or debit card as normal. The conversion to USDC happens automatically in the background. **What is the minimum transaction amount?** Depends on the provider. MoonPay requires $20 USD. Stripe requires $2. Other providers have their own minimums. **Will customers have to verify their identity every time?** In most cases, once a customer completes KYC with a specific provider, subsequent purchases are faster or skip verification. This is a key reason to use a single dedicated provider rather than Auto-Routing. **The provider's checkout shows a different price than my store. Is this a problem?** No. The provider displays the net USDC settlement amount after deducting its own conversion fee. Your customer is charged their exact order total. **A customer's card was declined. What should I tell them?** Many banks block crypto purchases on credit cards. Recommend the customer try a Visa or Mastercard debit card — debit cards have significantly higher approval rates. **Can I send a payment link for an order the customer abandoned?** Yes — this is exactly what the Order Payment Request feature (Step 12) is for. Open the order, select a gateway, click Send Payment Request. **Can I recover abandoned checkouts automatically?** Yes — Step 14 covers Automated Checkout Recovery. Enable it in gateway settings, configure the delay and optional incentive, and the plugin handles the rest. **I have many VERIFIED gateways. Do I have to configure auto recovery on each one?** No. Use the "Apply recovery settings to all VERIFIED gateways" checkbox on any one gateway. Save with that box checked and the current recovery configuration is copied to every other gateway automatically. The checkbox resets after applying. **What if a recovery email was sent but the order still wasn't paid?** The recovery system sends one email per order maximum. Use the Order Payment Request meta box (Step 12) to send a manual follow-up at any time. **What happens if a payment webhook never arrives?** Missed Payment Protection (Step 15) is designed for this. It scans stuck pending orders and checks the Polygon blockchain. If USDC arrived on-chain, you receive a single admin alert email to review and confirm. **Is the Pay Now link secure?** Yes. Each link contains a 192-bit random token stored as a SHA-256 hash. It is single-use and expires in 7 days. **Can I issue a refund?** Because transactions are final on-chain, refunds cannot be reversed automatically. If a refund is appropriate, send USDC manually from your wallet to the customer. **Does the customer need an account for subscriptions?** Yes — subscriptions are linked to user accounts. The renewal flow signs them in silently via token. They never see a login screen. ## **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** | | ----------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------- | | MoonPay | Name, email, address, government ID, selfie / liveness check | Proof of address or source-of-funds for larger purchases | | Stripe | 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 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://verified-crypto-checkout.gitbook.io/verified-crypto-checkout/verified-crypto-checkout-plugin-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.