Skip to main content

One-Time Orders

List Completed Orders

query($storeId: String!) {
  onetimeOrders(
    storeId: $storeId
    filter: { status: { eq: "completed" } }
    limit: 50
  ) {
    id
    buyerEmail
    currency
    priceSnapshot {
      currency
      subtotal
      taxAmount
      total
      taxCategory
    }
    status
    createdAt
  }
  onetimeOrdersCount(storeId: $storeId)
}
Variables:
{ "storeId": "STO_3bVzrkD0FJjFdZNLk8Ualx" }

Filter by Date Range

query($storeId: String!) {
  onetimeOrders(
    storeId: $storeId
    filter: {
      createdAt: {
        gte: "2026-01-01T00:00:00.000Z"
        lte: "2026-03-31T23:59:59.999Z"
      }
    }
  ) {
    id
    buyerEmail
    status
    createdAt
  }
}

SDK Example

const result = await client.graphql.query<{
  onetimeOrders: Array<{
    id: string;
    buyerEmail: string;
    priceSnapshot: { total: number; currency: string };
    status: string;
  }>;
}>({
  query: `query($storeId: String!) {
    onetimeOrders(storeId: $storeId, filter: { status: { eq: "completed" } }) {
      id buyerEmail priceSnapshot { total currency } status
    }
  }`,
  variables: { storeId: "STO_3bVzrkD0FJjFdZNLk8Ualx" },
});

Subscription Orders

List Active Subscriptions

query($storeId: String!) {
  subscriptionOrders(
    storeId: $storeId
    filter: { status: { in: ["active", "trialing"] } }
  ) {
    id
    buyerEmail
    status
    billingPeriod
    createdAt
  }
  subscriptionOrdersCount(storeId: $storeId)
}

Filter Canceling Subscriptions

query($storeId: String!) {
  subscriptionOrders(
    storeId: $storeId
    filter: { status: { eq: "canceling" } }
  ) {
    id
    buyerEmail
    status
    createdAt
  }
}

Payments

List Successful Payments

query {
  payments(
    filter: { status: { eq: "succeeded" } }
    limit: 100
  ) {
    id
    orderId
    amount
    currency
    status
    refundStatus
    createdAt
  }
  paymentsCount(filter: { status: { eq: "succeeded" } })
}

Filter by Amount Range

query {
  payments(
    filter: {
      amount: { gte: 10000 }
      status: { eq: "succeeded" }
    }
  ) {
    id
    orderId
    amount
    currency
    createdAt
  }
}

Refund Tickets

List All Refund Tickets

query {
  refundTickets {
    id
    paymentId
    status
    requestedAmount
    reason
    createdAt
  }
  refundTicketsCount
}

Filter Pending Refunds

query {
  refundTickets(filter: { status: { eq: "pending" } }) {
    id
    paymentId
    requestedAmount
    reason
    createdAt
  }
}

Refunds for a Specific Payment

query($paymentId: String!) {
  refundTickets(filter: { paymentId: { eq: $paymentId } }) {
    id
    status
    requestedAmount
    reason
    createdAt
  }
}
Variables:
{ "paymentId": "PAY_6eYCunG3IMmIgcQOnaXdoA" }

Checkout Sessions

Query Session Details

query($sessionId: ID!) {
  checkoutSession(id: $sessionId) {
    id
    productType
    currency
    status
    expiresAt
    createdAt
  }
}
Variables:
{ "sessionId": "cs_550e8400-e29b-41d4-a716-446655440000" }