Get BKM Express BIN Number Page context

Returns the BKM Express widget credentials needed to render the BKM Express JS widget in the browser. The widget handles card number entry on behalf of BKM.

Preconditions:

• Basket must not be empty

• A valid BKM Express ticket must be present, meaning path, token, and transaction_id must all exist in the pre-order session data (set by BexSelectionPage)

Page Context:

• path: BKM Express API path used to initialise the JS widget

• token: Session token issued by BKM Express

• transaction_id: Unique transaction identifier assigned by BKM Express

These three values are passed directly to the BKM Express JS SDK to render the card entry widget. The widget then sends the card BIN to the server via a separate callback endpoint (/orders/bex-installments/), which eventually results in a POST to this page with the resolved BIN number.

available_for_post_order: true

get

Header parameters

x-requested-withstring · enumRequired

Required header for AJAX requests. Must be set to XMLHttpRequest for all checkout requests.

Default: XMLHttpRequestPossible values:

CookiestringOptional

Session cookie header (e.g. sessionid=abc123 or osessionid=<session_id>)

Responses

200

BKM Express BIN number page context retrieved

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

get/orders/checkout/?page=BexBinNumberPage

GET /orders/checkout/?page=BexBinNumberPage HTTP/1.1
Host: sandbox.akinon.com
x-requested-with: XMLHttpRequest
Accept: */*

200

BKM Express BIN number page context retrieved

{
  "context_list": [
    {
      "page_name": "BexBinNumberPage",
      "page_slug": "bexbinnumberpage",
      "page_context": {
        "path": "/bex/payment/path",
        "token": "bex-session-token-abc123",
        "transaction_id": "TXN-20260401-001"
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "payment_option": {
      "pk": 5,
      "name": "BKM Express",
      "slug": "bkm-express",
      "payment_type": "bkm_express",
      "payment_type_label": "BKM Express"
    },
    "number": "ORD-2026-0001",
    "card_info": null,
    "total_amount": "159.99",
    "currency_type_label": "TRY"
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}