Get checkout status
jami_get_checkout_statusRead-onlyIdempotent
Retrieve the current status of a checkout session by ID once, reconciling with the payment provider so late webhooks don't delay resolution.
Instructions
Check a checkout session once. The server reconciles with the payment provider on every call, so this resolves even when webhooks are late.
Args:
session_id: from jami_create_checkout.
Returns: { session_id, status: 'open' | 'completed' | 'expired', order_id, order_status, amount_minor, amount, expires_at, failure }. When status is 'expired', failure.code explains why: payment_rejected · payment_failed · payment_canceled · payment_timed_out · initiate_failed · session_expired.
Use jami_wait_for_checkout instead if you want to block until the buyer finishes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | Checkout session id returned by jami_create_checkout, e.g. "6710c2e8b1a2f0012ab34cd9" | |
| response_format | No | 'markdown' (default) for a readable summary, 'json' for the full structured payload | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Human-readable amount, e.g. "150.00 ETB" | |
| status | Yes | ||
| failure | Yes | Why the session ended without an order; null unless status is "expired" | |
| order_id | Yes | ||
| expires_at | Yes | ||
| session_id | Yes | ||
| amount_minor | Yes | Integer santim (100 = 1.00 ETB) | |
| order_status | Yes |