Skip to main content

Documentation Index

Fetch the complete documentation index at: https://yanhgming.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Marlin gives your business the full billing infrastructure that Stripe provides for traditional payments — invoices, subscriptions, customer records, hosted checkout, a REST API, a TypeScript SDK, and signed webhooks — all settled on-chain in USDC, PYUSD, or USDG on Solana.

What you can do with Marlin

Send invoices

Create and send stablecoin invoices with a hosted pay-by-link checkout. Track status from open to paid on-chain.

Run subscriptions

Set up recurring billing plans. Customers authorize once — Marlin charges automatically on schedule.

REST API

Familiar Stripe-inspired endpoints for invoices, plans, subscriptions, and customers.

TypeScript SDK

Install @marlin/sdk and interact with every API resource in a few lines of typed code.

Embeddable widget

Drop <MarlinCheckoutButton> or a vanilla JS snippet into any site to embed checkout.

Webhooks

Receive signed event notifications for payments, subscriptions, and customers.

Key principles

Non-custodial. Funds settle directly to your Solana wallet on-chain. Marlin holds your money only within a per-invoice escrow PDA during the payment window — never longer. Simple pricing. 50 basis points (0.5%) per settled payment. No monthly fees, no per-seat costs, no charges on failed payments. Multi-stablecoin. Accept USDC, PYUSD, and USDG with no additional configuration. Your customers pay with the stablecoin in their wallet. Stripe-compatible DX. If you’ve integrated Stripe before, you’ll feel at home. The API shape, webhook signature format, and SDK patterns are intentionally familiar.

Start here

Quick Start

Create your first invoice and get a payment link in under 5 minutes.

Authentication

Generate an API key and authenticate your first request.