GET
/
checkout
/
sessions
/
{sessionId}
/
status
Check payment status
curl --request GET \
  --url https://api.simiz.io/v1/checkout/sessions/{sessionId}/status
{
  "paymentId": "pay_xyz789"
}

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"