Payment links

A payment link is something to pay for: a title and an amount in a currency. Customers pay it at /pay/<id> on your server: share the link, or send customers to it from your site.

FieldsCopy Anchor Link

reference and meta are never shown to customers. They come back on the link, and on every transfer webhook for a payment made through it.

Creating oneCopy Anchor Link

In the dashboard, under Payment links:

From your backend, with the SDK:

const { data: link } = await kite.paymentLinks.create({
  body: {
    title: "Pro plan",
    currency: "USD",
    amount: "49",
    usage: "OneTime", // or "Reusable"
    reference: order.id,
  },
});

const url = `https://pay.example.com/pay/${link.id}`;

Find it again later by reference:

const { data } = await kite.paymentLinks.list({
  query: { reference: order.id },
});

One link or manyCopy Anchor Link

A link's usage field controls how many times it can be paid:

• OneTime (default): The link can be paid once. After a successful payment, further attempts are rejected. Use this for order-specific links where each order gets its own link with the order ID as reference.
• Reusable: The link accepts unlimited payments. Use this for donation pages, fixed-price products, or invoices sent by hand.

// One link per order (one-time)
const { data: link } = await kite.paymentLinks.create({
  body: {
    title: "Order #1234",
    currency: "USD",
    amount: "49",
    usage: "OneTime",
    reference: "order-1234",
  },
});

// One reusable link for a product
const { data: link } = await kite.paymentLinks.create({
  body: {
    title: "Pro subscription",
    currency: "USD",
    amount: "49",
    usage: "Reusable",
  },
});