Bus Booking · Bus Booking Services

Bus Book Ticket

Finalize booking using blocked key and process wallet payment

POST request

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

Body

{
    "orderid": "BOK_001",
    "refid": 12345,
    "amount": 750,
    "blockKey": "BLK_KEY_987654321",
    "passenger_phone": "9876543210",
    "passenger_email": "john@example.com"
}

Include a valid Bearer token with every request

UAT example

{
    "response_code": 1,
    "status": true,
    "message": "Ticket booked successfully",
    "data": {
        "tin": "PNR123456789",
        "status": "SUCCESS"
    }
}

Failure response

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

Overview

Finalize booking using blocked key and process wallet payment.

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_book_ticket) on developer account.
Authenticate with Bearer token header Authorization: Bearer <your_token>.

Body

application/json required

Bus Book Ticket request body

Schema

{
    "type": "object",
    "properties": {
        "orderid": {
            "type": "string",
            "description": "Unique request ID"
        },
        "blockKey": {
            "type": "string",
            "description": "Block key returned by block-ticket"
        },
        "amount": {
            "type": "number",
            "description": "Ticket total fare"
        }
    }
}

Example

{
    "orderid": "BOK_001",
    "refid": 12345,
    "amount": 750,
    "blockKey": "BLK_KEY_987654321",
    "passenger_phone": "9876543210",
    "passenger_email": "john@example.com"
}

Responses

200 · application/json

Successful response

Example

{
    "response_code": 1,
    "status": true,
    "message": "Ticket booked successfully",
    "data": {
        "tin": "PNR123456789",
        "status": "SUCCESS"
    }
}

Rate Limits

60/min