Docs · SDK · ledger

Get out and get in.

CoinBased is the regulation coin for real-world transactions across news, gaming, content, and more. One wallet. Unlimited access. Merchants embed a button. We hold identity and the ledger.

Get in now → Get out now →

How CoinBased works

Merchant site

Digital content or gaming. Pay with CoinBased. Send a charge_token — never a card.

CoinBased auth

OAuth2 / OIDC. Authenticate. Debit the user coin balance.

Gateway

Clear USD. Mint coins. When the row is written and verify returns valid, the transaction is clear.

Core models

users

id UUID
email UNIQUE
password_hash
coin_balance >= 0

apps

developer_id
client_id
client_secret_hash
redirect_uri

transactions

amount  (+ mint / − spend)
type FIAT_PURCHASE
     MERCHANT_SPEND
     MERCHANT_PAYOUT

Embed

<script src="https://coinbased.net/v1/sdk.js"></script>
const cb = new CoinBased({ clientId: 'app_live_89f0213a' });
const pay = await cb.authorizeAndCharge({
  amount: 50,
  itemDescription: 'Read: Market Analysis Q3'
});
// POST /api/v1/transactions/verify on your server
// When valid: the charge has cleared.

API

Endpoint	Who	Purpose
POST /api/v1/oauth/charge	Popup	Debit coins
POST /api/v1/wallet/buy-coins	Reader	Sandbox mint
POST /api/v1/transactions/verify	Merchant	X-CoinBased-Secret
POST /api/v1/apps	Developer	client_id + secret