Guides

Channel – Orders

POST /channel/v1/orders/validate

Validate seats (and optional concessions) before reserving.

Body

Code
 
{
  "seats": [
    {
      "ticketTypeCode": "ADULT",
      "seatLayouts": [{ "areaNumber": 1, "rowIndex": 5, "columnIndex": 7 }]
    }
  ],
  "filmSessionId": "<sessionId>",
  "concessions": [{ "concessionItemId": "<id>", "quantity": 1 }]
}

Response — 201

Code
 
[
  {
    "seats": [
      /* SeatDetailItemDto */
    ],
    "filmSessionId": "<sessionId>",
    "concessions": [
      /* ConcessionItemDto */
    ]
  }
]

Example

Code
 
curl -X POST "https://api.wml.staging.nexdots.com/channel/v1/orders/validate"   -H "Authorization: Bearer <access-token>"   -H "Content-Type: application/json"   -d @validate.json

---

POST /channel/v1/orders/reserve

Create a reservation and get pricing + seat breakdown.

Body (minimum)

Code
 
{
  "seats": [
    {
      "ticketTypeCode": "ADULT",
      "seatLayouts": [{ "areaNumber": 1, "rowIndex": 5, "columnIndex": 7 }]
    }
  ],
  "filmSessionId": "<sessionId>",
  "customerPhone": "85512345678"
}

Response — 201

Code
 
{
  "sessions": [
    /* SelectSeatTicketSessionDto[] */
  ],
  "amount": 245000,
  "userSessionId": "USR-SESSION-123"
}

Example

Code
 
curl -X POST "https://api.wml.staging.nexdots.com/channel/v1/orders/reserve"   -H "Authorization: Bearer <access-token>"   -H "Content-Type: application/json"   -d @reserve.json

---

POST /channel/v1/orders/complete

Mark reservation as paid.

Body

Code
 
{
  "userSessionId": "USR-SESSION-123",
  "acquirer": "ABA KHQR",
  "paymentTime": "2025-09-26T06:45:20.312Z",
  "orderNumber": "72455733579",
  "transactionId": "TX1234567890"
}

Response — 201

Code
 
{
  "bookingId": "BKG-123",
  "bookingNumber": "BN-999",
  "transNumber": "TRX-777",
  "historyId": "HIS-456"
}

Example

Code
 
curl -X POST "https://api.wml.staging.nexdots.com/channel/v1/orders/complete"   -H "Authorization: Bearer <access-token>"   -H "Content-Type: application/json"   -d @complete.json

---

POST /channel/v1/orders/cancel

Cancel a reservation by user session.

Body

Code
 
{ "userSessionId": "USR-SESSION-123" }

Response — 201

Code
 
true

Example

Code
 
curl -X POST "https://api.wml.staging.nexdots.com/channel/v1/orders/cancel"   -H "Authorization: Bearer <access-token>"   -H "Content-Type: application/json"   -d '{"userSessionId":"USR-SESSION-123"}'