TicketGate, PreBook
Click here for a complete list of operations.
Description
The purpose of this method is to make a prebook of seats to a specific arrangement. The method returns all relevant informations requiered for setting up a form to be posted to DIBS. In order to do so, creditcard type should be handled over as parameter because the final price depends on the that specific choice.
The complete price also depends on whether a specified cardholder has payed for the ebillet-card.
The rest of the parameters are included in this call so that the service can check the syntax, defined by the organizer.
The method should be called every time a new choice of creditcard type has been made.
The customer has the possibility to make purchases as:
External user: | The user must be identified by external users ID. Use the UserId parameter. The Phone parameter must be specified as well in order to identify the purchase in the local ticket system. The password parameter will be ignored in this situation. Cardholder is optional if an external user is specified. If a purchase has been made only by identifying the user as an external user, then the customer will not be able to look up the purchase from en ebillet site. |
Anonymous user: | The user must be identified by phone number and password. Use the Phone- and the Password parameters. Anonymous user compound with the external user ID or the ebillet cardholder ID makes no sense |
ebillet cardholder: | The user must be identified by a cardholder ID. Use the Cardholder parameter. |
Parameter
TransactionID | Identifies the ongoing transaction/prereservation. |
UserID | Identifies - and links to - the user in an external system. |
Phone | Phone number entered by the user. |
Password | Password selected by the user. |
EMail selected by the user. | |
CardHolder | If this parameter is different from 0, ckecks will be made to see whether the ebillet-card is payed - or not. Set this parameter to 0 if customer don't use a ebillet-card. |
CreditCardCode | This parameter identifies the type of creditcard, the customer has selected. Valid codes are: DK (Visa/Dankort), VISA (International VISA) .... Check supported creditcards depending on the choice of organizer. Check the GetOrganizer method. |
Return value
<?xml version="1.0" encoding="utf-8"?>
<Message Session="ftpkk5awn4fvnjydhccmhx45" xmlns="">
<Answer Result="True" Code="0" Error="0" Message="" />
<Transaction RefNo="193399" OrgNo="2" Type="PreSale">
<ShowDetails No="130535" Numbered="True">
<MovieID>5228</MovieID>
<MovieName>Public Enemies</MovieName>
<LanguageVersion>Orig. vers. med danske undertekster</LanguageVersion>
<AuditoriumID>5</AuditoriumID>
<AuditoriumName>Sal 3</AuditoriumName>
<CinemaID>2</CinemaID>
<CinemaName>Hans's Biograf</CinemaName>
<Time Date="149876" Time="57600">07-05-2010 16:00:00</Time>
<AnnouncementDate />
</ShowDetails>
<Tickets Price="200">
<Ticket No="122680" Name="Normal billettype" Count="2" />
<Ticket No="122696" Name="50% Rabat" Count="1" />
</Tickets>
<Concessions Price="200,58">
<Item No="87" Exclusive="True" Name="Hold k�ft bolsjer" Count="2" />
</Concessions>
<Seats Location="Sal 3">
<Seat Name="8" Row="5" />
<Seat Name="10" Row="5" />
<Seat Name="12" Row="5" />
</Seats>
<Amounts Total="410,25">
<Tickets>200,00</Tickets>
<Concessions>200,58</Concessions>
<Fees Total="9,67">
<Ticket>8,00</Ticket>
<EbilletCard>0,00</EbilletCard>
<CreditCard>1,67</CreditCard>
</Fees>
</Amounts>
<OrderId>280410SFB095042</OrderId>
</Transaction>
<Dibs>
<Url>https://payment.architrade.com/paymentweb/start.action</Url>
<Parameters>
<merchant>2735385</merchant>
<skiplastpage>yes</skiplastpage>
<paytype>DK</paytype>
<test>yes</test>
<account>test</account>
<amount>41025</amount>
<currency>208</currency>
<orderid>280410SFB095042</orderid>
<uniqueoid>yes</uniqueoid>
<orderinfo01>Antal</orderinfo01>
<orderinfo02>Beskrivelse</orderinfo02>
<orderinfo11>2</orderinfo11>
<orderinfo12>billet</orderinfo12>
<ticket_count>3</ticket_count>
<arrangement_name>Public Enemies</arrangement_name>
<arrangement_date>07.05.2010</arrangement_date>
<arrangement_time>16:00</arrangement_time>
<price_header>Billet m.m.</price_header>
<location_name>Hans's Biograf (Sal 3)</location_name>
<location_address>Papirfabrikken 10</location_address>
<location_zip>8600</location_zip>
<location_city>Silkeborg</location_city>
<location_country />
<price_exfee>408,58</price_exfee>
<price_fee>1,67</price_fee>
</Parameters>
</Dibs>
</Message>
Return value, Code
-1 | Suspicious error |
0 | No code |
1 | Cardholder or user exist |
2 | External error |
3 | Unable to login |
4 | Login is required for access |
5 | Unsupported protocol |
6 | Cardholder or user does not exist |
7 | Internal exception |
8 | Insufficient email. |
9 | Key is not matching existing data of the cardholder |
10 | Unable to load cardholder data |
11 | Unable to initialize internal object with arrangement |
12 | Unable to load organizer specific data |
13 | Internal error. The service failed to load club profile entries for cardholder |
14 | Session has timed out |
15 | To many sublocations, system can only handle one |
16 | Inconsistent transactionid. The transactionid must match the one retrieved from the previous call |
17 | Unable to preplace the reservation/purchase |
18 | Inconsistent organizer and/or arrangement. Numbers must match the numbeers from previous calls |
19 | Invalid phone number. The number does no observe the rules dictated by the organizer |
20 | Invalid user name. The name contains invalid characters |
21 | Invalid password. The password may only consist of following characters: a-z, A-Z and 0-9 |
22 | Suspicious hostaddress |
23 | To many ticket has been selected |
24 | Suspicius attempt to delete reservation |
25 | Unable to delete reservation |
26 | Wrong country format. Country must have following syntax: "<2 ch country code> - |
27 | The transaction has already been booked/bought |
28 | This buy method is not supported by the organizer |
29 | Unable to prebuy pending transaction |
30 | Unable to buy pending transaction |
31 | Unable to cancel pending transaction |
32 | Check af transaktionen hos betalingsgateway rapporterer mistænksomhed |
33 | Unable to load cardholders data |
34 | Unknown creditcard type |
35 | Unable to perform the reservation |
36 | Unable to authorize the transaction in the local database |
37 | Inconsistent session data. Some of the parameter does not match parameters in the previous call |
38 | Unable to get history (reservations and purchases) |
39 | Authorized amount does not match the complete price |
40 | Unable to activate reservation |
41 | Unable to load card |
42 | Unable to insert bonus history |
43 | No bonus profile found for the specific organizer |
44 | To many pbonus profiles has been found |
45 | The specific cardholder is not member of the this group |
46 | Cardholder doesn't possess any profiles/memberships |
47 | The cardnumber is not valid |
48 | Customer has selected to many exclusive/bonus tickets that available |
49 | Customer has been given signon-bonus previously |
50 | More that 1 user exist with that id |
51 | Invalid email. Didn't pass the syntax check |
52 | Suspicius attept to change data of an user |
53 | Access to arrangement is not allowed |
54 | Missing Nordisk Film account or password |
Return value, Error
-1 | Suspicious error |
0 | No error |
32 | Du har været for længe om at indtaste data, eller vælge sæder. Den midlertidig reservation af billetterne er derfor forældet. Gå tilbage og prøv igen |
33 | Du har været for længe om at indtaste data, eller vælge sæder. Den midlertidig reservation af billetterne er derfor forældet. Gå tilbage og prøv igen |
52 | Det ønskede antal pladser er desværre ikke ledige til denne forestilling |
53 | Move seats error |
60 | På grund af forbindelses-nedbrug er billetterne blevet købt til anden side |
68 | Det ønskede antal pladser er desværre ikke ledige til denne forestilling |
279 | Buy web reservation error |
445 | Den øvre grænse for speciel billetter er overskredet for dette område |
446 | Den øvre grænse for internet salg er overskredet |
472 | Det er ikke muligt at reservere/købe til dette arrangement |
473 | Det er ikke muligt at have flere reservationer til samme arrangement med det samme telefon nummer. Slet eventuelt den eksisterende reservation og opret en ny med det ønskede antal |
474 | Det er ikke muligt at købe og reservere til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
475 | Det er ikke muligt at købe til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
476 | Det er ikke muligt at reservere til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
479 | Du har allerede én reservation til denne film. Hvis du vil foretage anden reservationer til samme film, skal den eksisterende først slettes |
480 | Intern databasefejl |
10001 | Unable to connect to organizer |
10004 | Det er ikke muligt, at kontakte billet-udbyderens billet system. Prøv igen lidt senere |
10006 | Du har brugt alle dine eksklusiv billetter |
10007 | Dit køb er allerede blevet sat i værk. Kontrollér indholdet af dit ebillet-kort på www.ebillet.dk hvis der hersker nogen tvivl om hvorvidt købet er gennemført |
2000 | Adgang nægtet |
2001 | Kupon er ikke oprettet |
2002 | Kupon er låst af anden bruger |
2003 | Kuponen er udløbet |
2004 | Kupon er allerede brugt |
2005 | Gavekortet/voucheren med den pågældende Stregkode eksisterer allerede |
2006 | Der er fundet multible gavekort/vouchere med den pågældende barcode |
2008 | Gavekortet med den pågældende stregkode eksisterer allerede |
2009 | Der er fundet multible gavekort med den pågældende barcode |
2010 | Det er ikke tilladt at indløse kuponen hos den pågældende arrangør |
2010 | Gavekortet ({0}) er ikke oprettet |
2011 | Gavekort er udløbet |
2012 | Gavekort er allerede brugt |
2013 | Kuponen stemmer ikke overens med tilknyttede film |
2014 | Kuponen kan ikke benyttes til den valgte film. Kontakt eventuelt supervisor, hvis dette er en fejl |
2007 | Der er ikke nok penge tilbage på kortet |
800 | Kupondata er returneret, men kuponen er ikke aktiv |
920 | Kupon er ikke aktiv |
921 | Gavekortet er ikke aktivt |
922 | Kuponen er taget ud af salg og derfor ikke gyldig |
950 | Kupon er ikke fundet |
3000 | Du har ikke nok rettigheder til at udføre denne handling |
801 | XML feed'et er ikke som forventet |
802 | Voucher rod. Muligvis stemmer stregkode ikke overens med indløsningsmulighederne |
803 | Ugyldig stregkode |
3001 | Det var ikke muligt at refundere voucheren |
3002 | Det var ikke muligt at logge ind |
3003 | Denne type er ikke supporteret |
3004 | Der mangler configurationdata |