Cantilapay SDK reference phase-2

import { Cantilapay } from "@cantila/cantilapay";

const cp = new Cantilapay(process.env.CANTILAPAY_SECRET_KEY!);

const account = await cp.accounts.retrieve();
if (!account.testReady) {
  const { url } = await cp.accounts.onboardingLink({
    mode: "test",
    country: "US",
    returnUrl: "https://app.example.com/payments",
  });
  // redirect to `url`
}

const customer = await cp.customers.create({
  email: "buyer@example.com",
  name: "Ada Lovelace",
  externalRef: "user_42",
});

const intent = await cp.paymentIntents.create({
  amount: 2500,
  currency: "usd",
  customerId: customer.id,
  paymentMethodId: method.id,
  captureMode: "manual", // capture later
});
const confirmed = await cp.paymentIntents.confirm(intent.id);
if (confirmed.status === "requires_capture") {
  await cp.paymentIntents.capture(intent.id);
}

const method = await cp.paymentMethods.create({
  pspToken: "tok_from_dropin",
  customerId: customer.id,
});
console.log(method.card?.brand, method.card?.last4);

const sub = await cp.subscriptions.create({
  customerId: customer.id,
  priceId: price.id,
  defaultPaymentMethodId: method.id,
  trialPeriodDays: 14,
});
// Cancel at the end of the current period instead of immediately:
await cp.subscriptions.cancel(sub.id, { atPeriodEnd: true });

// Omit `amount` for a full refund.
await cp.refunds.create({
  paymentIntentId: intent.id,
  amount: 500, // partial: $5.00
  reason: "requested_by_customer",
});

const product = await cp.products.create({ name: "Pro Plan" });

const price = await cp.prices.create({
  productId: product.id,
  unitAmount: 2900, // $29.00
  currency: "usd",
  recurring: { interval: "month", intervalCount: 1 },
});

const { invoices } = await cp.invoices.list({
  subscriptionId: sub.id,
  status: "open",
});

const session = await cp.checkoutSessions.create({
  sessionMode: "payment",
  uiMode: "hosted",
  currency: "usd",
  successUrl: "https://app.example.com/success",
  cancelUrl: "https://app.example.com/cart",
  paymentItems: [{ name: "T-shirt", amount: 1999, currency: "usd", quantity: 2 }],
});
// Redirect the buyer to `session.url`.

const portal = await cp.billingPortalSessions.create({
  customerId: customer.id,
  returnUrl: "https://app.example.com/account",
});
// Redirect to `portal.url`.

await cp.payouts.create({ currency: "usd" }); // pay out all available USD

const balance = await cp.balance.retrieve({ currency: "usd" });
console.log(balance.available, balance.pending);

const calc = await cp.tax.calculate({
  amount: 10000,
  currency: "usd",
  customerCountry: "US",
  customerState: "CA",
  customerPostalCode: "94016",
});
console.log(calc.taxAmount, calc.taxRateBps);

cp.webhooks.verify({
  rawBody,
  signatureHeader: req.headers["cantilapay-signature"],
  signingSecret: process.env.CANTILAPAY_WEBHOOK_SECRET!,
});

import { Cantilapay, CantilapayError } from "@cantila/cantilapay";

try {
  await cp.paymentIntents.confirm("pi_xxx");
} catch (err) {
  if (err instanceof CantilapayError) {
    console.error(err.status, err.type, err.code, err.message, err.param, err.requestId);
  }
}

// Use your own key (recommended for important writes):
await cp.paymentIntents.create(
  { amount: 1000, currency: "usd" },
  { idempotencyKey: "order-4821" },
);

// Skip idempotency entirely:
await cp.customers.create({ email: "x@y.com" }, { noIdempotency: true });