> ## Documentation Index
> Fetch the complete documentation index at: https://www.bitnob.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Bitnob API requests authenticate with an `X-Auth-Client` API key header against https://api.bitnob.com.
> Always use the sandbox environment for testing. Never put live API keys in sample code.
> Money amounts are integers in the smallest unit of the currency (satoshis for BTC, cents for fiat). Never use floats.
> Every state-changing request takes a client-supplied `reference` and must be treated as idempotent on retry.
> Quotes expire. Re-quote rather than reusing a stale quote id.

# Module 18: Marketing Bitcoin products

> Market Bitcoin products around the problems users actually have, not the technology behind them.

## 18.1 Why Bitcoin should solve problems, not preach ideology

They wake up saying:

* "How do I send money to my sister today?"
* "How do I keep my salary safe from inflation?"
* "How do I save for my kids?"

Bitcoin succeeds when it solves real problems silently, beautifully, and trustworthily.

You don’t need to turn every user into a Bitcoin philosopher.

You just need to:

* Make Bitcoin useful,
* Make it safe,
* Make it trusted.

Philosophy can come later, if users want it.

## 18.2 Bitcoin circular economies: How Bitcoin really grows

A Bitcoin circular economy means:

* People earn Bitcoin (work, business, gig economy),
* People spend bitcoin (goods, services, remittances),
* People save Bitcoin (inflation protection),
* Bitcoin flows locally and globally, without fiat intermediaries dominating every transaction.

**Real case studies:**

**El Zonte, El Salvador ("Bitcoin Beach"):**

* Bitcoin used for paying teachers, fishermen, merchants.
* No banks needed.
* No "Bitcoin education" courses.
* Just work → pay → spend → live.

**Nigeria (especially Lagos, Abuja, and Jos underground Bitcoin scenes):**

* Designers, freelancers, and merchants accepting bitcoin quietly.
* Cross-border payments with minimal fees.
* Mobile Bitcoin apps solving everyday currency risk.

**Kenya and Uganda (emerging Bitcoin remittance hubs):**

* Bitcoin received via custodial apps.
* Cashed out via local vendors or spent directly.
* Bitcoin solving money flow barriers that traditional banks failed at.

**Philippines (OFW remittances):**

* Migrant workers using Bitcoin rails behind the scenes.
* Custodial apps hide Bitcoin complexity but use Bitcoin settlement for cheap remittances.

## 18.3 Custodial platforms are part of the revolution

Not everyone must self-custody on Day 1.

Custodial apps (like Bitnob, Strike, Cash App) act as gentle Bitcoin onramps. Users learn Bitcoin through practical experience first:

* Paying merchants,
* Saving for school fees,
* Sending money to family.

Custodial trust must be earned, not forced.

Custodial platforms must act like Bitcoin babysitters, raising users until they are ready for full self-custody, if ever.

Marketing must embrace this reality, not shame it.

## 18.4 Marketing Bitcoin through stories, not lectures

People don't remember your whitepaper. They remember Ada using Bitcoin to save her wedding fund in inflation. They remember Chinedu paying his uncle in Jos with bitcoin faster than a bank transfer.

👉 Storytelling is Bitcoin marketing.

**Real storytelling tactics:**

* Short YouTube documentaries (\~3–5 minutes).
* Instagram Reels/TikToks of real people solving real money problems with bitcoin.
* Micro-stories inside your app:
  * "Ada saved ₦250,000 last year in bitcoin using Bitnob."
  * "Kojo paid his rent in Accra using Bitcoin. No middlemen. No delays."

## 18.5 Practical use cases that sell bitcoin naturally

| Problem | Bitcoin Product Solution |
| - | - |
| Inflation eating savings | Save in bitcoin, escape currency debasement. |
| Remittances trapped by banks | Send bitcoin globally in minutes, spend or cash out locally. |
| Merchants losing 5–10% to card fees | Accept Bitcoin payments at near-zero cost. |
| Freelancers blocked by PayPal, Wise, banks | Get paid in bitcoin, settle faster, lower fees. |
| Youth unemployment | Empower Bitcoin circular economies for digital gigs, P2P commerce. |

👉 Sell the problem being solved. Bitcoin is the vehicle, not the headline.

## 18.6 Designing products people can use without studying Bitcoin

Good Bitcoin UX hides complexity without hiding power.

