Checkouts - Crevio

A checkout is a single pay-for-this session; a checkout link is a reusable, shareable URL that opens one. Both turn your published price variants into money. You can ask Crevio to “send Jane a checkout for the $99 course with the LAUNCH20 code” and the agent builds it through the same API below. For programmatic flows — custom websites, “buy now” buttons, invoicing — you’ll create checkouts directly.

Creating a checkout

POST /checkouts takes one or more line items, each pointing at a price variant by id:

curl -X POST https://api.crevio.co/v1/checkouts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "line_items": [
      { "price_variant": "price_abc123", "quantity": 1 }
    ]
  }'

The response is a checkout ("object": "checkout", id like co_...) with a URL the buyer visits to pay. When they complete it, an order is created.

Checkout fields

Field	Type	Notes
`line_items`	array	Each item is `{ price_variant (required), quantity }`. Add multiple to sell a bundle in one checkout.
`email`	string	The buyer’s email. Use this for a brand-new buyer.
`customer`	string	An existing customer id (`cus_...`). Use instead of `email` to attach the purchase to a known customer.
`discount_code`	string	A discount code applied to this checkout. See Discounts.
`invoice`	string	An invoice id (`inv_...`) to pay — an alternative to `line_items`. See below.

Multiple line items

curl -X POST https://api.crevio.co/v1/checkouts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_xyz789",
    "discount_code": "LAUNCH20",
    "line_items": [
      { "price_variant": "price_abc123", "quantity": 1 },
      { "price_variant": "price_def456", "quantity": 2 }
    ]
  }'

Paying an invoice

Instead of line items, pass an invoice id to create a checkout that settles that invoice:

curl -X POST https://api.crevio.co/v1/checkouts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invoice": "inv_abc123" }'

See Subscriptions & billing for creating and managing invoices.

Worked example: sell to a customer end-to-end

import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({ apiKeyAuth: "YOUR_API_TOKEN" });

// 1. Create (or look up) the customer.
const customer = await crevio.customers.create({
  email: "jane@example.com",
  name: "Jane Doe",
  customer_type: "lead",
});

// 2. Create a checkout for them, applying a launch discount.
const checkout = await crevio.checkouts.create({
  customer: customer.id,
  discount_code: "LAUNCH20",
  line_items: [{ price_variant: "price_abc123", quantity: 1 }],
});

// 3. Send the buyer to the checkout URL to pay.
console.log(checkout.url);

When the buyer pays, listen for the order.paid webhook event to fulfill the purchase.

Reusable checkout links

When you want one durable URL to share — in a bio link, an email, a “buy now” button — create a checkout link with POST /checkout_links:

curl -X POST https://api.crevio.co/v1/checkout_links \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Guitar course launch",
    "price_variants": ["price_abc123"],
    "discount": "disc_launch20",
    "allow_discount_codes": true,
    "success_url": "https://example.com/thanks",
    "metadata": { "campaign": "summer-launch" }
  }'

Checkout link fields

Field	Type	Notes
`name`	string	Internal label for the link.
`price_variants`	array	The price variant ids (`price_...`) the link sells.
`discount`	string	A discount id (`disc_...`) applied automatically. See Discounts.
`allow_discount_codes`	bool	Whether buyers can enter their own code at checkout.
`success_url`	string	Where to send the buyer after a successful purchase.
`metadata`	object	Arbitrary key/values that flow through to the resulting order — handy for attribution.

The response includes an id (cl_...) and the shareable URL. Checkout links support full CRUD — update, list, retrieve, and delete them like any other resource.

Use a checkout for a one-off, often personalized sale (you know the buyer), and a checkout link for an evergreen, shareable offer (anyone can open it).

Next steps

Discounts

Build the promo codes you apply via discount_code and discount.

Subscriptions & billing

Orders, invoices, refunds, and managing recurring revenue after checkout.

Products & pricing

Create the price variants your checkouts and links reference.

Webhooks

React to checkout.created, order.paid, and other events in real time.

​Creating a checkout

​Checkout fields

​Multiple line items

​Paying an invoice

​Worked example: sell to a customer end-to-end

​Reusable checkout links

​Checkout link fields

​Next steps

Discounts

Subscriptions & billing

Products & pricing

Webhooks

Creating a checkout

Checkout fields

Multiple line items

Paying an invoice

Worked example: sell to a customer end-to-end

Reusable checkout links

Checkout link fields

Next steps