Ticket-level Capture

Airline Ticket-level Capture API reference

This page provides API reference for Velocity API's Ticket-level Capture (update-order-data) operation. This operation is only applicable for use by an airline.

See Ticket-level Capture sample code below, and find the operation's parameter descriptions in the Request Parameters and Response Parameters subpages. For information on how to integrate this operation, see API.

Request

Endpoint: /mpoint/update-order-data
Method: POST

See sample code for a Ticket-level Capture (update-order-data) API request below, and find parameter descriptions in the following sections in the Request Parameters subpage:

Sample Request

See the following sample request for a Ticket-level Capture (update-order-data):

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<update-order-data>
		<transaction id="12345" order-no="FIU9YA">
			<orders>
				<line-item>
					<product order-ref="ABC1234" sku="product-ticket">
						<type>100</type>
						<name>ONE WAY</name>
						<description>MNL-CEB</description>
						<airline-data>
							<profiles>
								<profile>
									<seq>1</seq>
									<title>Mr</title>
									<first-name>dan</first-name>
									<last-name>dan</last-name>
									<type>ADT</type>
									<contact-info>
										<email>[email protected]</email>
										<mobile country-id="640">9187231231</mobile>
									</contact-info>
									<additional-data>
										<param name="loyality_id">345rtyu</param>
									</additional-data>
								</profile>
							</profiles>
							<billing-summary>
								<fare-detail>
									<fare>
										<profile-seq>1</profile-seq>
										<description>adult</description>
										<currency>PHP</currency>
										<amount>60</amount>
										<product-code>ABF</product-code>
										<product-category>FARE</product-category>
										<product-item>Base fare for adult</product-item>
									</fare>
								</fare-detail>
							</billing-summary>
							<trips>
								<trip tag="1" seq="1">
									<origin external-id="MNL" country-id="640" time-zone="+08:00" terminal="1">Ninoy Aquino International Airport</origin>
									<destination external-id="CEB" country-id="640" time-zone="+08:00" terminal="2">Mactan Cebu International Airport</destination>
									<departure-time>2021-03-07T19:35:00Z</departure-time>
									<arrival-time>2021-03-07T21:05:00Z</arrival-time>
									<booking-class>Z</booking-class>
									<service-level>Economy</service-level>
									<transportation code="5J" number="1">
										<carriers>
											<carrier code="5J" type-id="Aircraft Boeing-737-9">
												<number>563</number>
											</carrier>
										</carriers>
									</transportation>
									<additional-data>
										<param name="fare_basis">we543s3</param>
									</additional-data>
								</trip>
							</trips>
						</airline-data>
					</product>
					<amount>125056</amount>
					<quantity>1</quantity>
					<additional-data>
						<param name="key">value</param>
					</additional-data>
				</line-item>
				<line-item>
					<product order-ref="ABC1237" sku="product-ticket">
						<type>200</type>
						<name>ONE WAY</name>
						<description>MNL-CEB</description>
						<airline-data>
							<profiles>
								<profile>
									<seq>1</seq>
									<title>Mr</title>
									<first-name>dan</first-name>
									<last-name>dan</last-name>
									<type>ADT</type>
									<contact-info>
										<email>[email protected]</email>
										<mobile country-id="640">9187231231</mobile>
									</contact-info>
									<additional-data>
										<param name="loyality_id">345rtyu</param>
									</additional-data>
								</profile>
							</profiles>
							<billing-summary>
								<add-ons>
									<add-on>
										<profile-seq>1</profile-seq>
										<trip-tag>2</trip-tag>
										<trip-seq>2</trip-seq>
										<description>adult</description>
										<currency>PHP</currency>
										<amount>60</amount>
										<product-code>ABF</product-code>
										<product-category>FARE</product-category>
										<product-item>Base fare for adult</product-item>
									</add-on>
								</add-ons>
							</billing-summary>
							<trips>
								<trip tag="1" seq="1">
									<origin external-id="MNL" country-id="640" time-zone="+08:00" terminal="1">Ninoy Aquino International Airport</origin>
									<destination external-id="CEB" country-id="640" time-zone="+08:00" terminal="2">Mactan Cebu International Airport</destination>
									<departure-time>2021-03-07T19:35:00Z</departure-time>
									<arrival-time>2021-03-07T21:05:00Z</arrival-time>
									<booking-class>Z</booking-class>
									<service-level>Economy</service-level>
									<transportation code="5J" number="1">
										<carriers>
											<carrier code="5J" type-id="Aircraft Boeing-737-9">
												<number>563</number>
											</carrier>
										</carriers>
									</transportation>
									<additional-data>
										<param name="fare_basis">we543s3</param>
									</additional-data>
								</trip>
							</trips>
						</airline-data>
					</product>
					<amount>125056</amount>
					<quantity>1</quantity>
					<additional-data>
						<param name="key">value</param>
					</additional-data>
				</line-item>
			</orders>
		</transaction>
	</update-order-data>
</root>

Response

See sample Ticket-level Capture (update-order-data) API responses below, and find a description of the response parameters in the Response Parameters subpage.

Sample Responses

Success Response

You receive the following response for a successful transaction:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <status code="100">Operation Success</status>
</root>

Fail Response

You receive the following response for a failed transaction:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <status code="99">Operation Failed</status>
</root>