> ## Documentation Index
> Fetch the complete documentation index at: https://docs-alpha.pepay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Products

> Product retrieval and offer discovery endpoints.

## Overview

Use product endpoints to:

* fetch full product details for a `productId`
* fetch offers (price + seller + shipping) before checkout

## Authentication

Requires `x-commerce-api-key`.

## Request

Endpoints:

* `GET /api/commerce/products/{productId}`
* `GET /api/commerce/products/{productId}/offers`

Example (offers):

```bash theme={null}
BASE_URL=${PEPAY_API_URL}

curl "$BASE_URL/api/commerce/products/B08N5WRWNW/offers" \
  -H "x-commerce-api-key: ck_..."
```

## Response

Representative offers response:

```json theme={null}
{
  "success": true,
  "data": {
    "productId": "B08N5WRWNW",
    "retailer": "amazon",
    "offers": [
      {
        "offerId": "offer_123",
        "sellerId": "ATVPDKIKX0DER",
        "sellerName": "Amazon.com",
        "price": 99.99,
        "shipping": 0,
        "totalCost": 99.99,
        "prime": true,
        "primeOnly": false,
        "condition": "New",
        "handlingDays": { "min": 0, "max": 2 },
        "international": false,
        "available": true
      }
    ]
  },
  "meta": { "timestamp": 1766320496 }
}
```

Notes:

* Offers must be deliverable within 10 days to be eligible for checkout.

## Errors

* `401` missing/invalid commerce API key
* `404` product not found

## Examples

Use product offers to confirm pricing before you generate a [Checkout invoice](/api-spec/commerce/checkout).
Next: [Checkout](/api-spec/commerce/checkout)