Checkout Status

Use this endpoint to retrieve the latest status of a checkout page session.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Use this endpoint to retrieve the latest status of a checkout page session.

You can query by Brick's checkoutId or by your own externalId. Store both values after creating a checkout session so your system can reconcile checkout progress even if a callback is delayed or missed.

When to Use This Endpoint

  • Confirm a checkout session after the customer returns to your application.
  • Reconcile payment status when your callback endpoint was unavailable.
  • Check whether a checkout session is still open, completed, or expired.

Query Parameters

Provide at least one of the following identifiers:

ParameterDescription
checkoutIdBrick-generated checkout identifier returned when the checkout session is created.
externalIdYour own checkout identifier sent when creating the checkout session.

Status Values

StatusMeaning
CREATEDThe checkout session has been created.
OPENEDThe customer has opened the checkout page.
COMPLETEDThe payment has been completed. Payment details are returned in the response when available.
EXPIREDThe checkout session expired before payment was completed.

For the full request and response examples, use the API reference panel on this page.

Query Params
string

Brick-generated checkout identifier returned from POST /v1/payments/checkout.

string

checkout externalId

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain