GET
Check payment status

Path Parameters

sessionId
string
required

Checkout session ID (format: cs_xxx)

Example:

"cs_abc123"

Response

Current session status (idle, processing, pending_ussd, success, failed, expired, cancelled)

status
enum<string>

Checkout session lifecycle:

  • idle — Session created, waiting for payment initiation
  • processing — Payment being processed
  • pending_ussd — Waiting for USSD confirmation from payer
  • success — Payment completed
  • failed — Payment failed
  • expired — Session expired
  • cancelled — Session cancelled
Available options:
idle,
processing,
pending_ussd,
success,
failed,
expired,
cancelled
paymentId
string | null
Example:

"pay_xyz789"