Create Checkout

posthttps://api.nomod.com/v1/checkout

Create checkout.

curl -X POST 'https://api.nomod.com/v1/checkout' \
  -H 'X-API-KEY: $NOMOD_API_KEY' \
  -H 'Content-Type: application/json'

Responses

idstring <uuid>requiredread-only

urlstring <uri>required

The URL to the Checkout Session. Redirect customers to this URL to take them to the Hosted Checkout page

statusobjectrequiredread-only

Status of the session: created, cancelled, expired, paid

amountnumber <double>requiredread-only

The total payable amount (after applying discounts) in the main currency unit (e.g., USD, AED)

discountnumber <double>requiredread-only

The total discount amount applied to the order. Provide the value in the main currency unit (e.g., USD, AED)

currencystringrequired

Currency code (ISO 4217 format, e.g., USD, INR, AED)

Max length: 3

reference_idstringrequiredread-only

A unique string to reference the Checkout Session. This can be a customer ID, a cart ID, or similar, and merchants can use it to reconcile the session with their internal systems

created_atstring <date-time>required

ISO 8601 timestamp when the checkout session was created

itemsarrayrequired

A list of items the customer is buying, including item-level details

customerobjectrequired

Customer object with customer-related details

metadataobjectrequiredread-only

A set of key-value pairs that merchants can attach to an object. This can be useful for storing additional information about the object in a structured format.Maximum of 40 pairs allowed. Keys must be alphanumeric and cannot contain square brackets ([ and ]). Keys must not exceed 24 characters, and values must not exceed 512 characters.

chargesarrayrequiredread-only

List of charges associated with the checkout

Example response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "url": "https://example.com",
  "status": {
    "0": "p",
    "1": "a",
    "2": "i",
    "3": "d"
  },
  "amount": 0,
  "discount": 0,
  "currency": "string",
  "reference_id": "string",
  "created_at": "2026-01-01T00:00:00Z",
  "items": [
    {
      "item_id": "string",
      "name": "string",
      "quantity": 1,
      "unit_amount": "0.00",
      "discount_type": "flat",
      "discount_amount": "0.00",
      "total_amount": "0.00",
      "net_amount": "0.00"
    }
  ],
  "customer": {
    "first_name": "",
    "last_name": "",
    "business_name": "",
    "email": "",
    "phone_number": ""
  },
  "metadata": {},
  "charges": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "amount": 0,
      "payment_time": "00000000-0000-0000-0000-000000000000",
      "payment_method": {
        "0": "c",
        "1": "a",
        "2": "s",
        "3": "h"
      },
      "status": {
        "0": "a",
        "1": "u",
        "2": "t",
        "3": "h",
        "4": "o",
        "5": "r",
        "6": "i",
        "7": "s",
        "8": "e",
        "9": "d"
      }
    }
  ]
}