JadeCove
JadeCove
private payment cove
Docs · how it works

JadeCove, in plain English.

A private, non-custodial crypto payment processor on the Base network. One scan, instant settlement, configurable fees, US sales-tax compliant. No accounts, no logins, no operator custody.

USDCUSDTcbBTCDAIETHSOL · coming soon

The flow

  1. 1
    Pick coin + enter amount
    The customer enters a USD value, picks the coin (USDC by default), and adds their sender wallet and the recipient wallet. JadeCove converts the USD into the exact token amount using a live spot price oracle.
  2. 2
    Scan + pay
    JadeCove returns an EIP-681 QR code. The customer opens Coinbase Wallet / Base App / MetaMask, scans, confirms. The transfer goes to JadeCove's Coinbase CDP-managed MPC deposit wallet on Base mainnet.
  3. 3
    Auto-forward
    A blockchain poller watches the deposit address. As soon as the exact-amount transfer lands, the CDP SDK forwards the merchant's portion (subtotal + tax) to the recipient wallet. Fees stay in the CDP wallet for the operator to sweep.
  4. 4
    Settled · receipt issued
    The customer sees "Settled" and can download a one-page PDF receipt. The merchant has the funds in their own wallet. JadeCove keeps no custody beyond the transient deposit window.

Supported coins

All settlement happens on Base mainnet. The CDP wallet always needs a small amount of native ETH to pay gas for outgoing transfers.

USDC
Default · stable
USDT
Stable
cbBTC
Coinbase wrapped BTC
DAI
Stable · decentralized
ETH
Native gas token

Fees

Fees are configured live in the admin dashboard — the values below update automatically when the operator changes them.

Percent
0.98%
of subtotal
Network
$0.03
flat
Processing
$0.03
flat
Gas
$0.10
flat

Processor fees are calculated on the subtotal only — they do not scale with sales tax. The customer always sees the exact total before they approve the payment.

US sales tax

When the operator enables sales tax, the customer picks a US state (and optionally a ZIP) at checkout. Tax flows to the merchant in the same on-chain forward — JadeCove never holds it. The merchant remains the merchant of record and is responsible for remittance.

Rate source
State-level table50 states + DC, baked in
ZIP-level (TaxJar)Optional · activates when TAXJAR_API_KEY is set
FallbackState table if TaxJar errors or has no key
CachePer-ZIP for 24 h in MongoDB

Transaction types

Not every crypto transaction is subject to sales tax. The picker at checkout governs whether the tax flow runs at all.

Physical goodsTax applied
Digital goodsTax applied
Subscription / SaaSTax applied
Professional servicesNo tax
Personal transferNo tax
Donation / GiftNo tax
Refund / ReimbursementNo tax
Other (non-taxable)No tax

Receipts

Every settled invoice generates a one-page PDF with: brand header, full breakdown (incl. tax line when applicable), on-chain payment + forward tx hashes, BaseScan footer. The "Download receipt" button appears as soon as the on-chain forward confirms — and the link is re-shareable so customers can re-download anytime.

Merchant pages

Create a pre-filled checkout link in the admin dashboard. Each merchant gets a shareable URL like:

jadecove.fun/m/your-slug

The slug is admin-controlled. Customer only enters the amount + their sender wallet — the recipient is pre-filled. Perfect for storefronts, pop-ups, freelancers, subscriptions.

Privacy & security

  • ·No accounts. No email, no login, no PII. One signed HTTP-only session cookie scopes invoices to your browser.
  • ·No custody. Funds sit in the CDP MPC wallet for at most a few seconds before being forwarded on-chain. The operator can never spend a customer's funds — only sweep accumulated fees.
  • ·AES-256-GCM on session data at rest.
  • ·Public-key crypto, public chain. Every transaction is verifiable on BaseScan. Nothing is hidden.

Public API

All endpoints are prefixed with /api and return JSON. Tax / state / quote endpoints are anonymous; invoice CRUD requires the session cookie issued at first page load.

MethodPathWhat it does
GET/api/tokensSupported coins + on/off status
GET/api/configFee schedule + chain config
GET/api/states50 US states + state-level tax rates
GET/api/transaction-typesTaxable vs non-taxable categories
POST/api/quotePreview total · accepts tax_state, tax_zip, tx_type
POST/api/invoicesCreate payment · returns QR payload
GET/api/invoices/{id}Poll status (session-scoped)
GET/api/invoices/{id}/receipt.pdfDownload receipt · settled only
GET/api/merchants/{slug}Public merchant lookup

Admin endpoints (under /api/admin/*) require a bearer token and are not documented here for security.

Try it now
Send your first payment
Open checkout
MPC-secured by Coinbase · auto-forwarding · AES-256 sessions