Brick API Documentation
Checkout Page

Checkout Status

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.

Last modified on