Built for Bankroll

A Built-for-Bankroll app is a web app served from your own origin, opened inside the Bankroll mobile app. The host supplies the three rails a real-money app needs:

Age — a verified age for each user, delivered in a signed session token you verify server-side, ready to feed your own eligibility rules. One person, one account, so the same human can’t hold two.
Geo — the user’s region (ISO 3166-2) in the same token when resolvable, for per-region eligibility rules.
Payments — one call charges the user’s balance and settles to the address fixed in your manifest. Settlement is final — no chargebacks — and Bankroll charges no fee.

Users arrive signed in to Bankroll; session() identifies them to your server, so there is no separate login flow. The integration is one npm package, a manifest at /.well-known/bankroll.jwt, and two calls:

npm install @joinbankroll/sdk

import { bankroll } from "@joinbankroll/sdk";

const token = await bankroll.session();                     // signed session token: user, identity, geo
const signature = await bankroll.charge({ amountCents: 500 }); // charge $5.00; resolves with the settled signature

Questions, verification, or a deal to discuss — the team is in the Built for Bankroll Discord.

Overview

How hosting, the manifest, the session token, and payments fit together.

Quickstart

SDK, manifest, session verification, a payment, and the deep link.

The manifest

Claims, rules, and serving /.well-known/bankroll.jwt.

The session token

Claims, server-side verification, and eligibility gating.

Payments

charge() input, idempotency, server-side verification, error codes.

Paying a user

Payouts and refunds as HSUSD transfers to the user’s wallet.

Get Started

Guides

Reference

Helpers

Changelog