RTC Bus API Implementation Guide

This page contains RTC-specific implementation information for API partners. Please follow the requirements applicable to the respective RTC/operator.

ASTC (Assam State Transport Corporation)

KAAC (Karbi Anglong Autonomous Council)

KTCL (Kadamba Transport Corporation Limited)

BSRTC (Bihar State Road Transport Corporation)

MTC (Meghalaya Transport Corporation)

operatorServiceChargeAbsolute

operatorServiceChargeAbsolute contains the operator service charge amount.

Trip fare already includes this service charge.

UPSRTC (Uttar Pradesh State Road Transport Corporation)

UPSRTC Logo

UPSRTC Ticket Template

The following is the UPSRTC e-Reservation ticket template used for the operator.

Fare Type

The response includes fare type such as:

• BASIC_FARE
• CONVENIENCE_FEE
• SERVICE_TAX

Sample response :

                    {
    "apiStatus": {
        "message": "SUCCESS",
        "success": true
    },
    "inventoryType": 1,
    "blockTicketKey": "50y0L9ffjZ",
    "updatedFareBreakup": {
        "previousTotalFareWithTaxes": 474.60,
        "updatedTotalFareWithTaxes": 519.80,
        "updatedTotalOperatorServiceCharge": 45.20,
        "updatedTotalServiceTax": 22.60,
        "seatFareBreakUp": {
            "4": [
                {
                    "fareType": "BASIC_FARE",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 452.00,
                    "refundableAmount": 452,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "CONVENIENCE_FEE",
                    "cancellationType": "NOT_REFUNDED",
                    "amount": 45.20,
                    "refundableAmount": 0.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "SERVICE_TAX",
                    "cancellationType": "FULLY_REFUNDED",
                    "amount": 22.60,
                    "refundableAmount": 22.60,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "TOTAL_FARE",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 519.80,
                    "refundableAmount": 474.60,
                    "discountType": "NON_DISCOUNT"
                }
            ]
        }
    }
}
                

SNT (Sikkim Nationalised Transport)

Sample response

                    {
    "apiStatus": {
        "message": "SUCCESS",
        "success": true
    },
    "inventoryType": 1,
    "blockTicketKey": "WCMk0wZjCG",
    "updatedFareBreakup": {
        "previousTotalFareWithTaxes": 264,
        "updatedTotalFareWithTaxes": 264.00,
        "updatedTotalOperatorServiceCharge": 12.00,
        "updatedTotalServiceTax": 12.00,
        "seatFareBreakUp": null
    }
}
                

Client Requirements

• Use fare as the final payable fare (it already includes the operator service charge).
• Show operatorServiceChargeAbsolute as the Convenience Fee on the payment page.
• Do not add the operator service charge to fare again.

CTU (Chandigarh Transport Undertaking)

CTU Logo

CTC Ticket Template

The following is the UPSRTC e-Reservation ticket template used for the operator.

Concession Handling

1. User enters passenger details, including age.
2. If the passenger is 60+ years, send the srCitizen card number in the blockTicket request.
3. If the passenger is 6–12 years, send only the age.
4. The blockTicket API itself calculates the concession and returns the updated fare.
5. Pass age and srCitizen (for senior citizens) in the blockTicket request.
6. Read updatedFare and boConcessionAmount from the blockTicket response.
7. Continue with bookTicket().

HRTC (Himachal Road Transport Corporation)

Total Fare

Total Fare = BASIC_FARE + LEVIES_CHARGES + TOLL_FEE + SERVICE_FEE + RESERVATION_FEE + SERVICE_TAX + ...

{
    "apiStatus": {
        "message": "SUCCESS",
        "success": true
    },
    "inventoryType": 1,
    "blockTicketKey": "vvjMSBf6Zo",
    "updatedFareBreakup": {
        "previousTotalFareWithTaxes": 299.25,
        "updatedTotalFareWithTaxes": 336.00,
        "updatedTotalOperatorServiceCharge": 35,
        "updatedTotalServiceTax": 16.00,
        "seatFareBreakUp": {
            "35": [
                {
                    "fareType": "BASIC_FARE",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 285.00,
                    "refundableAmount": 285.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "LEVIES_CHARGES",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 7.00,
                    "refundableAmount": 7.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "TOLL_FEE",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 23.00,
                    "refundableAmount": 23.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "SERVICE_FEE",
                    "cancellationType": "NOT_REFUNDED",
                    "amount": 5.00,
                    "refundableAmount": 0.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "RESERVATION_FEE",
                    "cancellationType": "NOT_REFUNDED",
                    "amount": 0.00,
                    "refundableAmount": 0.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "CONCESSIONS_FEE",
                    "cancellationType": "NOT_REFUNDED",
                    "amount": 0.00,
                    "refundableAmount": 0.0,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "SERVICE_TAX",
                    "cancellationType": "FULLY_REFUNDED",
                    "amount": 16.00,
                    "refundableAmount": 16.00,
                    "discountType": "NON_DISCOUNT"
                },
                {
                    "fareType": "TOTAL_FARE",
                    "cancellationType": "CANCELLATION_POLICY",
                    "amount": 336.00,
                    "refundableAmount": 331.00,
                    "discountType": "NON_DISCOUNT"
                }
            ]
        }
    }
}

Payment Page Fare Breakup

• Base Fare
• Levy Fee
• Convenience Fee
• GST
• Total Fare

JKSRTC (Jammu and Kashmir State Road Transport Corporation)

We let you know once we get update from Internal team.

UTC (Uttarakhand Transport Corporation)

Refund Components

CTU Logo

UTC Ticket Template

The following is the UTC e-Reservation ticket template used for the operator.

Client Implementation Checklist

• Identify the RTC/operator ID.
• Check whether the operator uses the Default or RTC template.
• Check whether realtime cancellation is required.
• Check whether the cancelticketinfo API is required.
• Check operator-specific fare calculation rules.
• Do not double-add operator service charges when they are already included in fare.
• Implement concession handling where specified.
• Implement the required payment-page fare breakup.
• Check cancellation eligibility before cancellation where required.
• Keep RTC-specific logic separate from generic private-operator logic.

FAQs