| Feature | Design Principle |
| - | - |
| Backup flows | Force backup, but explain in 1 sentence. No Bitcoin whitepapers at onboarding. |
| Fee selection | Offer "Fast," "Normal," "Economy": not "choose sat/vbyte manually." |
| Privacy defaults | Rotate addresses quietly. Use Taproot without explaining Merkle trees. |
| Buy bitcoin flows | Show fiat equivalent, explain volatility simply: "Bitcoin price changes. Watch your investment grow or shrink." |
| Recovery flows | Make restoring from backup beautiful and clear, not geeky. |

👉 Bitcoin should feel like magic, even if it's still real technology.

## 18.7 How to build trust and growth together

| Trust Action | Growth Outcome |
| - | - |
| Teach users at the right moment | Higher activation rates |
| Deliver transactions reliably | Higher retention |
| Empower real community ambassadors | Viral local growth |
| Offer fair fees with transparency | Lower churn |
| Celebrate real user stories | Higher emotional connection and shareability |

**Trust is key:** Trust is Bitcoin’s true marketing secret weapon. Features matter, but trust compounds.

## 18.8 Interactive action plan: Build your first Bitcoin circular economy

**Internal team challenge:** 👉 Within 30 days:

* Find 5 local merchants willing to accept Bitcoin (even via custodial wallet at first).
* Offer Bitcoin payouts to your top 10 freelance users.
* Reward first 100 peer-to-peer Bitcoin sends inside your app.
* Interview 3 users about how Bitcoin helped them solve a real problem.
* Create your first short video or blog post sharing one real Bitcoin journey.

**Result:** You won't just grow an app. You’ll grow a living Bitcoin ecosystem, which sells itself long after the ad budgets stop.

## Bitcoin circular economy playbook

How to Build Real Bitcoin Usage Locally and Globally

A Bitcoin circular economy happens when:

* People earn Bitcoin (salaries, gigs, commerce),
* People spend bitcoin (food, rent, transport, services),
* People save Bitcoin (for future purchasing power).

👉 Bitcoin flows without needing to constantly touch fiat. 👉 Bitcoin becomes daily money, not just an investment.

**Goal of this playbook:** Equip you to build one in your city, market, campus, or community.

## Phase 1: Seed the circular economy

### 1. Identify key players

| Type | Target |
| - | - |
| Earners | Freelancers, artisans, teachers, drivers, local service providers |
| Spenders | Small shops, food vendors, transport services, markets |
| Merchants | Grocery stores, pharmacies, tailors, tech repair shops |
| Community Leaders | Youth organizers, pastors, market leaders, influencers |

👉 Build a list of 30–50 reachable contacts.

### 2. Launch a micro-pilot

Organize a small Bitcoin-powered event:

* Market day where vendors accept bitcoin,
* Freelance fair where freelancers get paid in bitcoin,
* Gig challenge (e.g., students earn bitcoin for small gigs: design, translation, deliveries).

Provide the tools:

