Check Payment Status

GET

https://api.inboxkit.com/v1/api/billing/wallet/status

Maintainer:Not configured

Check whether a hosted-checkout or guest-mode payment has been completed and its credits applied. Only relevant for hosted-checkout and guest_mode flows — direct_charge applies credits synchronously in the POST response and does not need polling.

Recommended polling cadence: every 5–10 seconds for up to 15 minutes after the Checkout link is opened, then stop. Checkout sessions expire after 24 hours.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200Success Response

application/json

Current status of the Checkout session. credits_applied: true means the webhook has run and the wallet balance has been updated.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/billing/wallet/status?session_id=cs_test_a1b2c3d4e5f6g7h8...' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "error": false,
    "session_id": "cs_test_a1b2c3d4e5f6g7h8...",
    "payment_status": "paid",
    "amount": 50,
    "currency": "usd",
    "credits_applied": true
}

Modified at 2026-04-23 15:46:03

Get subscription details

Change subscription plan