Complete MobilExpress 3D Secure payment

Finalises the order after the user completes 3D Secure verification at the bank. This endpoint is called by the browser after the bank redirects back to the checkout URL with page=MobilExpressPaymentThreeDPage&pos_redirect=true as query parameters.

The gateway's hash is validated and finish_payment_process is called with three_d_secure=True.

Required Fields (posted by the bank's redirect):

• TransactionId: The internal order transaction ID

• MobilexpressTransId: The MobilExpress transaction ID

• Result: 3D Secure result. Must be '3DSuccess' to proceed with order creation

• TotalAmount: Total payment amount (must match pre_order amount)

• InstallmentCount: Number of installments used

• Hash: HMAC hash from the MobilExpress gateway for response integrity verification

Validation:

• Result must be '3DSuccess'; otherwise a validation error is returned

• Hash must be valid (verified by gateway.is_hash_valid)

• TotalAmount must match pre_order.get_total_amount_with_interest()

Next Page: ThankYouPage

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

TransactionIdstringRequired

Internal order transaction ID posted by the bank redirect.

Example: ORDER-20240115-001

MobilexpressTransIdstringRequired

MobilExpress transaction ID posted by the bank redirect.

Example: ME-TXN-987654

Resultstring · enumRequired

3D Secure result code. Must be '3DSuccess' to proceed.

Example: 3DSuccessPossible values:

TotalAmountstring · decimalRequired

Total payment amount posted by the bank redirect (12 digits, 2 decimal places). Must match pre_order.get_total_amount_with_interest().

Example: 350.00

InstallmentCountintegerRequired

Number of installments used in the transaction.

Example: 1

HashstringRequired

HMAC hash from the MobilExpress gateway for response integrity verification. Validated via gateway.is_hash_valid.

Example: a3f5c2d1e8b94f7a...

Responses

200

3D Secure payment completion result

application/json

errorsone of · nullableOptional

or

string[]Optional

template_namestringOptional

post/orders/checkout/?page=MobilExpressPaymentThreeDPage

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

"TransactionId='ORDER-20240115-001'&MobilexpressTransId='ME-TXN-987654'&Result='3DSuccess'&TotalAmount='350.00'&InstallmentCount=1&Hash='a3f5c2d1e8b94f7a...'"

200

3D Secure payment completion result

{
  "context_list": [
    {
      "page_name": "ThankYouPage",
      "page_slug": "thankyoupage",
      "page_context": {}
    }
  ],
  "errors": {},
  "template_name": "orders/checkout.html"
}