Submit Credit Card Details and Process Payment

Submits full credit card details and processes the payment. May route to 3D Secure verification or complete order directly.

Required Fields:

• card_number: Full 16-digit card number

• card_holder: Cardholder name as printed on card

• card_month: Expiration month (MM format, e.g., "01", "12")

• card_year: Expiration year (YYYY format, e.g., "2026")

• card_cvv: CVV/CVC security code (3-4 digits)

• agreement: User must accept terms and conditions (boolean, must be true)

Optional Fields:

• card_name: Nickname for saved card (required if save is true)

• save: Whether to save card for future use (boolean, default false)

• use_three_d: User preference for 3D Secure (may be overridden by rules)

• client_time: Client-side timestamp for fraud detection

• Browser information fields for 3D Secure:

  • browser_java_enabled: Boolean

  • browser_language: Language code (e.g., "en-US")

  • browser_color_depth: Screen color depth (e.g., "24")

  • browser_screen_height: Screen height in pixels

  • browser_screen_width: Screen width in pixels

  • browser_time_zone: Timezone offset in minutes

  • browser_header: Accept header (auto-captured)

  • browser_user_agent: User agent string (auto-captured)

Card Validation:

• Card number validated using Luhn algorithm

• Expiration date must be in the future

• CVV must be 3-4 digits

• Cardholder name validated against format rules

3D Secure Decision: System determines if 3D Secure is required based on:

• Payment gateway configuration

• Card type and BIN rules

• Transaction amount thresholds

• User risk profile

• Bank requirements

Save Card Processing:

• If save is true and user is authenticated: Card is tokenized and saved

• Card details are encrypted and stored securely

• Only token and last 4 digits are retained

• Saved cards can be used in future checkouts

Identity Number Validation:

• If IDENTITY_NUMBER_REQUIRED_AMOUNT setting is configured:

  • Validates shipping address has identity_number field

  • Required when order total exceeds configured threshold

3D Secure Decision Logic:

• Master switch: THREE_D_SECURE_ENABLED must be true

• If enabled, evaluates THREE_D_SECURE_RULES conditions:

  • Amount limits

  • Guest user checks

  • First order checks

  • POS terminal restrictions

  • Failed attempt limits per user/IP

  • Currency restrictions

• If ANY rule returns true, 3D Secure is required

Next Pages:

• If 3D Secure required: CreditCardThreeDSecurePage

• If 3D Secure not required: ThankYouPage (order completed)

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

card_numberstringRequired

Full credit card number (16 digits). Validated using Luhn algorithm. Spaces are automatically removed.

Example: 5421190000000004Pattern: ^\d{16}$

card_holderstringRequired

Cardholder name as printed on the card. Must contain only letters and spaces. Validated against format rules.

Example: JOHN DOE

card_monthstringRequired

Card expiration month in MM format. Must be between 01 and 12.

Example: 12Pattern: ^(0[1-9]|1[0-2])$

card_yearstringRequired

Card expiration year in YYYY format. Must be current year or future.

Example: 2026Pattern: ^\d{4}$

card_cvvstringRequired

Card security code (CVV/CVC). Must be 3-4 digits depending on card type.

Example: 123Pattern: ^\d{3,4}$

card_namestringOptional

Nickname for the card if saving for future use. Required when save is true. Optional otherwise.

Example: My Visa Card

agreementboolean · enumRequired

User must accept terms and conditions to proceed. Must be true.

Possible values:

savebooleanOptional

Whether to save the card for future purchases. Only available for authenticated users. Guest users cannot save cards.

Default: false

use_three_dbooleanOptional

User preference for 3D Secure verification. May be overridden by system rules. Optional field.

client_timestring · date-timeOptional

Client-side timestamp for fraud detection

browser_java_enabledbooleanOptional

Whether Java is enabled in the browser

browser_languagestringOptional

Browser language code (e.g., "en-US", "tr-TR")

Example: en-US

browser_color_depthstringOptional

Screen color depth in bits (e.g., "24", "32")

Example: 24

browser_screen_heightstringOptional

Screen height in pixels

Example: 1080

browser_screen_widthstringOptional

Screen width in pixels

Example: 1920

browser_time_zonestringOptional

Timezone offset from UTC in minutes. Example: UTC-4 would be "240" (4 hours * 60 minutes)

Example: 240

Responses

200

Credit card details submitted successfully

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

post/orders/checkout/?page=CreditCardConfirmationPage

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

"card_number='5421190000000004'&card_holder='JOHN DOE'&card_month='12'&card_year='2026'&card_cvv='123'&agreement=true&save=false&browser_java_enabled=false&browser_language='en-US'&browser_color_depth='24'&browser_screen_height='1080'&browser_screen_width='1920'&browser_time_zone='240'"

200

Credit card details submitted successfully

{
  "context_list": [
    {
      "page_name": "CreditCardThreeDSecurePage",
      "page_slug": "creditcardthreedsecurepage",
      "page_context": {
        "redirect_url": "https://sandbox.akinon.com/orders/redirect-three-d/"
      }
    }
  ],
  "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": 1,
      "name": "Credit Card",
      "slug": "credit-card",
      "payment_type": "credit_card",
      "payment_type_label": "Credit Card"
    },
    "card_info": {
      "bin_number": "542119",
      "card": {
        "pk": 1,
        "name": "Visa"
      }
    },
    "installment": {
      "pk": 2,
      "installment_count": 3,
      "label": "3 Installments"
    },
    "total_amount": "165.59",
    "total_amount_with_interest": "165.59",
    "unpaid_amount": "165.59",
    "currency_type_label": "USD",
    "redirect_to_three_d": true
  },
  "errors": {},
  "template_name": "orders/checkout.html"
}