Submit Card BIN Number for BKM Express

Submits the card BIN number (first 6-8 digits) resolved through the BKM Express widget. The BIN is used to identify the card type and retrieve the available installment options.

Required Fields:

• bin_number: First 6 or 8 digits of the card. Must contain only digits.

BIN Resolution:

• System looks up the BIN in the BinNumber table. If found, the matching card record (bank, card type, installments) is used.

• If no match is found, the system falls back to the default card configuration defined by DEFAULT_CARD_SLUG.

State Update:

• pre_order.card_info is set to a CardInfo object containing bin_number and the resolved card record.

Next Pages:

• BexInstallmentSelectionPage

available_for_post_order: true

post

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>)

Body

bin_numberstringRequired

First 6 or 8 digits of the card (BIN - Bank Identification Number). Used to identify the card type and available installment options for BKM Express. Must contain only digits.

Example: 542119Pattern: ^\d{6,8}$

Responses

200

BIN number submitted successfully

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

post/orders/checkout/?page=BexBinNumberPage

POST /orders/checkout/?page=BexBinNumberPage HTTP/1.1
Host: sandbox.akinon.com
x-requested-with: XMLHttpRequest
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 23

"bin_number='542119'"

200

BIN number submitted successfully

{
  "context_list": [
    {
      "page_name": "BexInstallmentSelectionPage",
      "page_slug": "bexinstallmentselectionpage",
      "page_context": {
        "installments": [
          {
            "pk": 1,
            "installment_count": 1,
            "label": "Single Payment",
            "price_with_accrued_interest": "159.99",
            "monthly_price_with_accrued_interest": "159.99"
          },
          {
            "pk": 2,
            "installment_count": 3,
            "label": "3 Installments",
            "price_with_accrued_interest": "165.59",
            "monthly_price_with_accrued_interest": "55.20"
          }
        ],
        "card_type": {
          "name": "Visa",
          "slug": "visa",
          "logo": "https://cdn.akinon.com/logos/visa.png"
        },
        "installment_messages": []
      }
    }
  ],
  "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": {
      "bin_number": "542119",
      "card": {
        "pk": 1,
        "name": "Visa"
      }
    },
    "installment": null,
    "total_amount": "159.99",
    "currency_type_label": "TRY"
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}