Orders

Orders represent one-time purchases in RevKeen. When a customer buys a product with a one-time price (not recurring), an Order is created to track the purchase and its fulfillment status.

What is an Order?

An Order is created when a customer completes a checkout for one-time products. Orders differ from subscriptions in that they represent a single transaction rather than ongoing billing.

Order vs Subscription

Order Statuses

Order Line Items

Each order contains one or more line items representing products purchased:

Fulfillment Tracking

Fulfillment tracking depends on the product's fulfillment_type:

Creating Orders via API

const order = await client.orders.create({
  customerId: 'cus_xxxxxxxx',
  currency: 'USD',

  lineItems: [
    {
      priceId: 'price_xxxxxxxx',
      quantity: 2,
    },
    {
      priceId: 'price_yyyyyyyy',
      quantity: 1,
    },
  ],

  // Optional: Apply a discount
  discountId: 'disc_xxxxxxxx',

  // Optional: Shipping address (for physical products)
  shippingAddress: {
    line1: '123 Main St',
    city: 'San Francisco',
    state: 'CA',
    postalCode: '94102',
    country: 'US',
  },
});

console.log(order.data.id); // ord_xxxxxxxx

Managing Orders in Dashboard

Navigate to Sales → Orders to:

• View all orders with filtering by status, date, customer
• Click an order to view details and line items
• Update fulfillment status for physical products
• Add tracking information for shipments
• Process refunds for paid orders
• Cancel pending orders

Order Events

Orders trigger events throughout their lifecycle that you can listen for via webhooks:

Related