Papi guides

Run the shop without guessing.

Plain answers for putting stock online, collecting naira, setting Lagos or nationwide delivery, connecting a domain and fixing what is stuck.

No articles found

Try searching for different keywords, or check our categories above.

Getting Started & Setup

How do I claim and choose my store address?

Every Papi merchant receives a fast, dedicated subdomain formatted as yourstore.papi.ng.

  1. From the homepage or /start, type your desired store name into the claim box.
  2. Papi instantly verifies whether the address is available in real time.
  3. If available, click Claim my store to proceed to merchant onboarding.
  4. Your chosen store name will automatically prefill throughout registration, so you never have to re-type it.
Tip: Subdomains should be clean and memorable. Only letters, numbers, and hyphens are supported. You can later connect an external custom domain (e.g. yourbrand.com) at any time.

How does passwordless OTP login work?

Papi uses modern passwordless authentication to protect your account against password breaches and credential stuffing.

  • Enter your registered email address on the login screen.
  • You will receive a secure 6-digit verification code.
  • Enter the code to immediately access your merchant dashboard.
  • In development mode, test OTP codes are displayed directly on screen for quick testing without waiting for email delivery.

What is the "Foundations" checklist to go live?

When you first create a store, it starts in Opening Soon mode until you complete four basic foundations:

  1. Upload a Store Logo & Identity: Set your store banner and visual branding.
  2. Add at least one product or service: Put your first item in the shop.
  3. Connect your Payout Account: Link your Nigerian bank account so you can receive buyer funds.
  4. Configure Delivery or Pickup: Define where you ship and what fees apply.

Once completed, click Launch Store in your dashboard header to open your storefront to the public!

Storefront Design & Themes

What storefront themes are available, and can I switch them?

Papi provides multiple curated, responsive themes tailored to different industries:

  • Starter: Minimalist and lightning-fast. Ideal for emerging brands and general commerce.
  • Boutique: Editorial and fashion-forward. Large hero banners and magazine-style product grids.
  • Retail: A product-focused shop that helps buyers filter electronics, groceries, beauty items, and more.
  • Bakery / Food: Warm tones and prominent ordering CTAs with delivery time notes.
  • Artisan: Earthy textures celebrating handcrafted items, pottery, and bespoke crafts.

You can switch themes at any time from Storefront → Themes. Switching themes is instantaneous and never alters your products, prices, or orders.

Does Papi support Dark Mode on storefronts?

Yes. All Papi themes include native light and dark mode styling. When a buyer visits your store, Papi automatically respects their device's preferred color scheme (iOS/Android/Windows dark mode), while also allowing them to toggle manually via the header icon.

Products, Variants & Inventory

How do I create product variants (sizes, colors)?

You can add options when creating or editing a product under Products:

  1. Check the This product has variants checkbox in the product editor.
  2. Add variant options such as Size (e.g. Small, Medium, Large) or Color (e.g. Navy, Onyx).
  3. Set an optional price override for each variant if certain sizes or editions cost more.
  4. Track inventory separately per variant.

Can I sell digital downloads and software license keys?

Yes! Papi provides first-class support for digital products:

  • Digital Files: Upload PDFs, audio albums, digital artwork, or software zip archives. Buyers receive an authenticated, time-expiring download link upon verified payment.
  • Serialized License Codes: Input pools of single-use license keys or redemption codes. Papi automatically dispenses one unique code per purchase upon checkout confirmation.

What is Draft Autosave?

While you add a product, Papi saves your unfinished work in this browser every five seconds. If the browser closes or your network drops, return to Products and restore the draft.

Payments & Payouts (Paystack)

What payment methods can my customers use?

Storefront checkouts are powered by our secure Paystack integration, allowing buyers across Nigeria and Africa to pay with:

  • Debit & Credit Cards: Mastercard, Visa, and Verve.
  • Bank Transfer: Dynamic virtual bank accounts with instant payment confirmation.
  • USSD: Direct mobile banking shortcodes for all major Nigerian banks (GTBank, Zenith, Access, etc.).
  • Apple Pay: Supported on compatible iOS Safari devices.

How do payouts to my bank account work?

