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

# Payment sessions

> Manage hosted payment flows and secure payment collection

Payment Sessions provide secure, hosted payment flows that handle the complete payment collection process. They offer pre-built payment interfaces with comprehensive security, fraud protection, and payment method support for seamless customer payment experiences.

## Payment Session Entity

A payment session in the Connect API represents:

* **Hosted Payment Flow**: Secure, pre-built payment interface managed by the platform
* **Session Management**: Temporary payment collection context with configurable timeout and validation
* **Security Layer**: PCI DSS compliant payment processing with tokenization and fraud detection
* **Integration Bridge**: Seamless connection between your application and payment processing infrastructure

## Key Capabilities

<Columns cols={2}>
  <Card title="Hosted Payment UI" icon="browser">
    Provide secure, branded payment interfaces without handling sensitive
    payment data.
  </Card>

  <Card title="Multiple Payment Methods" icon="layers">
    Support credit cards, digital wallets, bank transfers, and alternative
    payment methods.
  </Card>

  <Card title="Session Security" icon="lock">
    Implement time-limited sessions with automatic expiration and security
    validation.
  </Card>

  <Card title="Real-time Updates" icon="activity">
    Receive instant payment status updates and transaction completion
    notifications.
  </Card>
</Columns>

## Common Use Cases

<Columns cols={2}>
  <Card title="Checkout Integration" icon="shopping-bag">
    Integrate secure payment flows into order completion and service activation
    processes.
  </Card>

  <Card title="Self-Service Payments" icon="user">
    Enable customers to make payments through self-service portals and mobile
    applications.
  </Card>

  <Card title="Balance Management" icon="wallet">
    Provide secure payment options for account balance top-ups and outstanding
    charges.
  </Card>

  <Card title="Mobile Payments" icon="smartphone">
    Deliver optimized payment experiences for mobile devices and applications.
  </Card>
</Columns>

## Related Resources

Payment Session entities coordinate with other Connect API resources:

* **Payments**: Individual payment transactions processed through hosted sessions
* **Payment Profiles**: Customer payment methods stored from successful session completions
* **Orders**: Order-specific payment sessions for checkout and purchase completion
* **Customers**: Customer-specific payment sessions with profile and preference management
* **Subscriptions**: Subscription-related payment collection and recurring payment setup
* **Payment Links**: Shareable payment links generated from payment sessions

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Payment Session" icon="plus" href="/api-reference/payment-sessions/create-payment-session">
    Create a new hosted payment flow
  </Card>

  <Card title="Get Payment Session" icon="eye" href="/api-reference/payment-sessions/get-payment-session">
    Retrieve payment session status and details
  </Card>

  <Card title="Cancel Payment Session" icon="ban" href="/api-reference/payment-sessions/cancel-payment-session">
    Cancel an active payment session
  </Card>
</CardGroup>