Euro cards for your business.

const tuppence = new Tuppence(process.env.TUPPENCE_SECRET_KEY!);

// A virtual card, ready to spend.
const card = await tuppence.cards.create({
  limits: { per_authorization: 5000, monthly: 50000 },
});

// Optional: the rules it spends under.
const policy = await tuppence.spendPolicies.create({
  name: "Software only",
  allowed_merchant_kinds: ["software"],
  approval_threshold: 10000, // a person says yes from €100
});
await tuppence.cards.update(card.id, { spend_policy: policy.id });

// Optional: a card of its own for an AI agent.
const agent = await tuppence.agents.create({ name: "Research agent" });
await tuppence.cards.create({ agent: agent.id });

import { Tuppence } from "@tuppence/node";

const tuppence = new Tuppence(process.env.TUPPENCE_SECRET_KEY);

// What the cards can spend now.
const balance = await tuppence.request("GET", "/v1/issuing/balance");
// { spendable: 25000, currency: "eur",
//   spends_from: "issuing_balance", … }

// The card balance's own IBAN, for SEPA transfers.
const bank = await tuppence.request(
  "GET",
  "/v1/issuing/funding_instructions",
);

// Test mode: a €100 SEPA transfer arrives.
await tuppence.request("POST", "/v1/test_helpers/issuing/fund", {
  body: { amount: 10000 },
});

import os
from tuppence import Tuppence

tuppence = Tuppence(os.environ["TUPPENCE_SECRET_KEY"])

# What the cards can spend now.
balance = tuppence.request("GET", "/v1/issuing/balance")
print(balance["spendable"], balance["spends_from"])

# The card balance's own IBAN, for SEPA transfers.
bank = tuppence.request("GET", "/v1/issuing/funding_instructions")
print(bank["available"])

# Test mode: a €100 SEPA transfer arrives.
tuppence.request(
    "POST", "/v1/test_helpers/issuing/fund", body={"amount": 10000}
)

# What the cards can spend now.
curl https://api.tuppence.ai/v1/issuing/balance \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY"

# The card balance's own IBAN, for SEPA transfers.
curl https://api.tuppence.ai/v1/issuing/funding_instructions \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY"

# Test mode: a €100 SEPA transfer arrives.
curl https://api.tuppence.ai/v1/test_helpers/issuing/fund \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"amount": 10000}'

// Cents, per purchase, day, week, month or all time.
// null removes a limit; a card always keeps one.
await tuppence.cards.setLimits(card.id, {
  monthly: 100000,          // €1,000 a month
  per_authorization: null,
});

// One purchase, at one merchant, up to €24.
const once = await tuppence.cards.create({
  usage: "single_use",
  amount: 2400,
  merchant: { name: "Lumen Labs" },
});

// Stop it at once, and start it again.
await tuppence.cards.freeze(card.id);
await tuppence.cards.unfreeze(card.id);

// The card pays wherever its policy allows,
// and the policy decides the moment the merchant charges it.
const { data } = await tuppence.cardAuthorizations.list({
  card: card.id,
});
// [{ amount: 1800, merchant: { name: "Lumen Labs", … },
//    approved: true, decided_by: "policy", … }]

// Over the threshold? Ask first, so the merchant never sees a decline.
const approval = await tuppence.approvals.create({
  card: card.id,
  amount: 24000, // €240.00
  merchant: { name: "Halcyon & Co" },
  description: "Annual data licence",
});
// A person says yes in the dashboard or the app. Then buy.

# Test mode: a purchase, decided as a real one would be.
curl https://api.tuppence.ai/v1/test_helpers/issuing/authorizations \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"card": "card_01K…", "amount": 1800,
       "merchant": {"name": "Lumen Labs", "mcc": 5734}}'

{
  "object": "card_authorization",
  "amount": 1800,
  "approved": true,
  "decided_by": "policy",
  "spend_policy": "pol_01K…",
  …
}