# Card Field
> A one-row card input for checkout. The number groups the way the brand prints it, then slides to its last four to make room for expiry and CVC.

## Installation

```bash
npx shadcn@latest add @kokonutui/card-field
```

## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `amount?` | `number` | `48` | What the button charges. |
| `currency?` | `string` | `"$"` |  |
| `onPay?` | `(card: CardDetails) => Promise<void> \| void` |  | Charge the card. Return a promise and the button waits for it. |
| `testMode?` | `boolean` | `true` | Shows a "Use test card" link that types 4242… in for you. |
| `className?` | `string` |  | Extra classes for the root element. |

### CardDetails

| Field | Type | Description |
| --- | --- | --- |
| `brand` | `Brand` |  |
| `last4` | `string` |  |
| `expiry` | `string` | MM/YY |

### Brand

```ts
type Brand = "visa" | "mastercard" | "amex" | "discover" | "unknown";
```

## Source

```tsx
"use client";

/**
 * @author: @dorianbaffier
 * @description: Card Field
 * @version: 1.0.0
 * @date: 2026-10-22
 * @license: MIT
 * @website: https://kokonutui.com
 * @github: https://github.com/kokonut-labs/kokonutui
 */

//... source code continues...

export interface CardFieldProps {
  /** What the button charges. */
  amount?: number;
  currency?: string;
  /** Charge the card. Return a promise and the button waits for it. */
  onPay?: (card: CardDetails) => Promise<void> | void;
  /** Shows a "Use test card" link that types 4242… in for you. */
  testMode?: boolean;
  className?: string;
}

//... more source code...

const pay = async () => {
        if (!ready || status !== "idle") {
            return;
        }
        setStatus("paying");
        const details = {
            brand: spec.brand,
            last4: number.slice(-4),
            expiry: `${expiry.slice(0, 2)}/${expiry.slice(2)}`,
        };
        try {
            await (onPay?.(details) ??
                new Promise((resolve) => setTimeout(resolve, 1100)));
        } catch {
            // A declined charge leaves the card as typed, ready to try again.
            setStatus("idle");
            return;
        }
        setStatus("paid");
        clearTimeout(resetTimer.current);
        resetTimer.current = setTimeout(() => {
            setNumber("");
            setExpiry("");
            setCvc("");
            setEditingNumber(true);
            setStatus("idle");
        }, 2400);
    };
//... final implementation of the component
```
