toekyn/ payments

DEVELOPER PREVIEW

One purchase.
A complete contract.

Start with a cosmetic item. Keep price, payment status and delivery evidence connected.

Versioned contracts and a synthetic SQLite ledger are implemented and tested locally. A hosted API and SDK are not available yet. The public sandbox uses browser memory only.

The first integration

  1. Create an intent. Your server supplies the approved catalog item, player scope and exact asset amount.
  2. Confirm the purchase. The player reviews merchant, item, amount and applicable terms.
  3. Verify the outcome. Use the same operation ID to inspect an unknown response; do not create a second charge.
  4. Deliver the item once. Your game acknowledges entitlement delivery independently of payment settlement.
  5. Recover or refund. Track delivery failures and bounded refunds against the original receipt.
// Validated v1 synthetic fixture — not a live endpoint
{
  "apiVersion": "toekyn.payments.v1",
  "kind": "purchase",
  "scope": {
    "environment": "sandbox",
    "merchantId": "synthetic-studio",
    "titleId": "sandlot-football"
  },
  "commandId": "purchase-001",
  "playerId": "synthetic-player",
  "expectedRevision": 1,
  "catalogItemId": "celebration-after-hours",
  "catalogVersion": "catalog-v1",
  "money": {
    "asset": {
      "network": "synthetic",
      "code": "SIMULATED_USDC",
      "decimals": 6,
      "mint": null,
      "tokenProgram": null
    },
    "amountBaseUnits": "1990000"
  },
  "consentRef": "synthetic-consent-001"
}

Download the synthetic contract fixture ↗

Scope and price must be validated by the server. Asset configuration includes network, mint, token program and decimals. Never put private keys or bank credentials in the game client.

Three distinct systems

Your game

Simulation, matchmaking, earned progression, catalog and authoritative results.

Toekyn

Payment contracts, monetary ledger, scoped receipts, policy orchestration and recovery.

Financial rails

Selected wallet, chain, conversion and bank providers, with responsibilities agreed before live use.

USDC first. No launch token.

Native USDC on Solana is the proposed money asset. Earned game points stay off-chain. Optional cosmetic ownership and tournament escrow are later modules; they do not make cash competitions automatically eligible.

What live integration requires

Verified custody and provider arrangements, supported jurisdictions and storefronts, security review, reliable reconciliation and customer support. A mainnet escrow program also needs independent audit and a controlled authority model.

Try the illustrative flow ↗