---
title: "Get Checkout Status"
method: GET
path: "/v1/checkout/{id}/status"
tags: ["Checkout"]
---

# Get Checkout Status

`GET /v1/checkout/{id}/status`

Poll checkout status. Returns status "pending" until the user approves on mobile. When status becomes "approved" and later "completed", the orderConfirmation fields will be populated.

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `checkoutRequest` object, required
    - `id` string, required
    - `status` string, required — One of: pending, approved, payment_processing, payment_completed, payment_failed, completed, rejected, expired
    - `orderConfirmation` object, nullable, required
      - `provider` 'stripe_connect' | 'stripe_spt'
      - `sptId` string
      - `paymentIntentId` string
      - `stripePaymentMethodId` string
      - `amount` integer
      - `currency` string
      - `status` string
      - `sptExpiresAt` string
      - `error` string
      - `chargeId` string
      - `paidAt` string
      - `failureMessage` string
      - `failureCode` string
      - `failedAt` string
      - `orderId` string
      - `metadata` object
    - `approvedAt` string, date-time, nullable, required
    - `completedAt` string, date-time, nullable, required
    - `expiresAt` string, date-time, required
    - `sptId` string, nullable — Stripe Payment Token ID. Extracted from orderConfirmation.sptId once the Stripe-based completion path has run. Null on pending / expired / non-Stripe checkouts.
    - `paymentIntentId` string, nullable — Stripe PaymentIntent ID. Read from the checkout row's stripe_payment_intent_id column once a PaymentIntent has been created on the merchant's connected account. Null on pending / SPT-only / non-Stripe checkouts.

## Other responses

- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

---

[API](https://skmtc.net/bkeyid/apis/bkey-api.md) · [All operations](https://skmtc.net/bkeyid/apis/bkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bkeyid/bkey-api/revisions/2c7566abec9e/schema)