CreateAuthenticationRequest - LiteCore API Reference

instrument_id

string<uuid>

required

Instrument ID

Example:

"baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5"

customer

object

required

Customer details

Show child attributes

order

object

required

Order details

Show child attributes

return_url

string<uri>

required

Return URL for 3DS challenge completion

Example:

"https://example.com/threeds/callback"

device

object

Device information (required for 3DS and risk assessment)

Show child attributes

CreateCheckoutSessionRequestRequest body for creating a new checkout session

{
  "instrument_id": "baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5",
  "customer": {
    "id": "cust_a1b2c3d4e5f6",
    "email": "donald.duck@duckworld.com",
    "first_name": "Donald",
    "last_name": "Duck",
    "phone_country_code": "+966",
    "phone_number": "555123456"
  },
  "order": {
    "reference": "ORD-123456",
    "items": {
      "products": [
        {
          "id": "prod_123",
          "price": 5000,
          "quantity": 2,
          "name": "T-Shirt",
          "metadata": {
            "color": "Blue",
            "size": "L"
          }
        }
      ],
      "vat": {
        "amount": 750
      },
      "shipping": {
        "amount": 1000
      }
    },
    "shipping_address": {
      "name": "John Doe",
      "email": "john@example.com",
      "street": "123 Main St",
      "city": "Riyadh",
      "state": "Riyadh Region",
      "zip": "12213",
      "country": "SA"
    },
    "billing_address": {
      "name": "John Doe",
      "email": "john@example.com",
      "street": "123 Main St",
      "city": "Riyadh",
      "state": "Riyadh Region",
      "zip": "12213",
      "country": "SA"
    },
    "amount": 10000,
    "currency": "SAR",
    "description": "Order description"
  },
  "return_url": "https://example.com/threeds/callback"
}