Funds from completed customer purchases settle directly into your Papi merchant wallet on a standard T+1 business day schedule.

  1. Link your Nigerian bank account in Wallet → Payout Settings using your 10-digit NUBAN number.
  2. Papi instantly validates your account name against the Central Bank of Nigeria registry.
  3. Set a secure 4-digit Withdrawal PIN.
  4. Withdraw funds to your verified bank account at any time with instant settlement.

Custom Domains & DNS

How do I connect my custom domain (e.g. mybrand.com)?

You can connect any custom domain purchased from GoDaddy, Namecheap, WhoGoHost, Google Domains, etc.:

  1. Navigate to Domain in your merchant dashboard.
  2. Enter your custom domain name (e.g. mybrand.com) and submit.
  3. Log into your DNS management provider and add the following records:
Type Name / Host Target / Value TTL
CNAME www cname.papi.ng Automatic / 3600
CNAME / ALIAS / ANAME @ (Apex) cname.papi.ng Automatic / 3600
DNS Tip: If your DNS provider does not support CNAME flattening at the apex (@), point www.yourdomain.com to cname.papi.ng and set up an automatic forward from your apex to www, or use Cloudflare DNS (recommended) with proxy enabled.
Automatic SSL: Papi automatically provisions a free Let’s Encrypt TLS certificate as soon as your DNS records propagate.

How does www. redirection work?

Papi automatically canonicalizes all requests. If a buyer types www.yourstore.papi.ng or www.yourbrand.com, they are seamlessly redirected via HTTP 301 to the primary address. If an unknown subdomain is entered, visitors are greeted with a clear, animated 404 page asking them to check the URL or return home.

Shipping & Logistics

How do I set up custom delivery zones and fees?

Under Pickup & Delivery, you can define specific shipping areas with custom pricing:

  • Local City Zones: Create zones like "Lagos Mainland" (₦2,500) and "Lagos Island / Lekki" (₦3,500).
  • Interstate Delivery: Define nationwide delivery fees for orders shipping outside your primary state.
  • Free Shipping Threshold: Encourage larger orders by setting a cart minimum (e.g. Free shipping on orders over ₦25,000).
  • Local Pickup: Enable free in-person collection at your store address or pickup point.

Discounts & Coupons

How do coupon codes and category discounts work?

In Coupons, create targeted promotional discount codes:

  • Percentage Off: Give a 10%, 20%, or 50% discount at checkout.
  • Fixed Amount Off: Deduct a flat sum (e.g. ₦2,000 OFF) from the order subtotal.
  • Category Scope: Restrict coupons to specific categories (e.g. valid only on "Shoes" or "Skincare").
  • Usage Limits: Cap the total number of redemptions or set minimum cart spend requirements.

Orders & Receipts

How do buyers receive receipts and proof of purchase?

Every successful order generates an authenticated digital receipt:

  • An email confirmation is sent immediately to the buyer with order itemization.
  • A secure link (/orders/:id/receipt) displays an interactive receipt.
  • Buyers and merchants can click Download PDF (/orders/:id/receipt.pdf) for accounting and tax records.

Frequently Asked Questions

Why does my new custom domain show a 404 or SSL error?

Global DNS changes require time to propagate across internet service providers (usually 10 to 30 minutes, but can take up to 24 hours depending on your registrar). Once the DNS records reach our edge servers, SSL certificates are issued automatically. If it has been more than 24 hours, double-check your CNAME and A record settings.

What happens if a buyer pays by bank transfer and closes the tab?

No funds or orders are lost. Paystack communicates directly with Papi's webhook service in the background. As soon as the Nigerian Inter-Bank Settlement System (NIBSS) confirms the transfer, Papi automatically marks the order as paid, deducts product inventory, and sends the customer their receipt email.

How do I reset my payout withdrawal PIN?

To protect your wallet against unauthorized withdrawals, PIN resets require email OTP authorization. Go to Wallet → Settings, click Reset PIN, and follow the one-time verification code sent to your registered merchant email address.

A person can help

Still stuck? Send the exact problem.

We read support messages Monday through Saturday. Include the shop address, order reference or domain name so we can get straight to it.