API Documentation

From Rts
Revision as of 22:05, 10 September 2020 by JacobS (talk | contribs)
Jump to: navigation, search

Version Change History

Date Change Notes Version
12/28/08 Added Error Listing 0.2
06/16/09 Added Retrieve Seating Chart Section 1.0
06/17/09 Added PHP sample code 1.01
03/15/10 Added the CustomerInfo and EmailAddress tags. Used to look-up transactions at the POS. 1.02
04/13/10 Added Gift Balance functions (requires server version 7.0.7564+).

Added gift number to purchase request, which allows adding money to an existing gift card (requires server version 7.0.7564+).

11/22/10 General document clean-up.

Corrected 'GiftInfo' to be 'GiftInformation'.
Added information for concession prices XML and concession sales.
Added 'SalesTaxCheck' information.
Moved all references regarding encryption to summary pages at back of documentation.
Updated PHP sample code to use TLS for the connection protocol.

11/30/10 Added test server information, credit card information, gift card information, etc

Updated PHP sample code to contain additional sample packets

12/13/10 Added sample of purchase ticket response

Updated sample response for GiftInformation, showing Registered Card information

06/11/13 Added multiple <Payment> sample

Added GroupID for Reserved Seating – Seat Chart
Added Registering a mag card
Added earning loyalty points for purchases
Added CardCredits to GiftInformation sample response

01/07/2014 Corrected an error in the Fees section regarding <TicketFee> 1.08
01/15/2015 emoved sample code (too many people using for production environments)

Switched from DIGEST to BASIC authentication
Added new error codes
Removed HTTP + Encryption section (no longer relevant)
Added CheckSoldOut request – shows Sold /Remaining / SoldOut levels for a performance

03/20/2015 Removed obsolete Seating Chart sample request 1.10
06/03/2015 Added WorldPay HostedCheckout sample requests and responses

Added 3rd party credit card processing sample request
Added listing of bit field settings used for films and shows
Added new error numbers / messages
Updated existing error numbers / messages

10/24/2016 Added CheckRedeem request sample

Added GetSeatLayouts request sample
Added GetSeatPlanForPerf request sample
Added CheckSeatPicks request sample
Added VerifyTransaction request sample
Added ReverseTransaction request sample
Added Refund request sample
Updated BUY request to include <ThirdPartyID> node information
Simplified table of contents

02/08/2017 Added Bit Field values for various new amenities 1.13
05/30/2017 Fixed documentation error with the CHECKSEATPICKS response 1.14
10/19/2017 Fixed typo in ‘CHECKSEATPICKS’ sample request

Added GridRef to ‘GETSEATPLANFORPERF’ response

02/02/2018 Added note regarding GZIP compression now being required for schedule request 1.16
07/24/2018 Updated test credit card information

Added Bit Field values for various new amenities

08/13/2018 Added TransactionDetails request sample

Added Redeem request sample
Updated Refund request to include PartialRefund support

09/26/2019 Added <SOGen> node to schedule data to indicate SoldOutGeneral state
Updated verbiage on <SO> and
  • node descriptions
    Added gift card PIN node to BUY request
    Added 3rd party gift card support
    Added custom seat pricing data to GETSEATPLANFORPERF call
    Added note regarding send confirmation emails on purchase via API
    Updated existing error numbers / messagess
  • 1.19
    11/25/2019 Updated seat type nodes to support new types

    Added support for 3rd party gift cards into the GIFTINFORMATON call
    Added a call for GIFTINFORMATIONWITHPIN to support PIN requiring card types

    01/31/2020 Added Heartland HostedCheckout test card information

    Added Heartland HostedCheckout sample requests and responses
    Added Heartland HostedCheckout error messages

    05/04/2020 Updated seat status nodes to support Buffer seat status 1.22


    RTS Ticketing has created an open interface to accommodate third party access to our sales engine. In order to allow access, we have created an HTTPS server that accepts XML packets.

    Credit card payments are processed either through the POS locations’ credit card processing account, or through your own processing account. So a separate shopping cart or credit card processing account is not needed, but you have the option of building your own.

    Purchased tickets can be redeemed at the locations POS at for actual tickets. These tickets can be redeemed using any of three methods:

    1. The credit card that was used to purchase the tickets
    2. The receipt number assigned to the purchase
    3. The bar code that is provided by the purchase response packet.

    Note: Some locations do not have bar code readers or the bar code may be illegible when printed on a low-quality printer. It is strongly suggested that the confirmation number is also printed with the bar code.


    Communications with the locations POS server are done using a HTTPS Post of an XML packet. Basic authentication is performed for each Post.

    The URL for posting data is:
    https://<Theatre RTN Number>.formovietickets.com:<port>/Data.ASP

    Note: The listening port is 2235 (not the default web server port 80)

    Test Server Information

    It is a good idea to develop your application against a test server, and not against a live theatre server. Below is the information for the RTS Test Servers:

    !! NOTE: These are not web pages, they cannot be viewed in a browser !!

    WorldPay Non-E2E Server (also known as Mercury Classic Server):
    The endpoint URL is: https://5.formovietickets.com:2235/Data.ASP

    WorldPay E2E Server (also known as Mercury EMV Server):
    The endpoint URL is: https://5.formovietickets.com:2245/Data.ASP

    Heartland Secure Server:
    The endpoint URL is: https://5.formovietickets.com:2255/Data.ASP

    The credentials for these servers are:

    Schedule and Selling Username: test
    Schedule and Selling Password: test

    Test Card Information

    !! NOTE: The <ChargeAmount> for the test WorldPay cards cannot exceed $10 !!

    The test credit card information for the WorldPay Non-E2E server is:

    Number 5499-9901-2345-6781
    Expiration Any future month and year (mmyy format)
    AVS Street 150 Mercury Village
    AVS Postal 81301
    CVV 5499-9901-2345-6781
    Customer Name Any name

    The test credit card information for the WorldPay E2E server is:

    Number 4003-0001-2345-6781
    Expiration Any future month and year (mmyy format)
    AVS Street 150 Mercury Village
    AVS Postal 81301
    CVV 5499-9901-2345-6781
    Customer Name Any name

    The test credit card information for the Heartland Secure server is:

    Number 4640-6977-8499-8
    Expiration 12 / 2025
    AVS Street 6860 Dallas Pkwy
    AVS Postal 75024
    CVV 5499-9901-2345-6781
    Customer Name Any name

    To obtain a test gift card number, purchase a new gift card, and then use the returned number as your future test gift card number. See page [Gift Card / Loyalty Card Information] for details on purchasing new gift cards.

    Performance Schedule

    !! NOTE: GZIP Compression is required when requesting schedule data !!

    !! NOTE: Sending in <ShowAvalTickets> and <ShowSales> values that do not match the settings on the locations configured schedule API account will result in a 401 – Unauthorized error !!</span

    Performance Schedule - Sample Request Packet




    Performance Schedule - Sample Response Packet


    <LinkPrefix> https://www.readyticket.net/webticket/webticket2.aspWCI=BuyTicket&WCI=
    <Title>+21 STRANGE TITLE</Title>
    <TitleShort>+21 STRANGE TITLE</TitleShort>

    <Aud>1</Aud> <ID>+24230|200811261235|1</ID> <SaleLink>%2B21+STRANGE+TITLE,112620081235,1,5,NC17</SaleLink> <RE>225</RE> <Sold>22</Sold> <SO>0</SO>

  • 0
  • <TIs> <TI> <C>1|1</C> </TI> <TI> <C>1|2</C> </TI> </TIs> </Show> </Shows> </Film> </Films> </ShowScheddule> </Response>