Skip to main content

Purchase intents

Purchase intents let you publish a shareable Buy link for one product offer. Use them for campaigns, social commerce, QR codes, or lightweight storefront flows where a customer should land directly on a hosted checkout page.

Use MCP to manage Buy links

An authenticated AI agent can create, send, update, cancel, list, inspect, or render Buy links with confirmation for state-changing actions.

MCP tools: create_buy_link, send_buy_link_sms, update_buy_link, cancel_buy_link, list_buy_links, get_buy_link or render_buy_link_card

Confirmed MCP actions require explicit form confirmation before Inttegro changes state.

Use this page to understand Buy-link behavior. Use the Purchase Intents API reference for exact request attributes and response shapes.

Note

A Buy link is customer-facing access to an offer. The sale_... ID is not a secret API key, but anyone with the link can view the offer while it is active.

What purchase intents are for

A purchase intent is the offer behind a Buy link. It fixes what can be bought, how much it costs, how many units can be purchased, how long the link is valid, and whether the link can create one order or many.

It is not an order or a payment. The order is created only when a customer opens the link and checks out.

ResourceRole
ProductCatalog identity, description, media, product type, and fulfillment context.
PriceAmount and currency used for the offer.
Purchase intentBuy-link policy: product, price, quantity bounds, expiry, variants, and usage mode.
Checkout pageCustomer-facing page at pages.inttegro.com/buy/{sale_id}.
OrderActual transaction created when a customer checks out.
  1. Create a product and active price, or decide to use an inline price for the offer.
  2. Create a purchase intent from your server.
  3. Store the returned sale_... ID.
  4. Share the hosted URL with customers.
  5. Track the resulting orders through the Orders API.

The customer-facing URL is:

https://pages.inttegro.com/buy/sale_B7tQ2nLm5yR8cV1pKs4Dx9Ha

The URL can be placed in a campaign, social post, QR code, SMS, email, or merchant storefront.

Usage modes and lifecycle

Choose the usage mode before publishing the link.

ModeBehaviorUse it for
Single-useThe first successful order creation consumes the link.One customer, one claim, invoice-like selling, reserved inventory.
Multi-useThe same link can keep creating independent orders.Campaigns, public product pages, recurring social commerce links.

The public lifecycle is derived from the link’s current state.

StatusMeaning
activeThe offer can accept checkout.
expiredexpires_at has passed.
inactiveYou canceled the offer.
usedA single-use link already created an order.

Update can change quantity bounds, expiry, or active state. It cannot turn the same link into a different product, price, variant selection, or usage mode. If the offer itself needs to change, create a new purchase intent and share the new URL.

Offer controls

Use purchase-intent controls to prevent a shared link from drifting away from what customers saw.

  • Set required quantity.min and optional quantity.max to bound cart size. Omit quantity.max when the offer should have no upper limit.
  • Set expires_at for campaign windows or time-limited offers.
  • Use single-use links for private offers.
  • Cancel stale or mistaken links instead of deleting records.
  • Use variant-set support when the customer should choose among eligible variants of the same offer.

Comparison pricing is display-only. It can help show a markdown or campaign price, but the purchase price is the amount Inttegro uses when creating the order.

Where MCP helps

MCP is useful for assisted Buy-link operations:

  • create a Buy link for an existing product and price;
  • send a Buy link by SMS to an existing customer;
  • list or inspect active links;
  • update quantity bounds or expiry after confirmation;
  • cancel a stale link after confirmation; and
  • render a returned Buy link as a compact card.

MCP actions are confirmed actions. Use your application backend for unattended link creation or campaign automation.

Implementation checklist

Before using Buy links in production:

  • create or select the catalog product and price first;
  • choose single-use or multi-use deliberately;
  • set quantity bounds that match inventory or fulfillment capacity;
  • set expiry for campaign links;
  • store the sale_... purchase intent ID;
  • track resulting orders through the Orders API;
  • cancel links that should stop accepting purchases; and
  • reconcile sales from orders and balances, not from link views alone.