Buy Crypto Module

What the Buy Crypto Module Is

The Buy Crypto module is the "I just want to buy some BTC" flow your users see. A visitor picks a coin and an amount, gets a live price quote, picks a payment method and checks out. The purchase is tracked as a custom WordPress post (post type crypto_purchase) and the actual checkout / payment lives in the shared Checkout Module.

Where to Find It

Open WP Crypto → Crypto Sales in the WordPress admin sidebar. This is the standard WordPress post list filtered to the crypto_purchase post type. From there you can add a new coin / sale, edit an existing one, or trash one you no longer offer.

The 60 Popular Coins

When you add a new "crypto sale" the form offers a quick-add grid pre-filled with the 60 most-traded Binance coins. Picking one fills the symbol, name and reasonable defaults for you. The grid contains:

For these coins the live price comes from Binance via the WPCrypto gateway; you do not have to maintain prices manually.

Adding a Custom Coin

If your token is not on the popular list, you can still sell it through the module. Custom coins use admin-controlled pricing.

1. WP Crypto → Crypto Sales → Add New.
2. Fill the basic fields: coin symbol, full name, logo image, sale description.
3. Set the manual price in the chosen quote currency (typically USDT). The price persists until you change it.
4. Set the per-purchase limits (min and max), the commission rate, and the default step size and tick size. The plugin defaults custom coins to step_size = 0.00000001 and tick_size = 0.01 (i.e. 8-decimal quantity precision, 2-decimal price precision).
5. Publish. The new coin is now available in the buy-crypto interface alongside the popular ones.

The Buy Flow

1. User picks a coin and amount. The UI shows the live (or manual) price, fee and final cost before the user commits.
2. User picks a payment method. Only methods you enabled in General Settings appear — typically PayPal, Stripe, crypto balance and MetaMask.
3. The purchase is created. The plugin records a pending order with a unique confirmation code and sends the user to the checkout page.
4. Checkout completes. Control hands off to the Checkout Module, which charges the user via the chosen gateway.
5. Coin is credited to the user's balance. On success the order is marked as completed, the user's internal balance for the bought coin is topped up, and the success page renders the receipt.

Guests (not logged in) are redirected to the login page as soon as they try to start a purchase — there is no guest checkout for buy-crypto. This was a deliberate change away from rate-limiting visitors.

Order Status

A buy-crypto purchase has a simple lifecycle: it sits as pending until the user pays, then moves to completed when the payment is confirmed and the coin is credited. There are no intermediate "Processing", "Cancelled" or "Failed" steps — a failed payment leaves the order pending until the user retries or you remove it.

Commissions and Pricing

Every coin you add has its own commission rate (a single percentage). On purchase, the plugin computes the gross quote-cost, adds the commission to it, and stores both the gross and the commission in the order row. The credited base-coin amount is the gross divided by the price you saw at quote time.

For popular coins the price is live; for custom coins it is whatever you saved on the post — there is no oracle for custom coins, so update the price when the market moves.

Public Coin List Shortcode

Use [wpcrypto_supported_coins_fees] to render a public table of supported coins and their commission rates on any page. This is the only shortcode this module exposes — the actual buy interface is part of the checkout flow on the coin page itself.

Operator Notes

Troubleshooting