Forras docs

Everything you need to set up your storefront, connect stores, send newsletters, and accept USDC/EURC payments.

Quickstart

Go live in five minutes:

  1. Sign up at forras.io/signup — Google, Apple, or email.
  2. Pick a handle like forras.io/yourname. Lowercase, letters & numbers, 3–20 chars.
  3. Add a product — native digital file or import from a connected store.
  4. Share your link in your bio. Sales settle in USDC or EURC on Base in minutes.
Forras Link Free is free forever. Upgrade to Pro ($8/mo) to drop the per-sale fee from 5% to 2% and unlock unlimited connected stores.

Pick your handle

Your handle becomes forras.io/{handle} and the canonical entry point for your storefront, newsletter, and checkout. Handles are unique across the platform and you can change yours once during the first 30 days.

Add your first product

From the dashboard, click Products → New product. You can:

  • Upload a digital file (PDF, ZIP, MP4) for instant delivery after purchase.
  • Import from a connected store — Shopify, WooCommerce, Etsy, Mercado Libre, and 5 more.
  • Add a tip jar or pay-what-you-want product with a custom minimum.

Connected stores

Forras Link connects to nine commerce platforms across four regions. From Settings → Connected stores, OAuth into each store and we'll mirror your catalog to your Forras page. Inventory syncs every 15 minutes.

Supported platforms:

  • Global: Shopify, WooCommerce, Etsy
  • Europe: PrestaShop, Shopware
  • Latin America: Tiendanube, Mercado Libre, Hotmart
  • India: InstaMojo

Hosted checkout

Forras-hosted checkout collects payment once for any mix of items in your cart — including items from multiple connected stores. The visitor sees one charge on their statement; Forras then routes per-merchant orders to each store's admin API and remits the rest.

The 5% routed-checkout fee applies to sales placed via Proxy or Hybrid platforms (Shopify, WooCommerce, Hotmart, PrestaShop, Shopware, InstaMojo). Deep-link platforms (Etsy, Mercado Libre, Tiendanube) finish at the merchant site and don't incur the routed fee.

Refunds

From Transactions → Order → Refund, issue full or partial refunds. Forras returns the platform fee proportionally and reverses the routed-merchant payout via the source platform's refund API. Refunds appear back on the customer's original payment method within 5–10 days.

Newsletter

From Subscribers → Compose:

  1. Write your subject + body in Markdown or use the rich blocks.
  2. Drop a product block to auto-fill price, image, and checkout link.
  3. Pick the audience segment (all, recent buyers, by category).
  4. Send now or schedule for later. Every send tracks delivery, opens, clicks, and the revenue it drove.

Free plan: 1,000 sends/month. Pro plan: 10,000 sends/month.

Double opt-in

Every new subscriber gets a confirmation email. They have to click the link before we'll send anything else. The token rotates on every state change, so old confirmation links stop working — prevents replay attacks if the email leaks.

USDC + EURC payouts

Buyers pay locally — card via Stripe, USDC or EURC via Coinbase CDP. You settle into your own Coinbase wallet in minutes:

  • USDC on Base — global creators, ~5 minutes settlement.
  • EURC on Base — EU creators, zero FX from EUR buyers.
  • Stripe Connect — fallback fiat payouts in 2 days.

Withdraw to a bank or self-custody wallet from Payouts → Withdraw.

EU VAT

Stripe Tax calculates and collects VAT automatically for every EU country. We export per-quarter VAT reports under Payouts → Tax → Export.

Marketplace API

Three anonymous, rate-limited public endpoints. All return JSON.

GET /api/marketplace/search?q=&category=
GET /api/marketplace/creators?featured=true
GET /api/marketplace/creators/{handle}

Subscribe a visitor to a creator's newsletter:

POST /api/public/subscribe
{ "creatorHandle": "sara", "email": "a@b.com", "source": "marketplace" }

Full API reference is on the way. Email hello@forras.io if you want early access to the partner endpoints.