Bus Booking · Bus Booking Services

Bus Block Ticket

Block seats temporarily before confirming payment and booking

POST request

URL: https://uat-api.vizodigital.com/api/v1/bus/block-ticket

Body

{
    "orderid": "BLK_001",
    "availableTripId": "1000123",
    "boardingPointId": "501",
    "droppingPointId": "601",
    "source": "3",
    "destination": "6",
    "inventoryItems": [
        {
            "seatName": "L1",
            "fare": "750.00",
            "passenger": {
                "name": "John Doe",
                "mobile": "9876543210",
                "email": "john@example.com",
                "age": 30,
                "gender": "MALE"
            }
        }
    ]
}

Include a valid Bearer token with every request

UAT example

{
    "response_code": 1,
    "status": true,
    "message": "Ticket blocked successfully",
    "data": {
        "blockKey": "BLK_KEY_987654321"
    }
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Block seats temporarily before confirming payment and booking.

UAT vs Production

UAT calls hit the Paysprint sandbox environment and are not billed.
Production calls use live credentials and deduct per-call fee from wallet.

Access & billing

Requires active permission/service key (bus_block_ticket) on developer account.
Authenticate with Bearer token header Authorization: Bearer <your_token>.

Body

application/json required

Bus Block Ticket request body

Schema

{
    "type": "object",
    "properties": {
        "orderid": {
            "type": "string",
            "description": "Unique request ID"
        },
        "availableTripId": {
            "type": "string",
            "description": "Trip ID"
        },
        "inventoryItems": {
            "type": "object",
            "description": "Passenger and seat selection details"
        }
    }
}

Example

{
    "orderid": "BLK_001",
    "availableTripId": "1000123",
    "boardingPointId": "501",
    "droppingPointId": "601",
    "source": "3",
    "destination": "6",
    "inventoryItems": [
        {
            "seatName": "L1",
            "fare": "750.00",
            "passenger": {
                "name": "John Doe",
                "mobile": "9876543210",
                "email": "john@example.com",
                "age": 30,
                "gender": "MALE"
            }
        }
    ]
}

Responses

200 · application/json

Successful response

Example

{
    "response_code": 1,
    "status": true,
    "message": "Ticket blocked successfully",
    "data": {
        "blockKey": "BLK_KEY_987654321"
    }
}

Rate Limits

60/min