Back to glossary
What is a Payment Session?
A time-limited checkout instance that tracks a single payment from creation to completion.
A payment session is the core object in Zateway's payment flow. It represents a single payment request with a specific amount, token, chain, and expiry time. The session tracks the customer's payment from creation through blockchain confirmation to settlement.
Payment Session Lifecycle
Created → Pending (customer viewing checkout) → Confirming (transaction detected on-chain) → Confirmed (sufficient block confirmations) → Settled (funds in merchant wallet). Sessions can also expire or fail.
Creating Sessions via API
POST /api/v1/sessions with amount, currency, chain, webhookUrl, and optional metadata. The API returns a session ID, checkout URL, and payment address.