Skip to main content
GET
/
payments
/
sessions
/
{session_id}
curl https://api.khaime.com/api/v1/partner/payments/sessions/sess_a1b2c3d4 \
  -H "X-API-Key: pk_sandbox_your_key"

Documentation Index

Fetch the complete documentation index at: https://docs.khaime.com/llms.txt

Use this file to discover all available pages before exploring further.

Verify Payment

Check the status of a payment session created via Create Session.
For payments created via the Charge API, there is no polling endpoint. Use webhooks to receive real-time payment confirmations instead.

Path Parameters

session_id
string
required
The session_id returned from the Create Session endpoint.

Response

{
  "success": true,
  "data": {
    "session_id": "sess_a1b2c3d4",
    "status": "completed",
    "amount": 5000,
    "currency": "USD",
    "payment_type": "one_time",
    "created_at": "2026-03-28T14:00:00.000Z",
    "completed_at": "2026-03-28T14:02:00.000Z"
  }
}

Payment Statuses

StatusMeaning
completedPayment confirmed
pendingStill processing
expiredSession expired without payment
failedPayment failed

Confirming Charge API Payments

If you used the Charge API instead of sessions, confirm payments via webhooks:
  1. Set your webhook URL via the dashboard or API
  2. Listen for payment.succeeded and payment.failed events
  3. Use the event_id for idempotency
See the Webhooks Best Practices guide for implementation details.
curl https://api.khaime.com/api/v1/partner/payments/sessions/sess_a1b2c3d4 \
  -H "X-API-Key: pk_sandbox_your_key"