Skip to navigation

Paying with the wallet

Fund a debit account and draw from it when you ticket
View as Markdown

You pay for tickets from a pre-funded wallet, a debit account you top up ahead of time. When you issue tickets, the fare comes out of the balance. Keep the balance high enough to cover the bookings you plan to ticket. If it runs short, ticketing fails with code 877, “Insufficient available funds found in your credit line”.

Issuing tickets

Call OTA_AirDemandTicketRQ with the W1 record locator and paymentType 4, which is the wallet.

{
"version": "2.001",
"pos": {
"source": [
{
"isocurrency": "SAR",
"requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "4" },
"bookingChannel": { "type": "OTA" }
}
]
},
"demandTicketDetail": {
"messageFunction": [{ "function": "ET" }],
"bookingReferenceID": { "id": "N6G2NW", "type": "14", "companyName": { "code": "W1" } },
"paymentInfo": [
{ "paymentType": "4", "creditCardInfo": [{ "cardHolderName": "Sample Travel" }] }
]
}
}

What comes back

The response returns one ticketItemInfo entry per passenger, with the ticket number, totalAmount, and netAmount. For a booking with named passengers, each passengerName also carries tpaextensions.links: one download link per ticket PDF.

{
"success": {},
"bookingReferenceID": { "companyName": { "code": "W1" }, "type": "14", "id": "N6G2NW" },
"ticketItemInfo": [
{
"passengerName": {
"givenName": ["BARAA"],
"surname": "BUKHARI",
"passengerTypeCode": "ADT",
"tpaextensions": {
"links": [
{
"href": "https://api.sar.worldticket.cloud/sms-gateway-service/tickets/confirmation/N6G2NW/download/passenger-segment?ticketNumber=3333330058951&couponNumber=1",
"rel": "downloadTicket",
"segmentRPH": "1",
"travelerRPH": "1"
}
]
}
},
"ticketNumber": "3333330058951",
"type": "E_TICKET",
"totalAmount": 380.65,
"netAmount": 331.00,
"paymentType": "4"
}
],
"timeStamp": "2026-05-01T09:31:02.880Z",
"version": 2.001,
"retransmissionIndicator": false
}

Call each href as given to fetch the PDF. segmentRPH and travelerRPH tell you which segment and traveler the file covers. The older urls field in the same block, a space-separated string, is deprecated; read links. See Ticket documents for the download and resend endpoints.

Payment types

paymentType 4 is the wallet, and it is the type OTA ticketing uses in production. GO7 defines other codes (1 cash, 5 credit card, 32 external payment, 40 invoice) for other channels; they are not part of the wallet flow.

TypeMeans
4Debit account (wallet)

Ticket before the ticketing time limit. If you miss it, the seats are released and the booking becomes invalid. See Time limits.