> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# Order Details object

## Attributes

| Attribute        | Type                                         | Description                                            |
| :--------------- | :------------------------------------------- | :----------------------------------------------------- |
| `consumer `      | [Consumer](/consumer-object) `required`      | The consumer who placed or is placing the order.       |
| `billing`        | [Contact](/contact-object)                   | The consumer's billing address.                        |
| `shipping`       | [Contact](/contact-object)                   | The consumer's shipping address.                       |
| `courier`        | [Shipping Courier](/shipping-courier-object) | The consumer's chosen shipping courier.                |
| `items`          | [Item](/item-object)\[]                      | An array of order items.                               |
| `discounts`      | [Discount](/discount-object)\[]              | An array of discounts.                                 |
| `taxAmount`      | [Money](/money-object)                       | The included tax amount, after applying all discounts. |
| `shippingAmount` | [Money](/money-object)                       | The shipping price charged to the consumer.            |

## Example Order Details object

```json
{
  "consumer": {  
    "phoneNumber": "07000000000",
    "givenNames": "Joe",
    "surname": "Consumer",
    "email": "test@example.com"
  },
  "billing": {
    "name": "Joe Consumer",
    "line1": "Apartment 9",
    "line2": "1 Market Street",
    "area1": "Ancoats",
    "area2": "Manchester",
    "region": "Greater Manchester",
    "postcode": "M4 3AT",
    "countryCode": "GB",
    "phoneNumber": "07000000000"
  },
  "shipping": {
    "name": "Joe Consumer",
    "line1": "Apartment 9",
    "line2": "1 Market Street",
    "area1": "Ancoats",
    "area2": "Manchester",
    "region": "Greater Manchester",
    "postcode": "M4 3AT",
    "countryCode": "GB",
    "phoneNumber": "07000000000"
  },
  "courier" : {
    "shippedAt" : "2019-01-01T00:00:00+01:00",
    "name" : "Parcelforce Worldwide",
    "tracking" : "AAAA1234567890",
    "priority" : "STANDARD"
  },
  "items": [  
    {
      "name": "Blue Carabiner",
      "sku": "12341234",
      "quantity": 1,
      "pageUrl": "https://merchant.example.com/carabiner-354193.html",
      "imageUrl": "https://merchant.example.com/carabiner-7378-391453-1.jpg",
      "price": {
        "amount": "40.00",
        "currency": "GBP"
      },
      "categories": [
        ["Sporting Goods", "Climbing Equipment", "Climbing", "Climbing Carabiners"],
        ["Sale", "Climbing"]
      ]
    },
    {
      "name": "LED Lantern",
      "sku": "12346789",
      "quantity": 1,
      "pageUrl": "https://merchant.example.com/lantern-836599.html",
      "imageUrl": "https://merchant.example.com/lantern-3417-983451-1.jpg",
      "price": {
        "amount": "60.00",
        "currency": "GBP"
      },
      "categories": [
        ["Camping & Outdoor", "Lighting", "Lanterns"]
      ]
    }
  ],
  "discounts": [
    {
      "displayName": "10% Off Subtotal",
      "amount": {
        "amount": "10.00",
        "currency": "GBP"
      }
    }
  ],
  "taxAmount": {  
    "amount": "22.00",
    "currency": "GBP"
  },
  "shippingAmount": {  
    "amount": "20.00",
    "currency": "GBP"
  }
}
```