Errors

{
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Insufficient funds",
    "details": { "required": 50, "available": 20 }
  }
}

{ "error": { "code": "INSUFFICIENT_FUNDS", "message": "Not enough items", "details": { "required": 5, "available": 1 } } }

{ "error": { "code": "LIMIT_REACHED", "message": "Item ownership limit exceeded", "details": { "maxOwned": 1, "owned": 1 } } }

{ "error": { "code": "PACK_NOT_AVAILABLE", "message": "The pack is not on sale", "details": { "startsAt": "2026-11-01T09:00:00.000Z", "endsAt": null } } }

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Invalid request body",
    "details": { "fieldErrors": { "paid": ["Unrecognized field"] } }
  }
}

import { ErrorCode, GameCoinError } from "@apilow/gamecoin";

try {
  await gamecoin.wallet.spend(ext("user-42"), { currency: "gems", amount: 50 }, { idempotencyKey: "revive-user-42-7" });
} catch (error) {
  if (!(error instanceof GameCoinError)) throw error;
  if (error.code === ErrorCode.INSUFFICIENT_FUNDS) {
    const { required, available } = error.details; // 50, 20
    console.log(`short by ${required - available}: offer a pack`);
  } else if (error.code === ErrorCode.RATE_LIMITED) {
    console.log(`wait ${error.retryAfter} seconds`);
  } else {
    throw error; // error.code, error.status, error.message, error.details
  }
}

from gamecoin import ErrorCode, GameCoinError

try:
    gamecoin.wallet.spend(ext("user-42"), currency="gems", amount=50, idempotency_key="revive-user-42-7")
except GameCoinError as error:
    if error.code == ErrorCode.INSUFFICIENT_FUNDS:
        required, available = error.details["required"], error.details["available"]  # 50, 20
        print(f"short by {required - available}: offer a pack")
    elif error.code == ErrorCode.RATE_LIMITED:
        print(f"wait {error.retry_after} seconds")
    else:
        raise  # error.code, error.status, error.message, error.details

use Apilow\GameCoin\ErrorCode;
use Apilow\GameCoin\GameCoinException;

try {
    $gamecoin->wallet->spend(PlayerRef::ext('user-42'), ['currency' => 'gems', 'amount' => 50], ['idempotency_key' => 'revive-user-42-7']);
} catch (GameCoinException $e) {
    if ($e->errorCode === ErrorCode::INSUFFICIENT_FUNDS) {
        ['required' => $required, 'available' => $available] = $e->details; // 50, 20
        echo 'short by ', $required - $available, ": offer a pack\n";
    } elseif ($e->errorCode === ErrorCode::RATE_LIMITED) {
        echo "wait {$e->retryAfter} seconds\n";
    } else {
        throw $e; // $e->errorCode, $e->status, $e->getMessage(), $e->details
    }
}

_, err = client.Wallet.Spend(ctx, gamecoin.Ext("user-42"), gamecoin.SpendParams{Currency: "gems", Amount: 50}, gamecoin.WithIdempotencyKey("revive-user-42-7"))
var gcErr *gamecoin.Error
switch {
case errors.As(err, &gcErr) && gcErr.Code == gamecoin.CodeInsufficientFunds:
	required, _ := gcErr.DetailInt64("required")   // 50
	available, _ := gcErr.DetailInt64("available") // 20
	fmt.Printf("short by %d: offer a pack\n", required-available)
case errors.As(err, &gcErr) && gcErr.Code == gamecoin.CodeRateLimited:
	fmt.Printf("wait %.0f seconds\n", gcErr.RetryAfter.Seconds())
case err != nil:
	log.Fatal(err) // gcErr.Code, gcErr.Status, gcErr.Message, gcErr.Details
}

using Apilow.GameCoin;

try
{
    await gamecoin.Wallet.SpendAsync(PlayerRef.Ext("user-42"), new SpendRequest { Currency = "gems", Amount = 50 }, new RequestOptions { IdempotencyKey = "revive-user-42-7" });
}
catch (GameCoinException ex) when (ex.Code == GameCoinErrorCodes.InsufficientFunds)
{
    var required = ex.Details["required"].GetInt64();   // 50
    var available = ex.Details["available"].GetInt64(); // 20
    Console.WriteLine($"short by {required - available}: offer a pack");
}
catch (GameCoinException ex) when (ex.Code == GameCoinErrorCodes.RateLimited)
{
    Console.WriteLine($"wait {ex.RetryAfter?.TotalSeconds} seconds");
}
// Any other GameCoinException goes up: ex.Code, ex.Status, ex.Message, ex.Details

try {
  await gc.spend("gems", 50, "revive");
} catch (error) {
  if (error.code === "INSUFFICIENT_FUNDS") {
    const { required, available } = error.details; // 50, 20
    showShop(required - available); // offer a pack
  } else {
    throw error; // a GameCoinError: code, status, message, details
  }
}