Payment#

import { createPayment } from "@buntok/core/payment";

const stripe = createPayment.stripe({
  secretKey: process.env.STRIPE_SECRET_KEY!,
  webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
});

const midtrans = createPayment.midtrans({
  serverKey: process.env.MIDTRANS_SERVER_KEY!,
  isProduction: false,
});

const xendit = createPayment.xendit({
  secretKey: process.env.XENDIT_SECRET_KEY!,
});

const paypal = createPayment.paypal({
  clientId: process.env.PAYPAL_CLIENT_ID!,
  clientSecret: process.env.PAYPAL_CLIENT_SECRET!,
  mode: "sandbox",
});

const result = await stripe.createCheckout({
  amount: 100000,
  currency: "IDR",
  description: "Order #123",
  customerEmail: "user@example.com",
  successUrl: "https://myapp.com/success",
  cancelUrl: "https://myapp.com/cancel",
}, {
  idempotencyKey: "order-123",
});

// result.checkoutUrl → redirect customer to pay
// result.status → "pending" | "processing" | "completed" | "failed" | ...

type CheckoutStatus =
  | "pending"
  | "processing"
  | "requires_action"
  | "completed"
  | "failed"
  | "expired"
  | "cancelled";

const refund = await stripe.createRefund({
  paymentId: "pi_xxx",
  amount: 50000,      // partial refund (omit for full)
  reason: "customer_request",
});

// refund.status → "pending" | "completed" | "failed" | "partially_refunded"

const sub = await stripe.createSubscription({
  planId: "price_xxx",
  customerEmail: "user@example.com",
  trialPeriodDays: 14,
});

// Cancel
await stripe.cancelSubscription(sub.id);

type SubscriptionStatus =
  | "active"
  | "past_due"
  | "cancelled"
  | "suspended"
  | "expired"
  | "incomplete";

const link = await stripe.createPaymentLink({
  amount: 100000,
  currency: "IDR",
  description: "One-time payment",
});

// link.url → share with customer

import { paymentWebhook } from "@buntok/core/payment";

app.post("/webhooks/stripe",
  paymentWebhook({
    driver: stripe,
    secret: process.env.STRIPE_WEBHOOK_SECRET!,
  }),
  (ctx) => {
    const event = ctx.store.paymentEvent;
    // event.type → "payment.completed" | "payment.failed" | ...
    return ctx.json({ received: true });
  }
);

type WebhookEventType =
  | "payment.completed"
  | "payment.failed"
  | "payment.expired"
  | "payment.created"
  | "subscription.created"
  | "subscription.cancelled"
  | "subscription.payment_succeeded"
  | "subscription.payment_failed"
  | "subscription.suspended"
  | "refund.completed"
  | "refund.failed";

import {
  PaymentError,              // base class (extends HttpError)
  PaymentProviderError,      // 502 - provider API error
  PaymentVerificationError,  // 400 - webhook signature mismatch
  PaymentIdempotencyError,   // 409 - idempotency key reuse
  PaymentConfigurationError, // 500 - invalid driver config
} from "@buntok/core/payment";