A developer-friendly payments API with better economics.

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

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

// A payment link to share, in your account's currency, and its address.
const link = await tuppence.paymentLinks.create({
  name: "Research report",
  amount: 2000,
});
console.log(link.url);

// A payment, retried safely: the same key never charges twice.
const idempotencyKey = `order-${Date.now()}`;
const payment = await tuppence.payments.create(
  { amount: 4500, currency: "gbp" },
  { idempotencyKey },
);

// Part of it back, later.
const refund = await tuppence.refunds.create({ payment: payment.id, amount: 500 });
console.log(refund.status);

import os
from tuppence import Tuppence

tuppence = Tuppence(os.environ["TUPPENCE_SECRET_KEY"])
payment = tuppence.payments.create(amount=2000, currency="gbp", description="Order 1042")
print(payment.status, payment.approval_url)

curl https://api.tuppence.ai/v1/payments \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{"amount": 2000, "currency": "gbp"}'

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

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

/**
 * Your webhook route hands over the raw body and its Tuppence-Signature header.
 * @param {Buffer} rawBody
 * @param {string} signature
 */
export function handle(rawBody, signature) {
  const event = tuppence.webhooks.constructEvent(rawBody, signature, process.env.TUPPENCE_WEBHOOK_SECRET);
  if (event.type === "payment.succeeded") console.log("paid", event.data.object.id);
}