Your business.
A world of ways to pay.

import { createMayarin } from "@mayarin/sdk";

const secretKey = process.env.MAYARIN_SECRET_KEY;
if (secretKey === undefined) {
  throw new Error("MAYARIN_SECRET_KEY is required");
}

const mayarin = createMayarin({
  baseUrl: "https://api.mayarin.xyz",
  secretKey,
});

// Priced in the currency the business already uses. Amounts are
// human-readable decimal strings — never a float.
const link = await mayarin.commerce.paymentLinks.create({
  kind: "fixed",
  merchant: {
    id: "M-1",
    name: "Studio Supply",
    city: "Singapore",
    countryCode: "SG",
  },
  amount: { amount: "75.00", asset: "SGD" },
  title: "Brand design package",
  merchantReference: "inv-2026-014",
});

// Share it. Nothing about a chain has been decided yet.
console.log(link.url);

import { createMayarin } from "@mayarin/sdk";

const secretKey = process.env.MAYARIN_SECRET_KEY;
if (secretKey === undefined) {
  throw new Error("MAYARIN_SECRET_KEY is required");
}

const mayarin = createMayarin({
  baseUrl: "https://api.mayarin.xyz",
  secretKey,
});

// A rail is one chain and one asset. List the ones a link can be paid on
// and let the payer choose.
const { rails, settlementAsset } = await mayarin.commerce.paymentLinks.rails(link.id);

rails[0]; // { chain: "base-sepolia", asset: "USDC", contract: "0x…", settlementAsset: "USDC" }

// settlementAsset is what the merchant receives on that chain. If the payer's
// asset differs, Mayarin prices the swap when the price is locked.
const intent = await mayarin.commerce.paymentLinks.checkout(link.id, {
  payment: { asset: "EURC", chain: "base-sepolia" },
  executionPath: "deposit-match",
});

// Confirming locks the price and allocates a deposit address for this payment.
const payment = await mayarin.payment.confirmIntent(intent.id);

payment.deposit?.address; // where the payer sends funds
payment.deposit?.amount.formatted; // the exact token amount, for a wallet

import { constructWebhook } from "@mayarin/sdk";

export async function POST(request: Request) {
  // A webhook is a signal, not truth: the signature is checked, then the
  // payment is read back from the API before the order is marked paid.
  const event = await constructWebhook({
    payload: await request.text(),
    signature: request.headers.get("webhook-signature") ?? "",
    secret: process.env.MAYARIN_WEBHOOK_SECRET ?? "",
  });

  const payment = await mayarin.payment.get(event.data.paymentIntentId);
  if (payment.paymentIntent.status === "COMPLETED") {
    await markOrderPaid(payment.paymentIntent.merchantReference);
  }

  return new Response(null, { status: 202 });
}

// Every step a payment takes is recorded as it happens, so the status
// your dashboard shows is the one the API returns — nothing inferred later.
const payment = await mayarin.payment.get(paymentIntentId);
const intent = payment.paymentIntent;

intent.status; // "CREATED" | "CONFIRMED" | "PROCESSING" | "COMPLETED" | "FAILED" | "EXPIRED"

// The finer-grained clearing steps, in order.
payment.timeline;

if (intent.status === "FAILED") {
  console.error(intent.failureReason);
}