# VNT Individual One-time Card Skill

Use this skill when a user asks to create or check an Individual One-time Card
through a VNT server.

## Required Configuration

The agent must know the VNT server base URL. It must not ask the user for card
processor, payment provider, treasury, webhook, or job credentials.

Recommended environment variable:

```bash
VNT_SERVER_URL=https://your-vnt-server.example
```

## Workflow

1. Ask the user for the desired card amount in USD if it was not provided.
2. Call `POST {VNT_SERVER_URL}/api/instant-card/quote` with:

```json
{ "amount": "100" }
```

3. If the quote is unavailable, tell the user the service is temporarily not
   available and ask them to retry later.
4. If available, call `POST {VNT_SERVER_URL}/api/instant-card/checkout` with:

```json
{ "amount": "100" }
```

5. Return only:
   - payment link
   - status link
   - card amount
   - checkout amount
   - expiration guidance
6. For status checks, call:

```text
GET {VNT_SERVER_URL}/api/instant-card/status/{orderId}
```

7. If the card is ready, return the claim link. Do not print card credentials.

## Prohibited Behavior

- Do not store or request provider API keys.
- Do not call payment provider or card processor APIs directly.
- Do not print PAN, CVV, full raw provider payloads, or provider credentials.
- Do not promise a card if the quote or checkout response says service is not
  available.

## User-Facing Language

When service is unavailable:

```text
This service is temporarily unavailable for that amount. Please try again later.
```

When checkout is created:

```text
Your payment link is ready. After payment confirmation, use the status link to
retrieve the secure claim link for your one-time card.
```