Changelog

March 5, 2026

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.