type: object
description: |
    Links a Beyond-only Shopify order to a separate Lens-Insert-only Shopify order
    for the same customer. Once paired, the fabricator pipeline treats the two as
    a single shipment.

    Created via `POST /admin/shop/shopify_orders/pair`. The pairing is created from
    order **names** (`#1234`), not ids — both orders must belong to the same
    Shopify customer and have the expected line-item composition.
required: [id, beyondShopifyOrderId, lensOnlyShopifyOrderId, beyondShopifyOrderName, lensOnlyShopifyOrderName]
properties:
    id: { type: string, description: Pair record id. }
    createdAt: { type: string, format: date-time }
    beyondShopifyOrderId:
        type: string
        description: Numeric Shopify id of the Beyond-only order.
    beyondShopifyOrderName:
        type: string
        description: "Shopify name of the Beyond-only order (e.g. `#1234`)."
    lensOnlyShopifyOrderId:
        type: string
        description: Numeric Shopify id of the Lens-Insert-only order.
    lensOnlyShopifyOrderName:
        type: string
        description: Shopify name of the Lens-Insert-only order.
    shopifyCustomerId:
        type: string
        description: Shopify customer id shared by both orders.
    creatorBigscreenAccountId:
        type: string
        description: Account that created the pair record.
example:
    id: "01HZA3M5K8XYZ7P9QRSTUVWXYZ"
    createdAt: "2026-04-22T10:14:00.000Z"
    beyondShopifyOrderId: "6107853586649"
    beyondShopifyOrderName: "#10042"
    lensOnlyShopifyOrderId: "6107853659483"
    lensOnlyShopifyOrderName: "#10043"
    shopifyCustomerId: "7421003628825"
    creatorBigscreenAccountId: "acct_01HXJ4Q12345"
