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

# Open Session

> Start a new voucher session — groups multiple vouchers under a single context.

`POST /api/v1/vouchers/sessions/session-open`

A session groups multiple vouchers together for multi-payment flows like split payments or multi-currency checkouts. Each voucher in the session is independent (own code, lifecycle, settlement), but they share the session for tracking and coordination.

## Parameters

### Body

| Name        | Type     | Required | Description                                         |
| ----------- | -------- | -------- | --------------------------------------------------- |
| `code`      | `string` | Yes      | The context code shared by the payer. 6 characters. |
| `type`      | `enum`   | Yes      | Session type — always `SESSION_DEFAULT`             |
| `payeeInfo` | `object` | No       | Additional payee information                        |

## Request example

```shell theme={null}
curl --request POST 'https://payments.bleepay.com/api/v1/vouchers/sessions/session-open' \
  --header 'Authorization: Bearer <payee_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "code": "A1B2C3",
    "type": "SESSION_DEFAULT"
  }'
```

## Response

### Response schema

| Field       | Type     | Description                                |
| ----------- | -------- | ------------------------------------------ |
| `id`        | `string` | Unique session identifier (e.g. `ses_xyz`) |
| `code`      | `string` | Session code                               |
| `status`    | `string` | Session status — `OPEN`                    |
| `type`      | `string` | Session type                               |
| `createdAt` | `string` | ISO 8601 creation timestamp                |

### Example response

```json theme={null}
{
  "id": "ses_xyz",
  "code": "D4E5F6",
  "status": "OPEN",
  "type": "SESSION_DEFAULT",
  "createdAt": "2026-06-09T12:00:00.000Z"
}
```

### Error responses

| Status | Code           | Description                            |
| ------ | -------------- | -------------------------------------- |
| `400`  | `invalid_code` | The context code is invalid or expired |
| `401`  | `unauthorized` | Missing or invalid bearer token        |