Issue and fund a card

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 and 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).

Find the user’s card

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

[
  {
    "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 below.

Fund the card

Load a card with crypto through the same quote-based flow as an off-ramp, with the card as the destination and the card_deposit rail:

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 for the on-chain steps). The program balance is a shared pool across the user’s cards:

curl "https://platform.spritz.finance/v1/cards/balance" \
  # plus signing headers and the user's Authorization

Manage the card

Freeze, unfreeze, or cancel

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.

Set a spend limit

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.

List transactions

curl "https://platform.spritz.finance/v1/cards/{cardId}/transactions?limit=20"

Results are cursor-paginated and can be filtered by status and date range.

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.

Off-ramp

The quote-and-settle flow card funding builds on.

Onboarding

Activate the crypto_card capability for a user.

Get Started

Europe (EEA)

Core Concepts

Use Cases

Issue and fund a card

Before you start

Find the user’s card

Fund the card

Manage the card

Off-ramp

Onboarding

​Before you start

​Find the user’s card

​Fund the card

​Manage the card

​Related

Off-ramp

Onboarding

Before you start

Find the user’s card

Fund the card

Manage the card

Related