Brick API Documentation
Checkout Page

Create Checkout Page Session

Create Checkout Page Session is the API endpoint for creating a hosted Brick Checkout Page payment session. The response returns a Brick-generated checkout identifier and a checkoutUrl that you can present to the customer as a payment link.

Use this endpoint when your system needs to create checkout sessions on demand for web checkout, mobile checkout, invoices, chat-based payment requests, or customer support payment flows.

Request Body

FieldTypeRequiredDescription
externalIdstringYesMerchant-defined unique identifier for the checkout session.
currencystringYesTransaction currency. Use IDR for the current Receive Money flow.
descriptionstringYesCheckout label shown to the customer and used for reconciliation.
amountnumberNoFixed payment amount. If omitted, the checkout may behave as an open-amount flow.
typestringNoPayment type. The tested collection supports qris and virtual_account.

Response Fields

FieldTypeDescription
data.idstringBrick-generated checkout identifier.
data.externalIdstringYour original merchant reference.
data.statusstringInitial checkout status, such as CREATED.
data.checkoutUrlstringHosted page URL to present to the customer.
data.currencystringCurrency code.
data.amountnumber or nullFixed amount if configured.
data.typestringPayment type when explicitly set.
data.createdAtstringISO-8601 session creation timestamp.
data.descriptionstringSession description.
Last modified on