Rollo documentation

Rollo is a Merchant of Record (MoR) platform for accepting payments online. When you sell through Rollo, Rollo is the merchant of record for the transaction: we provide hosted checkout, payment processing, tax handling where supported, and payouts to your bank account under a single all-in rate of 5.9% + $0.50.

How Rollo fits your stack

Most payment service providers (PSPs) leave you as the merchant of record. That means you manage tax nexus, chargeback liability framing, and local compliance yourself. MoR platforms reverse that model: the platform sells to the end customer and remits net proceeds to you. Rollo is built for digital goods and SaaS teams that want MoR coverage without negotiating volume tiers or stitching together separate tax and billing vendors.

Compared with typical PSP or MoR setups, Rollo emphasizes a flat fee, sandbox-first development, optional fee pass-through to buyers, native free trials on recurring prices, and subaccounts for multiple products under one organization. Public APIs, dashboards, and checkout surfaces expose only Rollo resources and identifiers.

Core concepts

  • Products & prices — Catalog items with one-time or recurring prices. Recurring prices may include a free trial period.
  • Checkout sessions — Hosted payment pages (cs_) that expire after two hours unless extended.
  • Payment links — Shareable URLs backed by a price, suitable for no-code sales.
  • Subscriptions — Created when a recurring checkout succeeds (or a trial starts).
  • Webhooks — Signed HTTP callbacks for events you explicitly subscribe to.

Account types

Individual accounts are intended for personal sellers and cannot accept charges of $1,000 or more per payment. Business accounts support higher ticket sizes after verification. All accounts begin in Sandbox; Live mode unlocks when verification is approved.

Payments & fees

Charges, fee absorption vs pass-through, and settlement.

Issue a refund

Full and partial refunds from dashboard or API.

Subscriptions & trials

Recurring billing, free trials, and lifecycle events.

Managing subscriptions

Cancel, pause, resume, and extend periods.

Proration

Plan changes with credit days.

Payment recovery

Retry past-due invoices and dunning.

Checkout sessions

Create, edit, and host one-time or recurring checkouts.

Overlay checkout

Modal iframe checkout without leaving your site.

Ad-hoc pricing

Custom amounts without a catalog price.

Deposit limits

Optional single-charge and daily volume caps.

Manage customers

Customer records, spend, and MRR contribution.

Payment links

No-code links backed by catalog prices.

Webhooks

Subscribe to event types and verify signatures.

Verification

Individual and business identity requirements.

API reference

Authentication, resource IDs, and endpoints.

Security

Checkout isolation, keys, and operational hygiene.

Quickstart

Create a test API key in the dashboard, then create a checkout session from your server. Redirect the customer to the returned url. Listen for payment.succeeded (and subscription events if you sell recurring plans) on a webhook endpoint you have subscribed to those types.

curl https://api.rollopayments.com/v1/checkout_sessions \
  -H "Authorization: Bearer rk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4900,
    "currency": "usd",
    "mode": "payment",
    "success_url": "https://example.com/success"
  }