Payment use cases

Stablecoin payments for game top-ups

Accept stablecoins (USDT / USDC) for credits, items and top-up packages. BoltUtil checks payment; your server verifies the player and order before granting credits or items.

From payment to fulfillment

Game top-up flow

Best for game stores, credit shops, and digital entertainment platforms.

  1. 01

    Verify player, region and package on your server and create an order.

  2. 02

    Show checkout with the network, asset and full amount.

  3. 03

    Verify the signature and payment status against the original top-up order.

  4. 04

    Record the credit in one business transaction to prevent duplicate grants.

BoltUtil checks payments and sends signed callbacks. Your server verifies signatures and order status, deduplicates events, then delivers goods, activates service or credits accounts.

Integration notes

Connect payments to your business

Verify the player first

Link playerId, region and package to the order. Frontend input alone must not determine grants.

Credits are not stablecoin balances

You receive stablecoins and grant game benefits. Your system determines the conversion to credits.

Credit once

Use order uniqueness or transaction protection for grants. Duplicate callbacks must not create extra player balance.

Top-up order metadata example
POST /api/v1/order/create
Content-Type: application/json

{
  "externalOrderId": "ORDER_DEMO_001",
  "amount": 199,
  "currency": "USDC",
  "network": "BASE",
  "notifyUrl": "https://merchant.example.com/webhooks/boltutil",
  "returnUrl": "https://merchant.example.com/orders/001",
  "metadata": {
    "playerId": "player_889",
    "region": "region_1",
    "package": "gold_500"
  }
}

This order request body is an example and sends nothing. Actual calls require an API key, timestamp and request signature. Merchant-defined metadata does not replace identity or price checks.

Read developer docs

Payment use cases

Before you integrate

Does BoltUtil update the player balance?

No. BoltUtil sends the payment result. Your game server handles balances, regions, items and top-up records.

Which networks support USDT and USDC?

TRON supports USDT. Ethereum, BNB Smart Chain, Polygon, Solana and Base support the configured versions of USDT / USDC. Availability depends on enabled channels and merchant wallets; use the checkout and API response as the source of truth.

How do I handle payment differences or duplicate callbacks?

Do not fulfill from screenshots or browser returns. Check the order and payment record; qualifying payment differences can enter manual review. Accepting an association and quick processing require active membership. Keep processed orders idempotent to prevent duplicate grants.

Add stablecoin payments to your business

Create payment orders, check on-chain transfers and notify your system after confirmation.