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

## Summary

🚀 **Hosted Sessions Listing API**: Added a new read endpoint to list hosted payment sessions for a customer, including idempotency lookup by `client_reference_id`.

## New Features

### Hosted Experience Sessions

* **New endpoint**: `GET /v1/customers/{customer_id}/sessions`
* **Primary idempotent lookup flow**: `GET /v1/customers/{customer_id}/sessions?client_reference_id={ref}`
* **Supports pagination** using `page` and `limit`
* **Response includes** `sessions` and `meta` with pagination fields (`page`, `limit`, `total_records`, `total_pages`)
* Session records include fields such as:
  * `session_id`
  * `client_reference_id`
  * `client_customer_ref`
  * `customer_id`
  * `created_at`
  * `session_expires_at`
  * `latest_status`
  * `has_payment` and `payment_id` (when available)

## Documentation Updates

* Updated the payment reconciliation guide to include a retry recovery pattern:
  * If session creation response is lost or a retry occurs, first query sessions by `client_reference_id` for the same `customer_id` to fetch the existing session and avoid duplicate creation.