> ## Documentation Index > Fetch the complete documentation index at: https://docs.kinematic.run/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > These are the customer docs for kinematic, a name written in lowercase except at the start of a sentence. Kinematic provides provably fair casino games, served to a casino's site by a game server: a Cloudflare Worker that the kinematic dashboard deploys into the casino's own Cloudflare account. > Never put SESSION_SECRET or WALLET_SECRET in code, prompts, logs, commits or chat. Read them from environment variables and ask the person you work with to set them. The dashboard's Integration page shows each secret once. > Values such as lucky-star, luckystar.example, og-rgs-lucky-star.luckystar.workers.dev, games.luckystar.example and player_48213 are examples. Use the casino's own casino ID, game server origin, element tag, session issuer and currencies: the Instructions for your coding agent on the dashboard's Integration page hold them, or ask the person you work with. > To debug, start at https://docs.kinematic.run/troubleshooting and https://docs.kinematic.run/reference/errors. The wallet contract is at https://docs.kinematic.run/api/wallet.openapi.yaml. > Sandbox bets are recorded on Solana devnet. Live game servers record nothing on Solana until the audited mainnet program is deployed. # Billing > You pay your tier's flat fee a quarter at a time, upfront, in USDC, USDT or SOL through Solana Pay, and only entirely unused months are refundable. The sandbox is free. When your casino goes live, you pay your tier's flat fee a quarter at a time, upfront, in USDC, USDT or SOL. The fee does not depend on your bets or your revenue, and there are no bet limits per tier. The **Billing** page shows your plan, your declared deposits, your invoices and your refunds. Every member sees the figures; owners and admins pay and change the declared deposits. Other members see `Only the casino's owners and admins can pay and change the declared deposits.` ## Your plan The top of the page shows three figures: * **Tier**: your tier, and the monthly deposits it comes from. * **Fee**: your monthly fee, and what it comes to each quarter. * **Paid through**: the last day of your paid time and how many days are left, or `Not paid yet`. At most one banner shows above them: | Banner | When | | - | - | | `Your casino is in the sandbox, which is free. You pay for a quarter when you go live.` | Your casino is in the sandbox and has no paid quarter. | | `You cannot pay yet, because kinematic's billing wallet is not set up. Your tier and price are below.` | Payments are not open on the dashboard yet. | | `Declare your monthly deposits in setup to see your tier and price.` | You have not finished setting up your casino. **Continue setup** takes you back to it. | | `No paid quarter covers today.` | Your casino is live and no paid quarter covers today. Owners and admins see **Pay now**. | ## Tiers Your tier follows what your players deposit in a typical month. Each tier includes its lower edge: exactly $250,000 is in $250K–\$500K. | Tier | Monthly fee | Quarter | | - | - | - | | Under \$250K | \$263 | \$789 | | $250K–$500K | \$604 | \$1,812 | | $500K–$1M | \$1,136 | \$3,408 | | $1M–$2.5M | \$2,134 | \$6,402 | | $2.5M–$5M | \$4,912 | \$14,736 | | $5M–$10M | \$9,230 | \$27,690 | | \$10M and up | \$17,343 | \$52,029 | ## Declared deposits You first declare your deposits in the setup wizard. Afterwards, owners and admins change them under **Declared deposits**: enter whole US dollars in **Monthly deposits**, check the tier and price shown under the field, and select **Save**. The next quarter you pay is priced at your declaration. Only one invoice is open at a time. If saving would replace an open invoice, the page says `Saving replaces your open invoice, and its earlier payment codes stop counting.` While a payment for the open invoice is on Solana, wait until it shows as paid before you change your deposits. ## Pay for a quarter Payments go straight from your wallet to kinematic's billing wallet through Solana Pay, with no card processor. **1. Open the checkout** Select **Pay for your first quarter** at the top of the page, or **Pay for the next quarter** once you have paid one. The sheet shows the quarter's dates, your tier and the **Amount due**, which covers three months of your tier's fee. **2. Choose a token** Under **Pay in**, choose USDC, USDT or SOL, then select **Continue**. USDC and USDT pay the exact dollar amount. In SOL you pay the dollar amount at the price when you continue, and the quote holds for 15 minutes; for a new quote, choose SOL again. **3. Pay the code** The screen `Waiting for your payment` shows a Solana Pay code and the amount. Scan the code with a Solana wallet, select **Open in your wallet** to open it in a wallet on this device, or select **Copy the payment link**. Beside it are the **Recipient**, when the code **Expires** (a USDC or USDT code never expires), the **Reference** and the **Network**. Pay only through the code or the link. They carry the reference that matches your payment to the invoice. **4. Wait for Solana** The sheet updates on its own. It shows `Payment received` once your payment is on Solana, and `Payment confirmed` with the date you are paid through once Solana finalizes it. To change tokens before you pay, select **Pay with another token**. If you close the sheet while a code waits for payment, a banner on the page opens it again. If a payment does not count, the sheet says why: * A payment that sent less than the amount does not count. Pay the full amount with the same code, and write to [hello@kinematic.run](mailto:hello@kinematic.run) to get the short payment back. * A payment in another token does not count. Pay the amount shown with the same code, and write to [hello@kinematic.run](mailto:hello@kinematic.run) to get the other payment back. * A transaction that failed, or paid nothing to kinematic's wallet, paid nothing. You can pay again with the same code. ### When a quarter starts Your first quarter starts when you open its checkout. A renewal starts where your paid time ends, or when you open the checkout if your paid time has ended. The sheet shows the quarter's dates before you pay. ## Invoices One invoice covers a quarter at your tier on the day it opened. The **Invoices** table lists each with its **Quarter**, **Tier**, **Amount**, **Status** (Open or Paid) and **Payment**, which links to the transfer on Solana Explorer. ## Refunds Only entirely unused months of a paid quarter are refundable. A month that has begun, even by a second, counts as used. To ask for a refund, write to [hello@kinematic.run](mailto:hello@kinematic.run). Once you have a paid quarter, the **Refunds** list shows each refund with its **Quarter of**, **Months**, **Amount** and **Status**: To be paid, then Paid with a link to the transfer. ## Changes to prices and terms Kinematic may change its terms and prices. A change applies from the start of your next billing quarter, never to a quarter in progress: a quarter you have paid for keeps the prices and terms that were in force when you paid for it. Kinematic emails you before a change applies to you. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.