Next.js recipe

npm install @atmosphere-money/app-node@beta

// src/app/api/checkout/route.ts
import { NextResponse } from "next/server";
import { atm } from "@/lib/atm";

export async function POST(request: Request) {
  const { recipientDid, amountCents } = await request.json();

  const payout = await atm.getPayoutStatus(recipientDid);
  if (!payout.payable) {
    return NextResponse.json({ error: "RecipientNotPayable" }, { status: 409 });
  }

  const approval = await atm.requestRecipientApproval({
    recipientDid,
    environment: "test",
    paymentTypes: ["shop"],
    feeShareBps: 300,
    requestReason: "Enable Next.js checkout"
  });
  if (approval.status !== "approved") {
    return NextResponse.json(
      { error: "RecipientAppApprovalRequired", approvalUrl: approval.dashboardUrl },
      { status: 409 }
    );
  }

  const order = await createAppOrder({ recipientDid, amountCents });
  const checkout = await atm.initiatePayment({
    environment: "test",
    recipient: order.recipientDid,
    amount: order.amountCents,
    currency: "usd",
    paymentType: "shop",
    returnUrl: `https://app.example/orders/${order.id}/return`,
    cancelUrl: `https://app.example/orders/${order.id}`,
    metadata: { appOrderId: order.id }
  });

  return NextResponse.json({ url: checkout.url, token: checkout.token });
}

// src/app/api/webhooks/atm/route.ts
import { constructTypedAtmWebhookEvent } from "@atmosphere-money/app-node";
import { NextResponse } from "next/server";

export async function POST(request: Request) {
  const rawBody = await request.text();
  const event = constructTypedAtmWebhookEvent({
    rawBody,
    secret: process.env.ATM_WEBHOOK_SECRET!,
    expectedType: "payment.completed",
    headers: {
      signature: request.headers.get("atm-signature"),
      deliveryId: request.headers.get("atm-delivery-id"),
      event: request.headers.get("atm-event"),
      apiVersion: request.headers.get("atm-api-version"),
      environment: request.headers.get("atm-environment")
    }
  });

  if (!(await insertDeliveryIdOnce(event.id))) {
    return NextResponse.json({ ok: true, duplicate: true });
  }

  const metadata = event.data.payment.metadata as
    | { appOrderId?: string }
    | undefined;
  const appOrderId = String(metadata?.appOrderId ?? "");
  if (!appOrderId) {
    return NextResponse.json({ error: "MissingAppOrderId" }, { status: 422 });
  }

  await fulfillOrder(appOrderId, event.data.payment.id);
  return NextResponse.json({ ok: true });
}

cd examples/atm-next-starter
npm install
npm run typecheck