---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Redemption lines can set… Reference for the POST
    /v1/organizations/{orgId}/orders/redemptions endpoint in the Stashtab Vault
    Warehouse API.
sidebar:
  label: Create a held redemption order
  badge: POST
title: Create a held redemption order
type: openapi-operation
---
Redemption lines can set declaredUnitValue.amount in USD per unit. Omitted values keep the product-default behavior. A unit value multiplies by quantity for the line total. Values belong to this order and do not change catalog defaults, sale prices, insurance amounts or delivery confirmation. A changed value requires a fresh review and quote. The same submission key with changed values conflicts. Provider readback must retain the exact declarations without appended catalog defaults. Create a redemption from exact catalog products, recorded conditions and quantities through the shared order-creation module. A deliveryConfirmation request must match the priced shippingQuote selection. Omit the top-level value to carry the selection unchanged. Changed confirmation conflicts with the original intent; it never shortens the hold or permits another uncertain purchase. For cards from a published pack, call previewPackRedemption and use its exact product IDs, conditions and quantities as explicit lines for all or selected cards. The optional pack input uses the returned frozen pack revision and digest and preserves source identities for replay. New redemptions start On hold. The creation receipt carries a server-owned cancellation.deadlineAt exactly one hour after confirmed creation; eligible describes that creation-time fact, and replay never extends the deadline. Preview those products and quantities with orderKind: redemption to validate the exact destination and obtain fulfillmentSource, then quote the same recipient and physical source. Creation independently requires a positive postal result in Test and Live. Pass the exact selected shippingQuote, fulfillmentSource, requestedShippingService and requestedShippingServiceReview unchanged. Vault revalidates the recipient, stock, source, parcel, eligible service and current rates before sending; changed inputs or prices require a fresh quote and selection. Quotes are estimates and do not lock a carrier price or buy a label. An exact submission-key replay returns its original receipt, changed intent conflicts, and an unknown provider result is observed rather than sent again. Current write-capable organization keys may use this customer operation. Vault Test supports explicit configured raw-condition and sealed-item lines using isolated exact stock reservation and synthetic correlation. Exact replay does not reserve again; timely cancellation restores the commitment once. Test release is manual after one hour, and no hosted timer or physical warehouse guarantee is established. Frozen pack creation and exact-slab selections remain unavailable in Vault Test; use explicit lines returned by a configured Test pack preview. The success example illustrates a Live business-mode confirmed order shape. Its legacy TEST adapter label names an unverified external partner correlation only. It does not identify Vault Test mode or the provider environment, prove hosted activation, or establish provider or physical acceptance. The static example is not evidence of a live provider effect. Native protocol authority remains separate.

`POST /v1/organizations/{orgId}/orders/redemptions`

**Request body** (`application/json`, required)

- `deliveryConfirmation` (string)
- `customerLabel` (string | null)
- `fulfillmentSource` (object)
- `lines` (object[])
- `orderKey` (string, required)
- `orderNumber` (string)
- `pack` (object)
- `recipient` (object, required)
- `redemptionReference` (string, required)
- `requestedShippingService` (string)
- `requestedShippingServiceReview` (string)
- `shippingQuote` (object)
- `slabs` (object[]) — Legacy compatibility field. Exact-slab redemption is deferred from the current integration scope; use supported raw-card and sealed-item lines or pack selection.
- `storeLinkId` (string)
- `storeRef` (string)
- `submissionKey` (string, required)
- `visibleOrderNumber` (string)

Request body example:

```json
{
  "customerLabel": "Warehouse demo",
  "lines": [
    {
      "condition": "nm",
      "declaredUnitValue": {
        "amount": "12.50"
      },
      "productId": "product_ready_demo",
      "quantity": 1,
      "sku": "READY-DEMO-SKU"
    }
  ],
  "orderKey": "ready-redemption-demo-1",
  "orderNumber": "RED-DEMO-1",
  "recipient": {
    "city": "Toronto",
    "country": "CA",
    "name": "Taylor Example",
    "postalCode": "M5V 1E3",
    "state": "ON",
    "street1": "1 Example Street"
  },
  "redemptionReference": "ready-redemption-demo-1",
  "submissionKey": "ready-redemption-demo-1"
}
```

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "effects": [
      "order_associated",
      "order_created",
      "order_on_hold",
      "redemption_correlated",
      "redemption_stock_committed"
    ],
    "operationId": "operation_ready_redemption_demo",
    "outcome": "confirmed",
    "adapter": {
      "id": "partner-test-redemption",
      "label": "Partner TEST redemption adapter (isolated, not provider-verified)",
      "providerVerified": false
    },
    "cancellation": {
      "deadlineAt": "2026-10-02T01:00:00.000Z",
      "eligible": true
    },
    "order": {
      "customerLabel": "Warehouse demo",
      "id": "order_ready_redemption_demo",
      "kind": "redemption",
      "receipt": {
        "operationId": "operation_ready_redemption_demo",
        "recordedAt": "2026-10-02T00:00:00.000Z"
      },
      "visibleOrderNumber": "RED-DEMO-1",
      "current": {
        "orderDate": "2026-10-02",
        "providerOrderNumber": "demo-provider-order",
        "recipientName": "Taylor Example",
        "status": "on_hold",
        "tracking": [],
        "customerNotes": null,
        "holdUntilDate": null,
        "items": [
          {
            "declaredUnitValue": "12.5",
            "name": "Ready demo product",
            "quantity": 1,
            "sku": "READY-DEMO-SKU"
          }
        ],
        "recipient": {
          "city": "Toronto",
          "company": null,
          "country": "CA",
          "email": null,
          "name": "Taylor Example",
          "phone": null,
          "postalCode": "M5V 1E3",
          "state": "ON",
          "street1": "1 Example Street",
          "street2": null
        },
        "revision": "demo-revision-1",
        "requestedShippingService": null
      },
      "sourceOrderId": null
    },
    "redemptionReference": "ready-redemption-demo-1",
    "correlationId": "partner-test-ready-redemption-demo-1"
  },
  "meta": {
    "requestId": "example-createRedemptionOrder"
  }
}
```
