Checkout Pages

Individual checkout page endpoints. Each page represents a step in the checkout flow.

Get current checkout state

get

Returns the current checkout state and determines which page should be displayed. The response includes a list of completed pages and the current page context.

If the page query parameter is provided, it forces the display of that specific page. Otherwise, the system automatically determines the appropriate page based on checkout progress.

Query parameters

pagestring · enumOptional

Optional page name to force display a specific page

Possible values:

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

Checkout state retrieved

application/json

302

Redirect to basket (empty basket) or login (guest purchase not allowed)

404

Basket not found

get

/orders/checkout/

HTTPcURLJavaScriptPython

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

{
  "context_list": [
    {
      "page_name": "IndexPage",
      "page_slug": "indexpage",
      "page_context": {
        "is_user_logged_in": false,
        "can_guest_purchase": true,
        "has_gift_box": false
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "user_email": null,
    "shipping_address": null,
    "billing_address": null
  },
  "errors": [],
  "template_name": "orders/index.html"
}

Process checkout step

post

Processes form submission for the current checkout step. The page parameter determines which page's data is being submitted.

Processing Flow:

1. Validates preconditions for the specified page

2. Validates submitted data according to page-specific rules

3. Updates pre-order state if validation succeeds

4. Recalculates campaigns and discounts

5. Determines next page and returns updated checkout state

Error Handling:

• Validation errors are returned in the errors object

• User remains on the current page when errors occur

• Previously entered valid data is preserved

Query parameters

pagestring · enumRequired

Page name to process (e.g., "IndexPage", "AddressSelectionPage")

Possible values:

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

application/x-www-form-urlencoded

or

or

or

or

or

or

or

or

Responses

200

Step processed successfully

application/json

302

Redirect to basket (empty basket)

post

/orders/checkout/

HTTPcURLJavaScriptPython

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

"user_email='[email protected]'&phone_number='text'"

{
  "context_list": [
    {
      "page_name": "DeliveryOptionSelectionPage",
      "page_slug": "deliveryoptionselectionpage",
      "page_context": {
        "delivery_options": [
          {
            "pk": 1,
            "name": "Home Delivery",
            "delivery_option_type": "customer"
          }
        ]
      }
    }
  ],
  "pre_order": {
    "user_email": "[email protected]",
    "phone_number": "[phone]"
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Index Page context

get

Returns the context for the Index Page, which collects user email and optional phone number. This page is skipped for authenticated users.

Preconditions:

• Basket must not be empty

• If CAN_GUEST_PURCHASE is false, user must be authenticated

Skip Conditions:

• Page is skipped if user is already logged in

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

Index page context retrieved

application/json

get

/orders/checkout/?page=IndexPage

HTTPcURLJavaScriptPython

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

200

Index page context retrieved

{
  "context_list": [
    {
      "page_name": "IndexPage",
      "page_slug": "indexpage",
      "page_context": {
        "is_user_logged_in": false,
        "can_guest_purchase": true,
        "has_gift_box": false
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "user_email": null,
    "phone_number": null
  },
  "errors": [],
  "template_name": "orders/index.html"
}

Submit Index Page (email and phone)

post

Submits user email and optional phone number for guest checkout. After successful submission, the system routes to the next appropriate page.

Configuration:

• CAN_GUEST_PURCHASE: Controls whether guest checkout is allowed. If false, user must be authenticated.

• USER_PHONE_FORMAT: Phone number format used for display hints and validation guidance (default: "05999999999")

Next Pages (determined dynamically):

• If multiple delivery options exist: DeliveryOptionSelectionPage

• If scheduled delivery is active: SlotSelectionPage

• Otherwise: AddressSelectionPage

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

application/x-www-form-urlencoded

user_emailstring · emailRequired

User email address. Required for guest checkout.

phone_numberstringOptional

Optional phone number. Must match phone regex pattern if provided.

Responses

200

Email submitted successfully

application/json

post

/orders/checkout/?page=IndexPage

HTTPcURLJavaScriptPython

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

"user_email='[email protected]'&phone_number='[phone]'"

With phone numberWithout phone number

200

Email submitted successfully

{
  "context_list": [
    {
      "page_name": "DeliveryOptionSelectionPage",
      "page_slug": "deliveryoptionselectionpage",
      "page_context": {
        "delivery_options": [
          {
            "pk": 1,
            "name": "Home Delivery",
            "delivery_option_type": "customer",
            "is_active": true
          }
        ]
      }
    }
  ],
  "pre_order": {
    "user_email": "[email protected]",
    "phone_number": "[phone]"
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Delivery Option Selection Page context

get

Returns available delivery options for selection. This page is automatically skipped if only one active delivery option exists.

Preconditions:

• User email must be set

• Basket must not be empty

Skip Conditions:

• Page is skipped if only one active delivery option exists

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

Delivery options retrieved

application/json

get

/orders/checkout/?page=DeliveryOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Delivery options retrieved

{
  "context_list": [
    {
      "page_name": "DeliveryOptionSelectionPage",
      "page_slug": "deliveryoptionselectionpage",
      "page_context": {
        "delivery_options": [
          {
            "pk": 1,
            "name": "Home Delivery",
            "delivery_option_type": "customer",
            "is_active": true
          },
          {
            "pk": 2,
            "name": "Store Pickup",
            "delivery_option_type": "retail_store",
            "is_active": true
          },
          {
            "pk": 3,
            "name": "Pickup Location",
            "delivery_option_type": "pickup_location",
            "is_active": true
          }
        ]
      }
    }
  ],
  "pre_order": {
    "user_email": "[email protected]",
    "delivery_option": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Set Delivery Option

post

Sets the selected delivery option to the current pre-order.

Configuration:

• CHECKOUT_DELIVERY_OPTION_SELECTION_PAGE: Determines which delivery option selection page is used. Can be set to DeliveryOptionSelectionPage or RemoteDeliveryOptionSelectionPage.

Next Pages (based on selected delivery option):

• If scheduled delivery is active: SlotSelectionPage

• If pickup location selected: PickupLocationSelectionPage

• If retail store selected: RetailStoreSelectionPage

• Otherwise: AddressSelectionPage

Cascading Invalidation:

• Changing delivery option with clear=true resets shipping and billing addresses

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

application/x-www-form-urlencoded

delivery_optionintegerRequired

Primary key of the selected delivery option

clearbooleanOptional

If true, clears shipping and billing addresses when changing delivery option

Default: false

Responses

200

Delivery option set successfully

application/json

post

/orders/checkout/?page=DeliveryOptionSelectionPage

HTTPcURLJavaScriptPython

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

"delivery_option=1&clear=false"

Customer delivery optionRetail store with address clear

200

Delivery option set successfully

{
  "context_list": [
    {
      "page_name": "AddressSelectionPage",
      "page_slug": "addressselectionpage",
      "page_context": {
        "addresses": [],
        "country": {
          "pk": 1,
          "code": "US",
          "name": "United States"
        }
      }
    }
  ],
  "pre_order": {
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "delivery_option_type": "customer"
    }
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Remote Delivery Option Selection Page context

get

Returns available delivery options fetched from a remote service. Extends DeliveryOptionSelectionPage to use RemoteDeliveryOptionService.

Configuration:

• Requires REMOTE_DELIVERY_OPTION_PROVIDER dynamic setting to be configured

• The provider fetches delivery options from an external service based on the configuration

• Used when CHECKOUT_DELIVERY_OPTION_SELECTION_PAGE is set to RemoteDeliveryOptionSelectionPage

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

Remote delivery options retrieved

application/json

get

/orders/checkout/?page=RemoteDeliveryOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Remote delivery options retrieved

{
  "context_list": [
    {
      "page_name": "RemoteDeliveryOptionSelectionPage",
      "page_slug": "remotedeliveryoptionselectionpage",
      "page_context": {
        "delivery_options": [
          {
            "pk": 10,
            "name": "Express Delivery",
            "delivery_option_type": "customer",
            "is_active": true
          }
        ]
      }
    }
  ],
  "pre_order": {
    "user_email": "[email protected]",
    "delivery_option": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Set Remote Delivery Option

post

Sets the selected remote delivery option. Validates that the selected option is available from the remote service.

Configuration:

• Requires REMOTE_DELIVERY_OPTION_PROVIDER dynamic setting to be configured

• The provider fetches delivery options from an external service based on the configuration

• Used when CHECKOUT_DELIVERY_OPTION_SELECTION_PAGE is set to RemoteDeliveryOptionSelectionPage

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

application/x-www-form-urlencoded

delivery_optionintegerRequired

Primary key of the selected delivery option

clearbooleanOptional

If true, clears shipping and billing addresses when changing delivery option

Default: false

Responses

200

Remote delivery option set successfully

application/json

post

/orders/checkout/?page=RemoteDeliveryOptionSelectionPage

HTTPcURLJavaScriptPython

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

"delivery_option=1&clear=false"

200

Remote delivery option set successfully

{
  "context_list": [
    {
      "page_name": "text",
      "page_slug": "text",
      "page_context": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 1,
      "total_amount": "text"
    },
    "shipping_address": {
      "pk": 1,
      "email": "text",
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "code": "text",
        "name": "text"
      },
      "city": {
        "pk": 1,
        "name": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "district": {
        "pk": 1,
        "name": "text"
      },
      "postcode": "text",
      "notes": "text",
      "company_name": "text",
      "tax_office": "text",
      "tax_no": "text",
      "e_bill_taxpayer": true,
      "is_corporate": true,
      "primary": true,
      "identity_number": "text"
    },
    "billing_address": {
      "pk": 1,
      "email": "text",
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "code": "text",
        "name": "text"
      },
      "city": {
        "pk": 1,
        "name": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "district": {
        "pk": 1,
        "name": "text"
      },
      "postcode": "text",
      "notes": "text",
      "company_name": "text",
      "tax_office": "text",
      "tax_no": "text",
      "e_bill_taxpayer": true,
      "is_corporate": true,
      "primary": true,
      "identity_number": "text"
    },
    "shipping_option": {
      "pk": 1,
      "name": "text",
      "slug": "text",
      "logo": "https://example.com",
      "shipping_amount": "text",
      "description": "text",
      "kwargs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "billing_and_shipping_same": true,
    "payment_option": {
      "pk": 1,
      "name": "text",
      "slug": "text",
      "payment_type": "credit_card",
      "payment_type_label": "text"
    },
    "notifications": [
      {}
    ],
    "shipping_amount": "text",
    "total_amount": "text",
    "unpaid_amount": "text",
    "loyalty_money": "text",
    "currency_type_label": "text",
    "installment": {
      "pk": 1,
      "installment_count": 1,
      "label": "text",
      "price_with_accrued_interest": "text",
      "monthly_price_with_accrued_interest": "text"
    },
    "redirect_to_three_d": true,
    "delivery_option": {
      "pk": 1,
      "name": "text",
      "delivery_option_type": "customer",
      "is_active": true
    },
    "retail_store": {
      "pk": 1,
      "name": "text",
      "erp_code": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "click_and_collect": true,
      "is_active": true
    },
    "payment_choice": {
      "value": "text",
      "label": "text",
      "price": "text"
    },
    "user_email": "text",
    "phone_number": "text",
    "user_phone_number": "text",
    "gift_box": {
      "note": "text",
      "gift_video": true,
      "gift_video_notification_sent": true,
      "price": "text"
    },
    "delivery_range": {
      "lower": "2026-01-19T18:36:23.856Z",
      "upper": "2026-01-19T18:36:23.856Z"
    },
    "total_amount_with_interest": "text",
    "is_guest": true,
    "is_post_order": true,
    "data_source_shipping_options": [
      {
        "pk": 1,
        "shipping_amount": "text",
        "shipping_option_name": "text",
        "shipping_option_logo": "https://example.com",
        "data_source": {
          "pk": 1,
          "title": "text"
        },
        "description": "text"
      }
    ],
    "attribute_based_shipping_options": [
      {
        "pk": 1,
        "shipping_option_name": "text",
        "shipping_option_logo": "https://example.com",
        "shipping_amount": "text",
        "product_ids": [
          1
        ],
        "attribute_value": "text",
        "attribute_key": [
          "text"
        ]
      }
    ]
  },
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "template_name": "text"
}

Get Address Selection Page context

get

Returns available addresses for selection (billing and shipping). Supports both authenticated users (shows saved addresses) and anonymous users (shows addresses stored in session).

Preconditions:

• User email must be set

• Delivery option must be selected and must be customer type (is_customer())

• Basket must not be empty

Address Sources:

• Authenticated users: Addresses from their account, ordered by primary status and modification date

• Anonymous users: Addresses stored in session via AnonymousUserAddressService

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

Address selection page context retrieved

application/json

get

/orders/checkout/?page=AddressSelectionPage

HTTPcURLJavaScriptPython

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

200

Address selection page context retrieved

{
  "context_list": [
    {
      "page_name": "AddressSelectionPage",
      "page_slug": "addressselectionpage",
      "page_context": {
        "addresses": [
          {
            "pk": 10,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone_number": "[phone]",
            "line": "123 Main St",
            "country": {
              "pk": 1,
              "code": "US",
              "name": "United States"
            },
            "city": {
              "pk": 1,
              "name": "New York"
            },
            "township": {
              "pk": 1,
              "name": "Manhattan"
            },
            "primary": true
          },
          {
            "pk": 11,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone_number": "[phone]",
            "line": "456 Oak Ave",
            "country": {
              "pk": 1,
              "code": "US",
              "name": "United States"
            },
            "city": {
              "pk": 1,
              "name": "New York"
            },
            "township": {
              "pk": 2,
              "name": "Brooklyn"
            },
            "primary": false
          }
        ],
        "country": {
          "pk": 1,
          "code": "US",
          "name": "United States"
        }
      }
    }
  ],
  "pre_order": {
    "user_email": "[email protected]",
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "delivery_option_type": "customer"
    },
    "shipping_address": null,
    "billing_address": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Send User's Billing and Shipping Addresses

post

Sets the billing and shipping addresses for the order.

Configuration:

• REMOTE_PRICE_ATTRIBUTE_KEY: Product attribute key (default: "has_remote_price") that indicates a product requires remote price calculation. If any basket item has this attribute set to "true", the checkout flow routes to RemotePriceCalculationPage after address selection.

• IDENTITY_NUMBER_REQUIRED_AMOUNT: Order amount threshold that requires identity number validation. If set and order total (with interest) exceeds this amount, shipping address must have identity_number field populated, otherwise validation fails.

• DEFAULT_COUNTRY_CODE: Default country code used to populate country field in address contexts.

Remote Price Detection:

• Checks if any basket item has REMOTE_PRICE_ATTRIBUTE_KEY attribute set to "true"

• If detected, routes to RemotePriceCalculationPage next

Next Pages:

• If remote price calculation needed: RemotePriceCalculationPage

• Otherwise: Shipping option selection page

Validation:

• If IDENTITY_NUMBER_REQUIRED_AMOUNT is set and order total exceeds threshold, shipping address must have identity_number populated

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

application/x-www-form-urlencoded

billing_addressintegerRequired

Primary key of the billing address

shipping_addressintegerRequired

Primary key of the shipping address

Responses

200

Addresses set successfully

application/json

post

/orders/checkout/?page=AddressSelectionPage

HTTPcURLJavaScriptPython

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

"billing_address=10&shipping_address=10"

Same billing and shipping addressDifferent billing and shipping addresses

200

Addresses set successfully

{
  "context_list": [
    {
      "page_name": "ShippingOptionSelectionPage",
      "page_slug": "shippingoptionselectionpage",
      "page_context": {
        "shipping_options": [
          {
            "pk": 1,
            "name": "Standard Shipping"
          }
        ]
      }
    }
  ],
  "pre_order": {
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_address": {
      "pk": 10
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery"
    }
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Retail Store Selection Page context

get

Returns available retail stores for click-and-collect orders. Only displayed when delivery option type is retail store.

Preconditions:

• Delivery option must be selected and must be retail store type (is_retail_store())

• Basket must not be empty

Retail Store Filtering:

• If CHECKOUT_LIST_RETAIL_STORES is False, no stores are listed

• If CHECKOUT_RETAIL_STORE_FILTERS.by_stock is True, only stores with available stock for basket items are shown

• Otherwise, all active retail stores with click_and_collect=True are displayed

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

Retail store selection page context retrieved

application/json

get

/orders/checkout/?page=RetailStoreSelectionPage

HTTPcURLJavaScriptPython

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

200

Retail store selection page context retrieved

{
  "context_list": [
    {
      "page_name": "RetailStoreSelectionPage",
      "page_slug": "retailstoreselectionpage",
      "page_context": {
        "addresses": [
          {
            "pk": 10,
            "first_name": "John",
            "last_name": "Doe"
          }
        ],
        "retail_stores": [
          {
            "pk": 5,
            "name": "Downtown Store",
            "erp_code": "STORE001",
            "click_and_collect": true,
            "is_active": true,
            "township": {
              "pk": 1,
              "name": "Manhattan"
            }
          },
          {
            "pk": 6,
            "name": "Uptown Store",
            "erp_code": "STORE002",
            "click_and_collect": true,
            "is_active": true,
            "township": {
              "pk": 2,
              "name": "Brooklyn"
            }
          }
        ],
        "country": {
          "pk": 1,
          "code": "US",
          "name": "United States"
        }
      }
    }
  ],
  "pre_order": {
    "delivery_option": {
      "pk": 2,
      "name": "Store Pickup",
      "delivery_option_type": "retail_store"
    },
    "billing_address": {
      "pk": 10
    },
    "shipping_address": null,
    "retail_store": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Retail Store

post

Sets the selected retail store for click-and-collect order.

Configuration:

• CHECKOUT_LIST_RETAIL_STORES: Controls whether retail stores are listed (static setting, default: True). When False, no stores are fetched or displayed.

• CHECKOUT_RETAIL_STORE_FILTERS: Filtering options for retail stores (default: {"by_stock": false}). When by_stock is true, only retail stores with available stock for basket items are shown. When false, all active retail stores with click_and_collect=True are displayed.

• DEFAULT_COUNTRY_CODE: Default country code used to populate country field in address contexts.

Address Handling:

• Creates a RetailStoreAddress object from the selected retail store

• Uses billing address details (first name, last name) and user email

• Sets billing_and_shipping_same to false

Next Pages:

• Shipping option selection page

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

application/x-www-form-urlencoded

billing_addressintegerRequired

Primary key of the billing address

retail_storeintegerRequired

Primary key of the selected retail store

Responses

200

Retail store selected successfully

application/json

post

/orders/checkout/?page=RetailStoreSelectionPage

HTTPcURLJavaScriptPython

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

"billing_address=10&retail_store=5"

200

Retail store selected successfully

{
  "context_list": [
    {
      "page_name": "ShippingOptionSelectionPage",
      "page_slug": "shippingoptionselectionpage",
      "page_context": {
        "shipping_options": []
      }
    }
  ],
  "pre_order": {
    "retail_store": {
      "pk": 5,
      "name": "Downtown Store"
    },
    "billing_address": {
      "pk": 10
    },
    "shipping_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]"
    },
    "billing_and_shipping_same": false
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Pickup Location Selection Page context

get

Returns context for pickup location selection. Only displayed when delivery option type is pickup location.

Preconditions:

• Delivery option must be selected and must be pickup location type (is_pickup_location())

• Basket must not be empty

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

Pickup location selection page context retrieved

application/json

get

/orders/checkout/?page=PickupLocationSelectionPage

HTTPcURLJavaScriptPython

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

200

Pickup location selection page context retrieved

{
  "context_list": [
    {
      "page_name": "PickupLocationSelectionPage",
      "page_slug": "pickuplocationselectionpage",
      "page_context": {
        "addresses": [
          {
            "pk": 10,
            "first_name": "John",
            "last_name": "Doe"
          }
        ],
        "country": {
          "pk": 1,
          "code": "US",
          "name": "United States"
        }
      }
    }
  ],
  "pre_order": {
    "delivery_option": {
      "pk": 3,
      "name": "Pickup Location",
      "delivery_option_type": "pickup_location"
    },
    "billing_address": {
      "pk": 10
    },
    "shipping_address": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Pickup Location

post

Sets the selected pickup location for the order.

Configuration:

• DEFAULT_COUNTRY_CODE: Default country code used to populate country field in address contexts.

Pickup Location Handling:

• Uses PickupLocationService to fetch location by remote_id

• Creates a PickupLocationAddress object

• Validates that the remote location exists

Next Pages:

• Shipping option selection page

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

application/x-www-form-urlencoded

remote_idstringRequired

Remote identifier for the pickup location

billing_addressintegerRequired

Primary key of the billing address

Responses

200

Pickup location selected successfully

application/json

post

/orders/checkout/?page=PickupLocationSelectionPage

HTTPcURLJavaScriptPython

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

"remote_id='LOC123'&billing_address=10"

200

Pickup location selected successfully

{
  "context_list": [
    {
      "page_name": "ShippingOptionSelectionPage",
      "page_slug": "shippingoptionselectionpage",
      "page_context": {
        "shipping_options": []
      }
    }
  ],
  "pre_order": {
    "billing_address": {
      "pk": 10
    },
    "shipping_address": {
      "remote_id": "LOC123",
      "address_type": "pickup_location"
    },
    "billing_and_shipping_same": false
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Address Clear Page context

get

A utility page that clears all address-related data from the pre-order. Used internally to reset checkout state. Does not require user interaction.

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

Address clear page context

application/json

get

/orders/checkout/?page=AddressClearPage

HTTPcURLJavaScriptPython

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

200

Address clear page context

{
  "context_list": [
    {
      "page_name": "text",
      "page_slug": "text",
      "page_context": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 1,
      "total_amount": "text"
    },
    "shipping_address": {
      "pk": 1,
      "email": "text",
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "code": "text",
        "name": "text"
      },
      "city": {
        "pk": 1,
        "name": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "district": {
        "pk": 1,
        "name": "text"
      },
      "postcode": "text",
      "notes": "text",
      "company_name": "text",
      "tax_office": "text",
      "tax_no": "text",
      "e_bill_taxpayer": true,
      "is_corporate": true,
      "primary": true,
      "identity_number": "text"
    },
    "billing_address": {
      "pk": 1,
      "email": "text",
      "phone_number": "text",
      "first_name": "text",
      "last_name": "text",
      "country": {
        "pk": 1,
        "code": "text",
        "name": "text"
      },
      "city": {
        "pk": 1,
        "name": "text"
      },
      "line": "text",
      "title": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "district": {
        "pk": 1,
        "name": "text"
      },
      "postcode": "text",
      "notes": "text",
      "company_name": "text",
      "tax_office": "text",
      "tax_no": "text",
      "e_bill_taxpayer": true,
      "is_corporate": true,
      "primary": true,
      "identity_number": "text"
    },
    "shipping_option": {
      "pk": 1,
      "name": "text",
      "slug": "text",
      "logo": "https://example.com",
      "shipping_amount": "text",
      "description": "text",
      "kwargs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "billing_and_shipping_same": true,
    "payment_option": {
      "pk": 1,
      "name": "text",
      "slug": "text",
      "payment_type": "credit_card",
      "payment_type_label": "text"
    },
    "notifications": [
      {}
    ],
    "shipping_amount": "text",
    "total_amount": "text",
    "unpaid_amount": "text",
    "loyalty_money": "text",
    "currency_type_label": "text",
    "installment": {
      "pk": 1,
      "installment_count": 1,
      "label": "text",
      "price_with_accrued_interest": "text",
      "monthly_price_with_accrued_interest": "text"
    },
    "redirect_to_three_d": true,
    "delivery_option": {
      "pk": 1,
      "name": "text",
      "delivery_option_type": "customer",
      "is_active": true
    },
    "retail_store": {
      "pk": 1,
      "name": "text",
      "erp_code": "text",
      "township": {
        "pk": 1,
        "name": "text"
      },
      "click_and_collect": true,
      "is_active": true
    },
    "payment_choice": {
      "value": "text",
      "label": "text",
      "price": "text"
    },
    "user_email": "text",
    "phone_number": "text",
    "user_phone_number": "text",
    "gift_box": {
      "note": "text",
      "gift_video": true,
      "gift_video_notification_sent": true,
      "price": "text"
    },
    "delivery_range": {
      "lower": "2026-01-19T18:36:23.856Z",
      "upper": "2026-01-19T18:36:23.856Z"
    },
    "total_amount_with_interest": "text",
    "is_guest": true,
    "is_post_order": true,
    "data_source_shipping_options": [
      {
        "pk": 1,
        "shipping_amount": "text",
        "shipping_option_name": "text",
        "shipping_option_logo": "https://example.com",
        "data_source": {
          "pk": 1,
          "title": "text"
        },
        "description": "text"
      }
    ],
    "attribute_based_shipping_options": [
      {
        "pk": 1,
        "shipping_option_name": "text",
        "shipping_option_logo": "https://example.com",
        "shipping_amount": "text",
        "product_ids": [
          1
        ],
        "attribute_value": "text",
        "attribute_key": [
          "text"
        ]
      }
    ]
  },
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "template_name": "text"
}

Clear Address Data

post

Clears shipping address, billing address, billing_and_shipping_same, and retail_store from the pre-order. Routes to EmptyPage after completion.

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

Address data cleared successfully

application/json

post

/orders/checkout/?page=AddressClearPage

HTTPcURLJavaScriptPython

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

200

Address data cleared successfully

{
  "context_list": [],
  "pre_order": {
    "shipping_address": null,
    "billing_address": null,
    "retail_store": null,
    "billing_and_shipping_same": null
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Shipping Option Selection Page context

get

Returns available shipping options for the selected shipping address. This is the default shipping option selection page when CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE dynamic setting is set to ShippingOptionSelectionPage (default).

Preconditions:

• Shipping address must be selected (check_address_selected)

• Basket must not be empty

Shipping Option Rules: Shipping options are filtered based on configured rules that determine availability. Each shipping option can have multiple rules attached, and all rules must pass for the option to be available.

• Rules are evaluated against the current checkout context (basket, address, user, etc.)

• Common rule types include:

  • Geographic rules: Filter by country, city, township, or district

  • Basket rules: Filter by basket total amount, item count, or weight

  • Product rules: Filter by product attributes, categories, or data sources

  • User rules: Filter by user segment, membership status, or order history

  • Time-based rules: Filter by day of week, time windows, or date ranges

• If no rules pass for any shipping option, checkout cannot proceed

• Rule configurations are managed through the admin interface

Shipping Amount Calculators: Each shipping option has a configured calculator that determines the shipping cost dynamically.

• Calculator Types:

  • FreeShippingCalculator: Always returns zero shipping cost

  • FixedPriceCalculator: Returns a fixed shipping amount configured on the shipping option

  • WeightBasedCalculator: Calculates cost based on total basket weight and configured weight tiers

  • PriceBasedCalculator: Calculates cost based on basket total amount and configured price tiers

  • QuantityBasedCalculator: Calculates cost based on total item quantity in basket

  • RemoteCalculator: Fetches shipping cost from an external service/API

  • DataSourceCalculator: Calculates cost per data source (vendor/supplier)

• Calculators receive basket contents, shipping address, and currency as input

• Calculator results are cached per request for performance

• Custom calculators can be implemented by extending the base calculator class

Auto-selection:

• If AUTOSELECT_SHIPPING setting is True and only one shipping option is available, it is automatically selected and the page is skipped

Configuration:

• CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE: Determines which shipping option selection page is used. Can be set to ShippingOptionSelectionPage (default), DataSourceShippingOptionSelectionPage, AttributeBasedShippingOptionSelectionPage, or RemoteShippingOptionSelectionPage.

• AUTOSELECT_SHIPPING: When True, automatically selects the shipping option if only one is available.

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

Shipping option selection page context retrieved

application/json

get

/orders/checkout/?page=ShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Shipping option selection page context retrieved

{
  "context_list": [
    {
      "page_name": "ShippingOptionSelectionPage",
      "page_slug": "shippingoptionselectionpage",
      "page_context": {
        "shipping_options": [
          {
            "pk": 1,
            "name": "Standard Shipping",
            "slug": "standard-shipping",
            "logo": "https://cdn.akinon.com/logos/standard.png",
            "shipping_amount": "9.99",
            "description": "Delivery in 3-5 business days",
            "kwargs": {}
          },
          {
            "pk": 2,
            "name": "Express Shipping",
            "slug": "express-shipping",
            "logo": "https://cdn.akinon.com/logos/express.png",
            "shipping_amount": "19.99",
            "description": "Next day delivery",
            "kwargs": {}
          }
        ]
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": null,
    "shipping_amount": null,
    "payment_option": null,
    "notifications": [],
    "total_amount": "150.00",
    "unpaid_amount": "150.00",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "150.00",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Shipping Option

post

Sets the selected shipping option for the order.

Validation:

• The selected shipping option must be in the list of available shipping options

• The shipping option's rules are re-evaluated to ensure it's still valid

• If the shipping option has required_fields in its kwargs, those fields must be provided

Rule Re-evaluation:

• Rules are checked again at submission time to prevent race conditions

• If basket contents changed since page load, rules may now fail

• If address changed since page load, geographic rules are re-evaluated

• Failed rule validation returns an error and the user must select a different option

Shipping Amount Calculation:

• Amount is calculated using the shipping option's configured calculator

• Calculator receives current basket contents, shipping address, and currency

• Available calculator types:

  • FreeShippingCalculator: Zero cost

  • FixedPriceCalculator: Fixed amount from shipping option configuration

  • WeightBasedCalculator: Cost based on basket weight tiers

  • PriceBasedCalculator: Cost based on basket amount tiers

  • QuantityBasedCalculator: Cost based on item quantity

  • RemoteCalculator: Cost from external service

  • DataSourceCalculator: Cost per vendor/supplier

• Calculated amount is stored in pre-order and added to order total

Next Pages:

• If sample product discounts are available: SampleProductPage

• If retail store reservation is needed: ReservationSelectionPage

• Otherwise: PaymentOptionSelectionPage

Cascading Invalidation:

• Changing shipping option resets any previously selected payment option

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

application/x-www-form-urlencoded

shipping_optionintegerRequired

Primary key of the selected shipping option

Other propertiesstringOptional

Additional required fields defined in the shipping option's kwargs.required_fields. These fields vary based on the shipping option configuration and may include fields like delivery_date, time_slot, etc.

Responses

200

Shipping option selected successfully

application/json

post

/orders/checkout/?page=ShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

"shipping_option=1"

Select standard shippingShipping option with required fields

200

Shipping option selected successfully

{
  "context_list": [
    {
      "page_name": "PaymentOptionSelectionPage",
      "page_slug": "paymentoptionselectionpage",
      "page_context": {
        "checkout_url": "https://sandbox.akinon.com/checkout/token123",
        "status_url": "https://sandbox.akinon.com/checkout/status/token123",
        "payment_options": [
          {
            "pk": 1,
            "name": "Credit Card",
            "slug": "credit-card",
            "payment_type": "credit_card",
            "payment_type_label": "Credit Card"
          }
        ],
        "unavailable_options": []
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": {
      "pk": 1,
      "name": "Standard Shipping",
      "slug": "standard-shipping",
      "logo": "https://cdn.akinon.com/logos/standard.png",
      "shipping_amount": "9.99",
      "description": "Delivery in 3-5 business days",
      "kwargs": {}
    },
    "shipping_amount": "9.99",
    "payment_option": null,
    "notifications": [],
    "total_amount": "159.99",
    "unpaid_amount": "159.99",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "159.99",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Data Source Shipping Option Selection Page context

get

Returns available shipping options grouped by data source (supplier/vendor). Used when products in the basket come from different data sources and each data source requires separate shipping option selection.

This page is used when CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE dynamic setting is set to DataSourceShippingOptionSelectionPage.

Preconditions:

• Shipping address must be selected (check_address_selected)

• Basket must not be empty

Data Source Grouping:

• Products are grouped by their data source (supplier/vendor)

• Each data source has its own set of available shipping options

• User must select a shipping option for each data source

Configuration:

• CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE: Must be set to DataSourceShippingOptionSelectionPage to enable this page.

Error Handling:

• Raises NoDataSourceShippingOptionAvailable exception if no shipping options are available for the basket and shipping address combination

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

Data source shipping option selection page context retrieved

application/json

get

/orders/checkout/?page=DataSourceShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Data source shipping option selection page context retrieved

{
  "context_list": [
    {
      "page_name": "DataSourceShippingOptionSelectionPage",
      "page_slug": "datasourceshippingoptionselectionpage",
      "page_context": {
        "data_sources": [
          {
            "pk": 1,
            "name": "Supplier A",
            "data_source_shipping_options": [
              {
                "pk": 10,
                "shipping_amount": "5.99",
                "shipping_option_name": "Standard Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png",
                "data_source": {
                  "pk": 1,
                  "title": "Supplier A"
                },
                "description": "3-5 business days"
              },
              {
                "pk": 11,
                "shipping_amount": "12.99",
                "shipping_option_name": "Express Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/express.png",
                "data_source": {
                  "pk": 1,
                  "title": "Supplier A"
                },
                "description": "Next day delivery"
              }
            ]
          },
          {
            "pk": 2,
            "name": "Supplier B",
            "data_source_shipping_options": [
              {
                "pk": 20,
                "shipping_amount": "7.99",
                "shipping_option_name": "Standard Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png",
                "data_source": {
                  "pk": 2,
                  "title": "Supplier B"
                },
                "description": "3-5 business days"
              }
            ]
          }
        ]
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": null,
    "shipping_amount": null,
    "payment_option": null,
    "notifications": [],
    "total_amount": "150.00",
    "unpaid_amount": "150.00",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "150.00",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Shipping Options per Data Source

post

Sets the shipping options for each data source in the basket. Each data source in the basket must have exactly one shipping option selected.

Input Format:

• data_source_shipping_options: JSON-encoded array of DataSourceShippingOption primary keys

• Each ID in the array corresponds to a shipping option selected for a specific data source

• The array must contain exactly one shipping option ID per data source in the basket

Example: If a basket contains products from 2 data sources (Vendor A and Vendor B), and the available shipping options are:

• Data Source "Vendor A": Standard Shipping (ID: 10), Express Shipping (ID: 11)

• Data Source "Vendor B": Standard Shipping (ID: 20), Economy Shipping (ID: 21)

To select Standard Shipping for Vendor A and Economy Shipping for Vendor B:

data_source_shipping_options: "[10, 21]"

Validation:

• All data sources in the basket must have a shipping option selected

• Selected options must be available for the current basket and shipping address

• Shipping amounts are recalculated to ensure consistency

Shipping Amount:

• Total shipping amount is the sum of all selected data source shipping option amounts

Next Pages:

• If sample product discounts are available: SampleProductPage

• If retail store reservation is needed: ReservationSelectionPage

• Otherwise: PaymentOptionSelectionPage

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

application/x-www-form-urlencoded

data_source_shipping_optionsstringRequired

JSON-encoded array of data source shipping option IDs. Each ID is the primary key of a DataSourceShippingOption model. One shipping option must be selected for each data source in the basket.

Example: [10, 20, 30]

Responses

200

Data source shipping options selected successfully

application/json

post

/orders/checkout/?page=DataSourceShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

"data_source_shipping_options='[10, 20]'"

200

Data source shipping options selected successfully

{
  "context_list": [
    {
      "page_name": "PaymentOptionSelectionPage",
      "page_slug": "paymentoptionselectionpage",
      "page_context": {
        "checkout_url": "https://sandbox.akinon.com/checkout/token123",
        "status_url": "https://sandbox.akinon.com/checkout/status/token123",
        "payment_options": [],
        "unavailable_options": []
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": {
      "pk": 1,
      "name": "Standard Delivery",
      "slug": "standard-delivery",
      "logo": "https://cdn.akinon.com/logos/standard.png",
      "shipping_amount": "13.98",
      "description": null,
      "kwargs": {}
    },
    "shipping_amount": "13.98",
    "payment_option": null,
    "notifications": [],
    "total_amount": "163.98",
    "unpaid_amount": "163.98",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "163.98",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": [
      {
        "pk": 10,
        "shipping_amount": "5.99",
        "shipping_option_name": "Standard Delivery",
        "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png",
        "data_source": {
          "pk": 1,
          "title": "Supplier A"
        },
        "description": "3-5 business days"
      },
      {
        "pk": 20,
        "shipping_amount": "7.99",
        "shipping_option_name": "Standard Delivery",
        "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png",
        "data_source": {
          "pk": 2,
          "title": "Supplier B"
        },
        "description": "3-5 business days"
      }
    ],
    "attribute_based_shipping_options": null
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Attribute-Based Shipping Option Selection Page context

get

Returns available shipping options grouped by product attribute values. Products are grouped based on configured attribute keys, and each group can have different shipping options available.

This page is used when CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE dynamic setting is set to AttributeBasedShippingOptionSelectionPage.

Preconditions:

• Shipping address must be selected (check_address_selected)

• Basket must not be empty

Attribute-Based Grouping: Products are grouped by their attribute VALUES (not keys). The grouping mechanism works as follows:

1. Rule Evaluation: The system evaluates rules from ATTRIBUTE_KEYS_FOR_ATTRIBUTE_BASED_SHIPPING_OPTION setting in sort_order priority (lower values first). Each rule is evaluated against the shipping address using location-based conditions (country, city, township, district).

2. First Match Wins: The first rule that matches the shipping address determines which group_attribute_key is used for grouping. Remaining rules are ignored.

3. Grouping by Attribute Value: Products are then grouped by the value of the selected attribute key. For example, if group_attribute_key is "warehouse_location":

   • Product A with warehouse_location: "istanbul" → Group: "istanbul"

   • Product B with warehouse_location: "istanbul" → Group: "istanbul" (same group)

   • Product C with warehouse_location: "ankara" → Group: "ankara"

4. Missing Attributes: Products without the specified attribute are grouped under "None". A default shipping option (with is_default=True) typically handles these products.

5. Multiple Attribute Keys: If group_attribute_key is a list (e.g., ["brand", "category"]), products are grouped by composite keys with semicolon separator:

   • Product with brand: "Nike", category: "shoes" → Group: "Nike;shoes"

   • Product with only brand: "Nike" → Group: "Nike;None"

Available Rules for Rule Configuration:

Rule Slug	Description	Parameters
any-rule	Always matches (fallback rule)	none
country-rule	Matches addresses in specified countries	countries: list of country IDs, exclude: boolean
city-rule	Matches addresses in specified cities	cities: list of city IDs, exclude: boolean
township-rule	Matches addresses in specified townships	townships: list of township IDs, exclude: boolean
district-rule	Matches addresses in specified districts	districts: list of district IDs, exclude: boolean
postal-code-rule	Matches addresses with specified postal codes	postal_codes: list of postal code strings, exclude: boolean
not-rule	Negates a child rule	child: child rule object
and-rule	All children must match	children: list of child rule objects
or-rule	Any child must match	children: list of child rule objects

Configuration Example:

[
  {
    "group_attribute_key": "warehouse_location",
    "rule": {"slug": "country-rule", "countries": [1, 2], "exclude": false},
    "sort_order": 1
  },
  {
    "group_attribute_key": ["brand", "category"],
    "rule": {"slug": "city-rule", "cities": [5], "exclude": false},
    "sort_order": 2
  },
  {
    "group_attribute_key": "supplier",
    "rule": {"slug": "any-rule"},
    "sort_order": 99
  }
]

In this example:

• For addresses in countries 1 or 2: Products are grouped by warehouse_location

• For addresses in city 5 (if not in countries 1, 2): Products are grouped by brand;category

• For all other addresses: Products are grouped by supplier

Segment Support:

• Available shipping options can vary based on user segment

• Segment-specific pricing and availability rules are applied

Configuration:

• CHECKOUT_SHIPPING_OPTION_SELECTION_PAGE: Must be set to AttributeBasedShippingOptionSelectionPage

• ATTRIBUTE_KEYS_FOR_ATTRIBUTE_BASED_SHIPPING_OPTION: List of attribute key configurations that define how products are grouped

Error Handling:

• Raises NoAttributeBasedShippingOptionAvailable exception if no shipping options are available for the basket and shipping address combination

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

Attribute-based shipping option selection page context retrieved

application/json

get

/orders/checkout/?page=AttributeBasedShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Attribute-based shipping option selection page context retrieved

{
  "context_list": [
    {
      "page_name": "AttributeBasedShippingOptionSelectionPage",
      "page_slug": "attributebasedshippingoptionselectionpage",
      "page_context": {
        "attribute_based_shipping_options": {
          "electronics": {
            "attribute_based_shipping_options": [
              {
                "pk": 100,
                "shipping_amount": "5.99",
                "shipping_option_name": "Standard Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png"
              },
              {
                "pk": 101,
                "shipping_amount": "15.99",
                "shipping_option_name": "Express Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/express.png"
              }
            ],
            "product_ids": [
              1001,
              1002,
              1003
            ],
            "attribute_key": [
              "category"
            ]
          },
          "clothing": {
            "attribute_based_shipping_options": [
              {
                "pk": 200,
                "shipping_amount": "3.99",
                "shipping_option_name": "Economy Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/economy.png"
              },
              {
                "pk": 201,
                "shipping_amount": "8.99",
                "shipping_option_name": "Standard Delivery",
                "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png"
              }
            ],
            "product_ids": [
              2001,
              2002
            ],
            "attribute_key": [
              "category"
            ]
          }
        }
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": null,
    "shipping_amount": null,
    "payment_option": null,
    "notifications": [],
    "total_amount": "150.00",
    "unpaid_amount": "150.00",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "150.00",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Shipping Options per Attribute Value Group

post

Sets the shipping options for each attribute value group in the basket. Each attribute value group must have exactly one shipping option selected.

Input Format:

• attribute_based_shipping_options: JSON-encoded object mapping attribute values to shipping option IDs

• Keys are attribute values (the group keys from the GET response, e.g., "electronics", "clothing", "Nike;shoes")

• Values are AttributeBasedShippingOption primary keys (integers)

Example: If the GET response returns the following attribute-based shipping options:

{
  "electronics": {
    "attribute_based_shipping_options": [
      {"pk": 100, "shipping_option_name": "Standard Delivery", "shipping_amount": "5.99"},
      {"pk": 101, "shipping_option_name": "Express Delivery", "shipping_amount": "15.99"}
    ],
    "product_ids": [1001, 1002, 1003],
    "attribute_key": ["category"]
  },
  "clothing": {
    "attribute_based_shipping_options": [
      {"pk": 200, "shipping_option_name": "Economy Delivery", "shipping_amount": "3.99"},
      {"pk": 201, "shipping_option_name": "Standard Delivery", "shipping_amount": "8.99"}
    ],
    "product_ids": [2001, 2002],
    "attribute_key": ["category"]
  }
}

To select Standard Delivery (ID: 100) for electronics and Economy Delivery (ID: 200) for clothing:

attribute_based_shipping_options: '{"electronics": 100, "clothing": 200}'

Composite Group Keys: If products are grouped by multiple attributes (e.g., ["brand", "category"]), the group keys will be composite values separated by semicolons:

attribute_based_shipping_options: '{"Nike;shoes": 100, "Adidas;clothing": 200, "Nike;None": 100}'

Validation:

• All attribute value groups must have a shipping option selected

• Selected options must be available for the current basket, shipping address, and segment

• Product IDs must match the expected grouping

• Shipping amounts are recalculated to ensure consistency

Shipping Amount:

• Total shipping amount is the sum of all selected attribute-based shipping option amounts

Address Validation:

• Validates that the shipping address hasn't changed since options were loaded

• If address changed, options are recalculated

Next Pages:

• If sample product discounts are available: SampleProductPage

• If retail store reservation is needed: ReservationSelectionPage

• Otherwise: PaymentOptionSelectionPage

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

application/x-www-form-urlencoded

attribute_based_shipping_optionsstringRequired

JSON-encoded object mapping attribute values to shipping option IDs. Keys are attribute values (e.g., "electronics", "clothing", "warehouse_a"). Values are primary keys of AttributeBasedShippingOption models. One shipping option must be selected for each attribute value group.

Example: {"electronics": 100, "clothing": 200}

Responses

200

Attribute-based shipping options selected successfully

application/json

post

/orders/checkout/?page=AttributeBasedShippingOptionSelectionPage

HTTPcURLJavaScriptPython

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

"attribute_based_shipping_options='{\'electronics\': 100, \'clothing\': 200}'"

200

Attribute-based shipping options selected successfully

{
  "context_list": [
    {
      "page_name": "PaymentOptionSelectionPage",
      "page_slug": "paymentoptionselectionpage",
      "page_context": {
        "checkout_url": "https://sandbox.akinon.com/checkout/token123",
        "status_url": "https://sandbox.akinon.com/checkout/status/token123",
        "payment_options": [],
        "unavailable_options": []
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": {
      "pk": 1,
      "name": "Standard Delivery",
      "slug": "standard-delivery",
      "logo": "https://cdn.akinon.com/logos/standard.png",
      "shipping_amount": "9.98",
      "description": null,
      "kwargs": {}
    },
    "shipping_amount": "9.98",
    "payment_option": null,
    "notifications": [],
    "total_amount": "159.98",
    "unpaid_amount": "159.98",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "159.98",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": [
      {
        "pk": 100,
        "shipping_option_name": "Standard Delivery",
        "shipping_option_logo": "https://cdn.akinon.com/logos/standard.png",
        "shipping_amount": "5.99",
        "product_ids": [
          1001,
          1002,
          1003
        ],
        "attribute_value": "electronics",
        "attribute_key": [
          "category"
        ]
      },
      {
        "pk": 200,
        "shipping_option_name": "Economy Delivery",
        "shipping_option_logo": "https://cdn.akinon.com/logos/economy.png",
        "shipping_amount": "3.99",
        "product_ids": [
          2001,
          2002
        ],
        "attribute_value": "clothing",
        "attribute_key": [
          "category"
        ]
      }
    ]
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}

Get Payment Option Selection Page context

get

Returns available payment options for the order. Payment options are filtered based on configured rules and user context.

Preconditions:

• Shipping option must be selected (check_shipping_option_selected)

• Basket must not be empty

Payment Option Availability:

• Each payment option has associated rules that determine availability

• Rules can check basket contents, user status, order amount, and more

• Unavailable options are returned separately with error codes and messages

Checkout URLs:

• checkout_url: URL for checkout with token (used for external payment flows)

• status_url: URL to check checkout status (used for polling payment status)

• Generated by CheckoutWithTokenService

Payment Types: Payment options can have different types that determine the next page flow:

• credit_card: Routes to BinNumberPage

• funds_transfer: Routes to FundsTransferChoicePage

• bkm_express: Routes to BexSelectionPage

• loyalty_money: Routes to LoyaltyMoneyPage

• cash_register: Routes to CashRegisterPage

• gpay: Routes to GPaySelectionPage

• redirection: Routes to RedirectionPaymentSelectedPage

• stored_card: Routes to MobilExpressSelectionPage

• masterpass: Routes to MasterpassBinNumberPage

• masterpass_rest: Routes to MasterpassRestBinNumberPage

• credit_payment: Routes to CreditPaymentSelectionPage

• pay_later: Routes to PayLaterCompletePage

• saved_card: Routes to SavedCardSelectionPage

• confirmation: Routes to ConfirmationPaymentAgreementCheckPage

• b2b: Routes to B2BPage

• wallet: Routes to WalletSelectionPage

• pay_on_delivery: Routes to PayOnDeliveryPaymentChoicePage or PayOnDeliveryPage

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

Payment option selection page context retrieved

application/json

get

/orders/checkout/?page=PaymentOptionSelectionPage

HTTPcURLJavaScriptPython

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

200

Payment option selection page context retrieved

{
  "context_list": [
    {
      "page_name": "PaymentOptionSelectionPage",
      "page_slug": "paymentoptionselectionpage",
      "page_context": {
        "checkout_url": "https://sandbox.akinon.com/orders/checkout/?token=abc123def456",
        "status_url": "https://sandbox.akinon.com/orders/checkout/status/?token=abc123def456",
        "payment_options": [
          {
            "pk": 1,
            "name": "Credit Card",
            "slug": "credit-card",
            "payment_type": "credit_card",
            "payment_type_label": "Credit Card"
          },
          {
            "pk": 2,
            "name": "Pay on Delivery",
            "slug": "pay-on-delivery",
            "payment_type": "pay_on_delivery",
            "payment_type_label": "Pay on Delivery"
          },
          {
            "pk": 3,
            "name": "Bank Transfer",
            "slug": "bank-transfer",
            "payment_type": "funds_transfer",
            "payment_type_label": "Bank Transfer"
          }
        ],
        "unavailable_options": [
          {
            "name": "Loyalty Points",
            "slug": "loyalty-points",
            "payment_type": "loyalty_money",
            "payment_type_label": "Loyalty Points",
            "error_code": "insufficient_balance",
            "error_message": "Insufficient loyalty points balance"
          }
        ]
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": {
      "pk": 1,
      "name": "Standard Shipping",
      "slug": "standard-shipping",
      "logo": "https://cdn.akinon.com/logos/standard.png",
      "shipping_amount": "9.99",
      "description": "Delivery in 3-5 business days",
      "kwargs": {}
    },
    "shipping_amount": "9.99",
    "payment_option": null,
    "notifications": [],
    "total_amount": "159.99",
    "unpaid_amount": "159.99",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "159.99",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": [],
  "template_name": "orders/checkout.html"
}

Select Payment Option

post

Sets the selected payment option for the order.

Validation:

• The selected payment option must be active

• The selected payment option must pass its availability rules

Payment Option Processing:

• If payment option is pay-on-delivery type, installment and card_info are cleared

• Previous MobilExpress data (keys starting with me_) is cleared

• Payment choice is reset

Next Pages: Based on the selected payment option type, the user is routed to the appropriate page:

• credit_card: BinNumberPage (enter card bin number)

• funds_transfer: FundsTransferChoicePage (select bank account)

• bkm_express: BexSelectionPage (BKM Express flow)

• loyalty_money: LoyaltyMoneyPage (use loyalty points)

• cash_register: CashRegisterPage (cash register payment)

• gpay: GPaySelectionPage (Google Pay flow)

• redirection: RedirectionPaymentSelectedPage (redirect to payment provider)

• stored_card: MobilExpressSelectionPage (use stored card)

• masterpass: MasterpassBinNumberPage (Masterpass flow)

• masterpass_rest: MasterpassRestBinNumberPage (Masterpass REST API flow)

• credit_payment: CreditPaymentSelectionPage (credit/installment payment)

• pay_later: PayLaterCompletePage (buy now pay later)

• saved_card: SavedCardSelectionPage (use saved card)

• confirmation: ConfirmationPaymentAgreementCheckPage (confirmation required)

• b2b: B2BPage (B2B payment)

• wallet: WalletSelectionPage (digital wallet)

• pay_on_delivery: If multiple payment choices available: PayOnDeliveryPaymentChoicePage, otherwise: PayOnDeliveryPage

Cascading Invalidation:

• Selecting a new payment option clears previous payment-related data

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

application/x-www-form-urlencoded

payment_optionintegerRequired

Primary key of the selected payment option. Must be an active payment option that passes availability rules.

Responses

200

Payment option selected successfully

application/json

post

/orders/checkout/?page=PaymentOptionSelectionPage

HTTPcURLJavaScriptPython

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

"payment_option=1"

Select credit card paymentSelect pay on delivery

200

Payment option selected successfully

{
  "context_list": [
    {
      "page_name": "BinNumberPage",
      "page_slug": "binnumberpage",
      "page_context": {}
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "[phone]",
      "line": "123 Main St",
      "country": {
        "pk": 1,
        "code": "US",
        "name": "United States"
      },
      "city": {
        "pk": 1,
        "name": "New York"
      },
      "township": {
        "pk": 1,
        "name": "Manhattan"
      }
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_and_shipping_same": true,
    "delivery_option": {
      "pk": 1,
      "name": "Home Delivery",
      "slug": "home-delivery",
      "delivery_option_type": "customer",
      "sort_order": 1
    },
    "shipping_option": {
      "pk": 1,
      "name": "Standard Shipping",
      "slug": "standard-shipping",
      "logo": "https://cdn.akinon.com/logos/standard.png",
      "shipping_amount": "9.99",
      "description": "Delivery in 3-5 business days",
      "kwargs": {}
    },
    "shipping_amount": "9.99",
    "payment_option": {
      "pk": 1,
      "name": "Credit Card",
      "slug": "credit-card",
      "payment_type": "credit_card",
      "payment_type_label": "Credit Card"
    },
    "notifications": [],
    "total_amount": "159.99",
    "unpaid_amount": "159.99",
    "loyalty_money": null,
    "currency_type_label": "USD",
    "installment": null,
    "redirect_to_three_d": null,
    "retail_store": null,
    "payment_choice": null,
    "user_email": "[email protected]",
    "phone_number": "[phone]",
    "user_phone_number": "[phone]",
    "gift_box": null,
    "delivery_range": null,
    "total_amount_with_interest": "159.99",
    "is_guest": false,
    "is_post_order": false,
    "data_source_shipping_options": null,
    "attribute_based_shipping_options": null
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}