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

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

{
  "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