Assign Order Number and Decide 3D Secure Routing

Assigns the order number that will be sent to Masterpass and evaluates whether the transaction must be processed under 3D Secure.

Fields:

• No fields are required. Submit an empty form body to trigger order number assignment.

Processing:

1. The client IP is captured and stored for the order.

2. The order number is generated.

3. The 3D Secure decision is evaluated using the gateway's POS configuration, the user, the basket total, the resolved card, and the BIN number. The result is stored so that MasterpassCompletePage can route the transaction correctly.

Backward Navigation:

• On backward navigation: the client IP is cleared, the order number is reset, and the 3D Secure routing flag is cleared.

Next Page:

• MasterpassCompletePage

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

object · MasterpassOrderNoPageInputOptional

No input fields are required for this step. Submit an empty form body to trigger order number assignment and 3D Secure routing evaluation.

Responses

200

Order number assigned successfully

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

post/orders/checkout/?page=MasterpassOrderNoPage

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

""

200

Order number assigned successfully

{
  "context_list": [
    {
      "page_name": "MasterpassCompletePage",
      "page_slug": "masterpasscompletepage",
      "page_context": {
        "msisdn": "905551234567",
        "order_no": "ORD-2026-0042",
        "three_d": false,
        "token": "signed-token-abc123",
        "direct_token": "signed-direct-token-xyz789",
        "extras": {
          "user_id": "1042",
          "bank_ica": null,
          "additional_fields": {}
        }
      }
    }
  ],
  "pre_order": {
    "payment_option": {
      "pk": 5,
      "slug": "masterpass",
      "payment_type": "masterpass"
    },
    "number": "ORD-2026-0042",
    "remote_addr": "94.235.240.102",
    "redirect_to_three_d": false
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}