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 numbercard_holder: Cardholder name as printed on cardcard_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 ifsaveis 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 detectionBrowser information fields for 3D Secure:
browser_java_enabled: Booleanbrowser_language: Language code (e.g., "en-US")browser_color_depth: Screen color depth (e.g., "24")browser_screen_height: Screen height in pixelsbrowser_screen_width: Screen width in pixelsbrowser_time_zone: Timezone offset in minutesbrowser_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
saveis true and user is authenticated: Card is tokenized and savedCard 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_AMOUNTsetting 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_ENABLEDmust be trueIf enabled, evaluates
THREE_D_SECURE_RULESconditions: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:
CreditCardThreeDSecurePageIf 3D Secure not required:
ThankYouPage(order completed)
Required header for AJAX requests. Must be set to XMLHttpRequest for all checkout requests.
XMLHttpRequestPossible values: Session cookie header (e.g. sessionid=abc123 or osessionid=<session_id>)
Full credit card number (16 digits). Validated using Luhn algorithm. Spaces are automatically removed.
5421190000000004Pattern: ^\d{16}$Cardholder name as printed on the card. Must contain only letters and spaces. Validated against format rules.
JOHN DOECard expiration month in MM format. Must be between 01 and 12.
12Pattern: ^(0[1-9]|1[0-2])$Card expiration year in YYYY format. Must be current year or future.
2026Pattern: ^\d{4}$Card security code (CVV/CVC). Must be 3-4 digits depending on card type.
123Pattern: ^\d{3,4}$Nickname for the card if saving for future use.
Required when save is true.
Optional otherwise.
My Visa CardUser must accept terms and conditions to proceed. Must be true.
Whether to save the card for future purchases. Only available for authenticated users. Guest users cannot save cards.
falseUser preference for 3D Secure verification. May be overridden by system rules. Optional field.
Client-side timestamp for fraud detection
Whether Java is enabled in the browser
Browser language code (e.g., "en-US", "tr-TR")
en-USScreen color depth in bits (e.g., "24", "32")
24Screen height in pixels
1080Screen width in pixels
1920Timezone offset from UTC in minutes. Example: UTC-4 would be "240" (4 hours * 60 minutes)
240Credit card details submitted successfully
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'"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"
}Last updated
Was this helpful?

