JunifyDocsJunify Documentation
The authoritative guide to launching, operating, and integrating with Junify. Discover merchant workflows, catalog management, Mobile Money payments, custom domains, and REST APIs.
The Modern Commerce Engine for Africa
Junify delivers an enterprise-grade multi-tenant commerce platform tailored for ambitious businesses across Africa. Every store operates in an isolated workspace with dedicated inventory, automated Mobile Money checkouts, custom domains, and edge-rendered storefronts.
Each merchant manages their business from an autonomous workspace with dedicated catalogs, customer records, and order fulfillment pipelines.
- Dedicated store slug with instant live storefront
- PostgreSQL Row Level Security (RLS) data isolation
- Multi-seat staff access with role-based permissions
Accept Mobile Money and cards effortlessly. Automated settlement splits platform fees and routes merchant payouts directly to your accounts.
- MTN Mobile Money, Telecel Cash, and AT Money
- Visa, Mastercard, and international cards via Paystack
- Cryptographic webhook verification and automated fulfillment
Publish under your own brand name. Connect custom apex domains or subdomains with automatic SSL provisioning and edge network acceleration.
- One-click CNAME and TXT challenge verification
- Zero-configuration SSL/TLS certificate management
- Sub-100ms storefront response time across global nodes
Focus on growing sales while automated services manage inventory decrements, customer notifications, and invoice generation.
- Branded transactional email receipts via Brevo
- Real-time stock decrement and out-of-stock protections
- Dynamic discount engine and customer review workflows
Storefront & Rendering
Next.js 15 App Router running on distributed edge nodes with dynamic server caching and responsive UI components.
Data & Isolation Layer
PostgreSQL with Row Level Security (RLS) policies enforcing multi-tenant isolation at the database level.
Fintech & Messaging
Unified payment gateways connecting African Mobile Money networks and bank rails with Brevo transactional messaging.
Merchant Quick Start Guide
Launch your online store in three simple phases. Configure your brand identity, organize your catalog, and start receiving payments today.
1Register Your Merchant Account
Visit the registration portal and enter your business email and secure credentials. Every account begins with our full-featured Starter plan with zero upfront commitment.
2Choose Your Store Name and URL Slug
During initial onboarding, define your brand name and your public store identifier (slug). For example, choosing the slug accra-boutique immediately activates your live storefront URL.
# Your public storefront is instantly live:
https://junify.store/store/accra-boutique
# Customers can browse products, filter categories, and add items to cart immediately.3Configure Operating Currency and Store Details
In your store dashboard settings, establish your primary currency (GHS, USD, EUR), customer support telephone line, delivery notes, and return policies.
4Invite Team Members
Collaborate with your team without sharing passwords. Assign granular roles including Store Administrator, Product Manager, and Fulfillment Staff.
Connect Your Custom Domain
Elevate customer trust by presenting your storefront on your own branded domain (e.g. shop.yourbrand.com or yourbrand.com). Junify provisions SSL certificates automatically and handles global DNS routing.
Navigate to Dashboard > Settings > Domains. Enter your apex domain or subdomain.
Junify registers your hostname and generates a dedicated cryptographic challenge token used to verify your ownership.
Log in to your DNS management console (e.g., Cloudflare, Namecheap, GoDaddy, Route 53) and add the following two DNS records:
| Record Type | Host / Name | Target / Value | Purpose |
|---|---|---|---|
| CNAME | shop (or @) | cname.junify.store | Routes web traffic to Junify edge |
| TXT | _junify-challenge | junify-verify-<your-token> | Domain ownership verification |
Step 3: Verification & Automatic SSL Provisioning
Once records are saved, click Verify Domain in your dashboard. Our DNS workers verify the TXT record, provision a zero-config Let's Encrypt TLS/SSL certificate, and begin serving traffic to your custom storefront.
Platform Architecture & Data Isolation
Junify is engineered on a security-first multi-tenant model designed to protect business records, customer contact details, and financial transactions.
Unlike traditional monolithic multi-tenant setups that rely solely on software-level where-clauses, Junify implements native PostgreSQL Row Level Security.
Payment callbacks from Hubtel and Paystack are signed with HMAC SHA-512 signatures and verified before order state transitions occur.
Customer selects products on edge storefront
Payment session created via Paystack / Hubtel
Cryptographically verified payment notice
Stock decremented, email receipt sent
Developer & REST API Reference
Integrate your custom frontend, mobile application, or ERP system directly with Junify's REST APIs. All responses are returned as standard JSON with HTTPS transport.
/api/storefront/[slug]Fetch public store profile, active product catalog, and available categories for a given store slug.
# Fetch catalog for store 'accra-boutique'
curl -X GET "https://junify.store/api/storefront/accra-boutique" \
-H "Accept: application/json"Response Example
{
"store": {
"name": "Accra Boutique",
"slug": "accra-boutique",
"currency": "GHS",
"logo_url": "https://junify.store/media/stores/accra-boutique.png"
},
"products": [
{
"id": "prod_8721fa",
"name": "Handcrafted Kente Tote Bag",
"price": 180.00,
"category": "Accessories",
"stock_quantity": 42,
"images": ["https://junify.store/media/products/bag-1.jpg"],
"has_variants": false
}
]
}Frequently Asked Questions
Common questions from merchants and developers building with Junify.
Ready to Launch Your Store?
Join hundreds of merchants operating fast, secure, and modern digital storefronts powered by Junify.