Assign raw card to basket

Assigns a raw credit/debit card number to a basket and returns eligible promotion activations. Functionally identical to POST /preorder/card/.

Flow:

1. Extracts BIN-6 from the card number (first 6 digits).

2. Checks whether any active promotions include that BIN for the given currency.

3. If no match: clears existing PreOrder/PreOrderCall for this basket, returns [].

4. Calls TapPay to tokenise the card and retrieve its fingerprint.

5. Creates or updates the PreOrder record (basket ↔ tokenized card mapping).

6. Deletes and recreates PreOrderCall records for each matching promotion.

7. Returns one {basket_offer_id, session_code} entry per matching BasketOffer ID.

Constraint: Card number must be 15 or 16 digits.

post

Body

application/json

card_numberstringRequired

Raw card number. Must be exactly 15 or 16 digits.

Example: 5123456789012345

basket_idintegerRequired

Omnitron basket ID

Example: 12345

basket_modified_datestring · date-timeRequired

Last modification timestamp of the basket (ISO 8601)

Example: 2025-06-26T10:30:00Z

currencystring · enumOptional

ISO 4217 currency codes supported by Bankaci

Example: aedPossible values:

Responses

200

Eligible promotion activations

application/json

422

Validation error

application/json

post/preorder/

HTTPcURLJavaScriptPython

POST /api/v1/preorder/ HTTP/1.1
Host: your-bankaci-instance.example.com
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "card_number": "5123456789012345",
  "basket_id": 12345,
  "basket_modified_date": "2025-06-26T10:30:00Z",
  "currency": "aed"
}

{
  "basket_offers": [
    {
      "basket_offer_id": 123,
      "session_code": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    {
      "basket_offer_id": 456,
      "session_code": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ]
}