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

# Issue and fund a card

> Issue and fund spend-anywhere cards backed by stablecoins.

Spritz cards let your users spend their crypto anywhere cards are accepted. A card is
issued automatically once the user's `crypto_card` capability is active. You fund it
with crypto and manage it through the API.

## Before you start

* Authenticate as an integrator and act on behalf of a verified user. See
  [Authentication](/guides/authentication) and [Onboarding](/guides/onboarding).
* Confirm the user's `crypto_card` capability is `active`. Cards are provisioned
  automatically once it is, so there's no create call
  (see [capabilities](/guides/onboarding#3-read-capabilities)).

## Find the user's card

```bash theme={null}
curl "https://platform.spritz.finance/v1/cards/" \
  # plus your integrator signing headers and the user's Authorization (see Authentication)
```

```json theme={null}
[
  {
    "id": "6a43ac369288351e982157b9",
    "status": "active",
    "type": "virtual",
    "country": "US",
    "currency": "USD",
    "last4": "4242",
    "limit": { "amount": "500.00", "interval": "daily" },
    "payable": true,
    "renderSecret": "..."
  }
]
```

A card's reported `status` is `active`, `frozen`, `not_activated`, or `cancelled`, and
its `type` is `physical` or `virtual`. Note that the values you *send* to change a card's
state are slightly different (`active`, `locked`, `canceled`); see
[Manage the card](#manage-the-card) below.

## Fund the card

Load a card with crypto through the same quote-based flow as an
[off-ramp](/guides/use-cases/off-ramp), with the card as the destination and the
`card_deposit` rail:

```bash theme={null}
curl -X POST https://platform.spritz.finance/v1/off-ramp-quotes/ \
  -H "Content-Type: application/json" \
  # plus signing headers and the user's Authorization
  -d '{
    "accountId": "6a43ac369288351e982157b9",
    "amount": "100.00",
    "amountMode": "output",
    "rail": "card_deposit",
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  }'
```

Fetch the transaction parameters, have the user execute on-chain, and the funds land in
their card program balance (see the [off-ramp guide](/guides/use-cases/off-ramp) for the
on-chain steps). The program balance is a shared pool across the user's cards:

```bash theme={null}
curl "https://platform.spritz.finance/v1/cards/balance" \
  # plus signing headers and the user's Authorization
```

## Manage the card

<AccordionGroup>
  <Accordion title="Freeze, unfreeze, or cancel">
    ```bash theme={null}
    curl -X POST https://platform.spritz.finance/v1/cards/{cardId}/update_status \
      -d '{ "status": "locked" }'   # active | locked | canceled
    ```

    Use `locked` to freeze a card and `active` to unfreeze it. `canceled` is permanent.
  </Accordion>

  <Accordion title="Set a spend limit">
    ```bash theme={null}
    curl -X POST https://platform.spritz.finance/v1/cards/{cardId}/update_limit \
      -d '{ "spendLimit": { "amount": "500.00", "interval": "daily" } }'
    ```

    `interval` is `daily`, `weekly`, `monthly`, `yearly`, `all_time`, or
    `per_transaction`.
  </Accordion>

  <Accordion title="List transactions">
    ```bash theme={null}
    curl "https://platform.spritz.finance/v1/cards/{cardId}/transactions?limit=20"
    ```

    Results are cursor-paginated and can be filtered by status and date range.
  </Accordion>

  <Accordion title="PIN and card details">
    Card PINs and full card details are handled with end-to-end encryption so sensitive
    data never touches your servers: set a PIN with `POST /v1/cards/{cardId}/update_pin`,
    retrieve the encrypted PIN with `POST /v1/cards/{cardId}/pin`, and render the full
    number and CVV using the card's `renderSecret` with Spritz's secure card-rendering
    component.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Off-ramp" icon="arrow-right-from-bracket" href="/guides/use-cases/off-ramp">
    The quote-and-settle flow card funding builds on.
  </Card>

  <Card title="Onboarding" icon="user-plus" href="/guides/onboarding">
    Activate the crypto\_card capability for a user.
  </Card>
</CardGroup>