// npm install @token-gesture/payments   (Node 20+, no dependencies)
import { Payments } from "@token-gesture/payments";

const payments = new Payments({
  baseUrl: process.env.PAYMENTS_API_URL!,
  apiKey:  process.env.PAYMENTS_API_KEY!,
});

const link = await payments.links.create({
  invoiceId: "inv_184",
  customerId: "cus_7f3a91",
  amount: 412000,
  currency: "EUR",
});

redirect(link.url);

import { verifyWebhook } from "@token-gesture/payments/webhooks";

app.post("/webhooks/payments", express.raw({ type: "*/*" }), (req, res) => {
  let event;
  try {
    event = verifyWebhook({
      body: req.body,                            // the bytes, not a parsed object
      headers: req.headers,                      // timestamp + signature, checked together
      secret: process.env.PAYMENTS_WEBHOOK_SECRET!,
    });
  } catch (err) {
    // reason: missing_signature | bad_signature | stale | malformed
    return res.sendStatus(400);
  }

  switch (event.type) {
    case "payment.succeeded": markInvoicePaid(event.data); break;
    case "payout.paid":       reconcilePayout(event.data); break;
    case "refund.created":    markRefunded(event.data); break;
    case "subscription.renewed": extendPeriod(event.data); break;
  }

  res.sendStatus(200);   // delivery is one attempt: 200 fast, work after
});

# Create a payment link for an invoice
curl -X POST https://payments.token-gesture.com/api/service/payment-links \
  -H "X-API-Key: $PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_id":  "inv_184",
    "customer_id": "cus_7f3a91",
    "amount":      412000,
    "currency":    "EUR"
  }'

# → 200 OK
# {
#   "url":        "https://secure.token-gesture.com/pay/48812",
#   "payment_id": "pay_01JQ8M2X",
#   "expires_at":      "2026-09-13T04:22:11Z"
# }

# Read the invoice payment state
curl https://payments.token-gesture.com/api/service/invoices/inv_184 \
  -H "X-API-Key: $PAYMENTS_API_KEY"

// Reconcile a payout back to the invoices inside it.
const payout = await payments.payouts.get("po_01JQ8M2X");

for (const item of payout.items) {
  await finance.markPaid({
    invoiceId: item.invoice_id,
    paymentId: item.payment_id,
    fee: item.fee,
    net: item.net,
  });
}