Checkout Sessions Overview - Plexos Pay

Checkout Sessions

A Checkout Session creates a hosted payment page with a shareable URL. The customer visits the URL, selects their mobile money operator, enters their phone number, and confirms the payment.

Two Modes

Items mode — Pass a list of line items with quantities and unit prices
Amount mode — Pass a fixed total amount

You must provide either items or amount, but not both.

Expiration

Sessions expire after 30 minutes by default. Use expiresInMinutes (5-1440) to customize.

Endpoints

Method	Path	Description
`POST`	`/v1/checkout/sessions`	Create a session
`GET`	`/v1/checkout/sessions/{id}`	Get a session
`GET`	`/v1/checkout/sessions`	List sessions
`POST`	`/v1/checkout/sessions/{id}/expire`	Expire a session