Adding Bitcoin to your checkout in one day

The honest version of "one day"

Most Bitcoin payment vendors will tell you their integration takes "minutes." That's true for a demo. For a real business — with your real merchant accounts, your real tax setup, your real staff who need to actually understand the new flow — plan on one focused day.

Here's what that day actually looks like:

• Morning (1–2 hours): Account creation, identity verification, payout method setup
• Mid-morning (1 hour): Install the integration (plugin or API), test a payment in sandbox
• Lunch (skip the technical stuff): Eat
• Afternoon (1–2 hours): Configure settlement preferences, run a live test transaction, brief your staff
• End of day: Bitcoin is live at your checkout

Not "in five minutes." Not "in two weeks." One day, focused, done.

If you've allocated significantly more or less than that, you're probably either over-engineering or under-preparing. This lesson walks through the right amount.

Step 1: Create your VoltageAI account (15 minutes)

You'll need:

• Your business name and EIN (or SSN if you're a sole proprietor)
• The bank account you want USD payouts sent to (routing + account number)
• A government-issued ID for KYC (driver's license is fine)
• The website or business name your customers will see when they pay

The account-creation flow is straightforward — same kind of information you'd give Stripe or Square. The KYC step usually verifies in real-time (under 60 seconds); occasionally it routes to a human reviewer and takes a few hours. You can keep working on other steps while that processes.

One thing to decide during signup: what your customer-facing payment receipt will say. By default it shows your business name. You can customize it to include a phone number, a return policy URL, or anything else useful for customer support.

Step 2: Verify your business and set up payouts (15 minutes)

Once your KYC is approved, you'll connect your bank account for USD settlement.

This works exactly like Stripe — micro-deposit verification (two small test deposits in 1–2 business days) or instant verification via Plaid (login to your bank account through their secure flow, link confirmed immediately).

Pick instant verification if possible. It saves you a step in the next-day callback.

You'll also set:

• Payout frequency: Daily (default), weekly, or manual. Most merchants pick daily.
• Payout minimum: Default $1. You can raise it to consolidate (e.g., "only payout when balance exceeds $500") — useful for businesses with high transaction volume and low ACH friction tolerance.
• Bitcoin-or-USD split: Default 100% USD. You can change this later (covered in Lesson 5).

Step 3: Install the integration (15 minutes to 2 hours, depending on path)

Pick your path based on your existing tech stack.

Path A: Shopify, WooCommerce, BigCommerce, or Squarespace (15 minutes)

These are the plugin paths. Total work:

1. Go to your platform's app/extension store.
2. Search "VoltageAI" or "Lightning Payments."
3. Install the app.
4. Paste your VoltageAI API key (you'll find it in your dashboard under Settings > API Keys).
5. Enable Bitcoin as a checkout option.
6. Test a transaction in your platform's sandbox mode.

For Shopify specifically: the app appears at checkout as a payment option alongside Shop Pay, Apple Pay, and card. Your customer picks Bitcoin, a QR code displays, they pay, the order completes.

For WooCommerce: same idea, but you'll see Bitcoin appear in your WooCommerce > Settings > Payments table.

For Squarespace: requires Squarespace Commerce (not the basic site builder). Bitcoin appears as a custom payment option in checkout.

Path B: Custom-built checkout, Stripe-replacement, or full API (1–2 hours)

This is for businesses with engineering teams or custom carts. The integration is a clean REST API — about 10 endpoints in total — with full documentation and code samples in JavaScript, Python, Ruby, and PHP.

The minimum viable integration:

1. Generate a Lightning invoice for the order amount (1 API call).
2. Display the QR code (or the invoice string for desktop wallets) to the customer.
3. Listen for the payment confirmation via webhook (we send it to your endpoint).
4. On confirmation, mark the order paid in your system.

A confident developer can ship this in an afternoon. Most do.

Path C: In-person POS (varies)

If you're running a physical location, the integration depends on your POS:

• Square: Install the VoltageAI app from Square's App Marketplace. Bitcoin appears as a tender type alongside cash and card.
• Toast: Same flow via Toast's Add-Ons section.
• Clover, Lightspeed, Shopkeep: Available via their app stores.
• Tablet/iPad-based POS we don't natively integrate with: Use our standalone POS app on a separate tablet — sits next to your existing POS, handles only Bitcoin transactions, syncs with your VoltageAI dashboard.

Worth noting: many businesses use the standalone tablet approach even when their main POS supports VoltageAI directly. It keeps the Bitcoin flow visually separate during staff training, which is its own benefit.

Step 4: Run a live test transaction (15 minutes)

This is the most important step and the one most merchants skip.

Do not skip it.

Before you announce to your customers that you accept Bitcoin, run a real transaction from your own wallet to your own account. This catches:

• Misconfigured payout accounts (where the USD lands in the wrong bank)
• Wrong receipt branding (customer sees a confusing merchant name)
• Plugin errors (the QR code doesn't actually appear at checkout)
• Staff confusion ("wait, where did the receipt print?")

How to run a real test:

1. Set up the smallest possible transaction (e.g., a $1 product, or a custom invoice for $0.50).
2. Pay it from your own wallet (Cash App, Strike, or any Lightning wallet you control).
3. Confirm the payment appears in your dashboard within a minute.
4. Confirm the USD shows up in your bank on the next payout cycle.
5. Confirm the receipt looks right.

That's it. Now you know it works end-to-end before any customer touches it.

Step 5: Brief your staff (15 minutes)

Lesson 7 covers this in detail. The short version: you don't need to teach them about Bitcoin. You need to teach them about the new button on their POS.

The script is roughly:

"We accept Bitcoin now. If a customer wants to pay in Bitcoin, tap the new Bitcoin button on the POS. A QR code will appear on the screen. The customer will scan it with their phone. In a few seconds, the screen will say 'paid' and you can hand them their order. That's it."

Most staff get this in under 5 minutes. The remaining time is for them to ask questions and run a few mock transactions.

Step 6: Tell your customers (optional but recommended)

You now accept Bitcoin. The remaining question is whether anyone knows.

For most businesses, the highest-ROI announcements are:

• A sticker or sign at the register: "Bitcoin accepted via Lightning." Costs $5. Catches the curious customer.
• A line at the bottom of your menu, invoice, or checkout: Same idea, lower friction.
• A short post on your social channels: Higher visibility, lower conversion, but useful for the Bitcoin-native customer segment to find you.
• An email to your existing customer list: Highest conversion. Worth doing once, never on a recurring basis.

The mistake to avoid: making Bitcoin acceptance the centerpiece of your marketing. It's an additional payment lane, not a brand identity. Mention it; don't lead with it. (Unless you're a business that specifically wants to attract Bitcoin-native customers — bars, gyms, cafes positioning around the culture — in which case lead with whatever's authentic.)

What "one day" actually delivered

By end of day, you have:

• A live Bitcoin payment option at your checkout (or POS)
• Verified payouts to your bank
• A real test transaction confirming the end-to-end flow works
• Staff briefed on what to do when a customer asks to pay this way
• Optional: a sign or note announcing the new capability

The next morning, when your first real customer pays you in Bitcoin, nothing surprises you.

What's next

Next up: Lesson 7 — Training your staff in 20 minutes. The literal script. Front-desk language for "we take Bitcoin," how to handle the curious customer, how to handle the skeptical one.