> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aps-store.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cards.lua

> Card settings of aps_banking: items, card limit, PIN length, wrong PIN attempts, card tiers, reprint price and stolen card use.

`config/cards.lua` holds these settings. Every option is explained in the comments below.

> [!NOTE]
>
> Runs on: **shared**. This file stays editable when the resource is escrow-protected. Restart the resource after a change.

```lua theme={null}
Config = Config or {}

Config.Cards = {
    item        = 'aps_bank_card',
    receiptItem = 'aps_bank_receipt',

    maxPerAccount = 3,
    pinLength     = 4,
    labelLength   = 24,

    -- PIN mistakes before the card blocks itself (counted on the server,
    -- per card, whoever is typing)
    maxAttempts = 3,

    -- ─────────────────────────────────────────
    --  Card tiers
    --    price        paid from the account the card belongs to
    --    dailyLimit   most that can be withdrawn per day
    --    validMonths  until the card expires
    --    style        look of the rendered card: 'brand' (follows Config.Branding.accent) | 'graphite' | 'gold' | 'ice'
    -- ─────────────────────────────────────────
    tiers = {
        { id = 'basic',    label = 'Basic',    price = 1000,  dailyLimit = 5000,   validMonths = 12, style = 'brand' },
        { id = 'plus',     label = 'Plus',     price = 5000,  dailyLimit = 25000,  validMonths = 24, style = 'ice' },
        { id = 'premier',  label = 'Premier',  price = 15000, dailyLimit = 50000,  validMonths = 36, style = 'graphite' },
        { id = 'reserve',  label = 'Reserve',  price = 50000, dailyLimit = 250000, validMonths = 48, style = 'gold' },
    },

    -- Fee for a new physical item of an existing card
    reprintPrice = 250,

    -- ─────────────────────────────────────────
    --  Stolen cards
    --    enabled     false: a card only works for its holder, whoever carries it
    --    notifyOwner tell the holder when their card is used by someone else
    --    The thief still needs the PIN, and wrong PINs block the card.
    -- ─────────────────────────────────────────
    stolen = {
        enabled     = true,
        notifyOwner = true,
    },
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.