Select Bank Account for Funds Transfer

Sets the selected bank account for funds transfer payment.

Validation:

• Selected bank account must be active

• Basket amount must be greater than or equal to zero

Reference Code Generation:

• If payment gateway supports reference codes (has_reference_code):

  • Generates unique reference code for the order

  • Uses order number, amount, currency as input

  • Includes user email, addresses, and site domain

  • Stores reference code in pre_order.data['funds_transfer']['reference_code']

• Reference code is displayed to user on next page for payment matching

Order Number Assignment:

• Pre-order number is assigned at this step (if not already assigned)

• Order number used in reference code generation

Bank Account Change Handling:

• If user changes bank account selection:

  • Reference code is regenerated

  • Previous reference code is invalidated

Next Pages:

• FundsTransferPage (display payment instructions)

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

bank_accountintegerRequired

Primary key of the selected bank account. Must be an active bank account configured in the system.

Responses

200

Bank account selected successfully

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

post/orders/checkout/?page=FundsTransferChoicePage

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

"bank_account=1"

200

Bank account selected successfully

{
  "context_list": [
    {
      "page_name": "FundsTransferPage",
      "page_slug": "fundstransferpage",
      "page_context": {
        "reference_code": "REF-ORD-2026-0001-ABC123"
      }
    }
  ],
  "pre_order": {
    "basket": {
      "pk": 123,
      "total_amount": "150.00"
    },
    "shipping_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "billing_address": {
      "pk": 10,
      "first_name": "John",
      "last_name": "Doe"
    },
    "payment_option": {
      "pk": 3,
      "name": "Bank Transfer",
      "slug": "bank-transfer",
      "payment_type": "funds_transfer",
      "payment_type_label": "Bank Transfer"
    },
    "funds_transfer_bank": {
      "pk": 1,
      "bank_name": "Example Bank",
      "account_holder": "AKINON TECHNOLOGIES",
      "iban": "TR330006100519786457841326",
      "currency": "TRY"
    },
    "number": "ORD-2026-0001",
    "total_amount": "159.99",
    "unpaid_amount": "159.99",
    "currency_type_label": "USD"
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}