* Micro Custodial wallets (for beginners),
* Quick training on QR codes + sending bitcoin,
* Instant support if payments fail (don't let first users get stuck!).

**First rule:** Make the first Bitcoin experience frictionless.

## Phase 2: Make Bitcoin useful daily

### 1. Pay people in bitcoin

* Pay freelancers, vendors, organizers small Bitcoin bonuses.
* Set up competitions ("Complete 3 gigs this week → get 5,000 sats bonus").

Even \$5–\$10 in bitcoin motivates real behavior shift.

### 2. Incentivize spending bitcoin

* Cashback programs ("Pay with Bitcoin and get 2% off your lunch").
* Partner merchants with Bitcoin-exclusive promotions.

### 3. Solve local pain points

Focus messaging on practical problems Bitcoin solves:

| Local Problem | Bitcoin Pitch |
| - | - |
| Cash scarcity | Bitcoin payments avoid physical cash issues. |
| High banking fees | Bitcoin sends are cheaper than mobile money + banks. |
| Inflation fear | Save a little Bitcoin weekly to protect value. |
| Access barriers | Anyone with a smartphone now has financial access. |

## Phase 3: Build visibility and trust

### 1. Showcase real user stories

Interview 5 users:

* "How Bitcoin helped you get paid faster."
* "How you saved money on transfer fees."

Make short video clips (1–2 minutes). Share on WhatsApp groups, Twitter, local radios, posters.

👉 Bitcoin becomes normal through real faces, not corporate ads.

### 2. Merchant trust boosters

Offer simple POS (Point of Sale) support:

* QR code printouts,
* Phone screens as cash registers.

Teach basic Bitcoin refunds ("If customer overpays, scan their QR, send back.").

👉 Make Bitcoin less intimidating to merchants.

### 3. Community ambassadors

Recruit trusted local leaders. Give them:

* Bitcoin starter kits (wallet app + 10,000 sats),
* Referral bonuses,
* Bitcoin literacy cheat sheets.

Train them to teach Bitcoin in human language: "Send money. Save value. Stay free." Not in Bitcoin jargon: "Lightning Network HTLC payment channels optimized over Taproot upgrade chains."

## Phase 4: Scale carefully

### 1. Expand earning opportunities

* Recruit more freelancers, service providers, artisans who accept bitcoin.
* Create a P2P local Bitcoin jobs board ("Earn bitcoin doing tasks in your city").

### 2. Expand merchant acceptance

* List Bitcoin-accepting merchants publicly ("Bitcoin Welcome Here" map).
* Encourage Bitcoin-only promotions ("Pay with Bitcoin and get extra discount").

### 3. Strengthen the economy loop

Encourage earn → spend → save mentality: "Earn bitcoin → Spend bitcoin locally → Save a little Bitcoin monthly."

Circular economies work when Bitcoin doesn’t always have to exit back to fiat.

### Timeline example

| Week | Focus |
| :- | :- |
| 1 | Recruit 20 freelancers + 10 merchants. Run small Bitcoin market day. |
| 2 | Launch cashback program for Bitcoin payments at 5 shops. Collect user stories. |
| 3 | Organize "Bitcoin Pay Day" with prizes for paying in bitcoin. Film mini-docs. |
| 4 | Expand into another local neighborhood. Add 10 more Bitcoin businesses. |

### Key metrics to track

| Metric | Why It Matters |
| - | - |
| Number of Bitcoin earners | Economic foundation strength |
| Number of Bitcoin spenders | Circularity health |
| Merchant retention rate | Stability of Bitcoin commerce |
| Peer-to-peer Bitcoin sends | Community liquidity health |
| Bitcoin transaction volume (in sats) | Real Bitcoin usage growth |

### Common mistakes to avoid

| Mistake | Why It Destroys Momentum |
| - | - |
| Teaching philosophy before usability | Users leave before experiencing value. |
| Only targeting "crypto bros" | Bitcoin grows with normal users solving real problems. |
| Forcing full self-custody immediately | Let users move from custodial to self-custody naturally. |
| Ignoring liquidity and merchant support | If users can't spend bitcoin, economy collapses into cashouts. |

**Final guiding principle:** Bitcoin circular economies win when Bitcoin is just "how we move money," not "a complicated financial rebellion." Make Bitcoin useful, Make Bitcoin trusted, Make Bitcoin daily. Freedom follows.

## Bitcoin merchant activation kit

Launch Local Bitcoin Acceptance in Any Market, Fast

Goal: Get merchants to accept Bitcoin (even if custodial at first) smoothly, simply, and sustainably.

Remember: Most merchants don't care about "decentralization" or "blockchains." They care about:

* Getting paid reliably,
* Saving on fees,
* Protecting their money from currency collapse,
* Gaining more customers.

👉 We market Bitcoin acceptance as a business upgrade, not a technical revolution.

### Kit sections

| Section | Focus |
| - | - |
| 1. Merchants to Target First | Identifying the right initial merchants |
| 2. Scripts and Pitches for Activators | Effective communication strategies |
| 3. Bitcoin Acceptance Setup (Practical Fast Options) | Quick and easy setup methods |
| 4. Visual Tools and Support Materials | Materials to aid visibility and understanding |
| 5. Incentives to Make Bitcoin Acceptance Sticky | Strategies to encourage continued use |
| 6. First Week Merchant Engagement Plan | Ensuring successful initial adoption |
| 7. Metrics to Track Merchant Growth | Measuring success and identifying areas for improvement |
| 8. Common Merchant Objections: and How to Handle Them | Addressing potential concerns |

### 1. Merchants to target first

Start where cash flow is fast, repeat customers are common, and fees hurt.

| Merchant Type | Why Good Target |
| - | - |
| Food Vendors (cafes, small restaurants) | Daily cash flow. Easy to demonstrate Bitcoin payments. |
| Pharmacies / Clinics | Frequent medium-ticket purchases. Health sector = high trust leverage. |
| Electronics Repair Shops | Young clientele. Tech-friendly mindset. |
| Transportation Operators | Taxis, bike riders. Fast cash needs. |
| Small Grocery Shops | Daily essentials. Trust builds quickly. |

**Tip: Density matters.** 👉 Focus your first 10 merchants within a 5-minute walk radius. 👉 Density > Distance. Circular economy needs proximity early.

### 2. Scripts and pitches for activators

Simple, friendly language:

* Pitch 1: Solve Payment Pain "Would you like customers to pay you directly without bank charges or cash problems?"
* Pitch 2: Expand Your Customer Base "More customers now have Bitcoin. Accept it, and get paid instantly with no extra machines needed."
* Pitch 3: Protect Against Inflation "Want to save part of your earnings in something that doesn’t lose value like naira?"

### 3. Bitcoin acceptance setup (fast practical options)

**Option 1: Custodial Bitcoin wallet (easiest start).** Help merchant install your Bitcoin wallet app. Show them how to:

* Generate a receiving QR code,
* Check transaction confirmations,
* Withdraw if they want (cashout options).

✅ Custodial model allows fast onboarding.

✅ Can upgrade to self-custody later if they want.

**Option 2: Telegram/WhatsApp support.**

* Print merchant’s Bitcoin address QR code.
* Set up WhatsApp group for support questions.
* Payments scan → merchant checks confirmation via WhatsApp assistant (or app later).

✅ Good for low-tech merchants initially.

### 4. Visual tools and support materials

* "Bitcoin Accepted Here" stickers
* Laminated QR code printouts for cashiers
* Posters: "Fast Payments Here, Bitcoin Welcome!"
* Tiny paper guides (business card size): "3 Steps to Accept bitcoin: Open Wallet, Scan QR, Confirm Payment"

**Tip: Visibility is key.** 👉 Always install physical proof (stickers, posters) the same day you activate merchant. 👉 Visibility creates social proof for customers.

### 5. Incentives to make Bitcoin acceptance sticky

| Incentive | How It Works |
| - | - |
| Cashback for First 5 Bitcoin Payments | e.g., 2% back on first 5 customer Bitcoin transactions. |
| Merchant Lottery | Every Bitcoin payment is a ticket for a weekly prize (cash, groceries). |
| Bitcoin Savings Bonus | Merchant who saves Bitcoin balance for 1 month gets extra Bitcoin reward. |
| Customer Rewards | Customer paying in bitcoin gets small discounts, merchants funded initially by you. |

### 6. First week merchant engagement plan

| Day | Action |
| - | - |
| Day 1 | Activate merchant. Install wallet. Do test payment. Install sticker/poster. |
| Day 2 | Check in. Assist first real customer Bitcoin payment. |
| Day 4 | Drop off small Bitcoin merchant pack (maybe T-shirt, bonus guide). |
| Day 6 | Celebrate merchant’s first 5 Bitcoin sales on social media (with permission). |
| Day 7 | Interview merchant: "How easy was it to accept bitcoin?" Short 30-second video if possible. |

**Remember:** 👉 Activation without usage is meaningless. 👉 Hand-holding first week is key to habit formation.

### 7. Metrics to track merchant growth

| Metric | Why It Matters |
| - | - |
| Active Bitcoin-Accepting Merchants | Real ecosystem size |
| Bitcoin Sales per Merchant | Merchant health |
| Customer Payment Success Rate | UX quality |
| Merchant Retention After 30 Days | Stickiness of Bitcoin economy |
| Merchant Referral Rate | Viral merchant growth indicator |

### 8. Common merchant objections, and how to handle them

| Objection | Response |
| - | - |
| Bitcoin is too complicated. | We’ll set everything up for you. It’s just scan, confirm, receive. |
| What if Bitcoin crashes in price? | You can instantly cash out after each payment if you want. |
| What if I need cash today? | You can cash out Bitcoin anytime. We’ll show you how. |
| What about scams? | Only use your verified wallet. QR code payments avoid scams, no account number issues. |

### Closing checklist

✅ Have a starter pack ready:

* Wallet app installed,
* QR code laminated,
* Posters and stickers printed.

✅ Train merchant to:

* Receive,
* Confirm,
* Withdraw (if needed).

✅ Reward first payments.

✅ Celebrate first successful Bitcoin day publicly.

✅ Stay reachable for quick support.

### Summary

Merchant activation is not about teaching Bitcoin philosophy. It’s about making merchants say: "This is easier than my bank POS."

When Bitcoin works faster, cheaper, and safer than traditional payments, adoption accelerates naturally.

And you build real Bitcoin economies, not just crypto apps.

You now have: Fast activation plans, Real-world merchant scripts, Retention and reward tactics, Local growth metrics.

## Module 18 complete

You now understand:

* Bitcoin marketing is not philosophy.
* Bitcoin marketing is problem solving, story telling, and community building.
* Custodial platforms are valid Bitcoin bridges.
* Circular economies create Bitcoin usage naturally, sustainably, permanently.

Bitcoin doesn’t need permission to win. It needs reality to win. And you can build that reality.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.