Home

IPG Integrationsleitfaden API

1. SE o o o v1 Billing v1 Company SECH Weg m ool op a fele SEA Nep YE ool I ool SE SPE j elele Shipping v1 Type Shipping Name v1 Shipping v1 Address1 v1 Shipping v1 Address2 v1 Shipping v1 City v1 Shipping v1 State v1 Shipping v1 Zip v1 Shipping v1 Country v1 TopUpTxType v1 MPCharge v1 MNSP v1 TopUpTxType v1 MPCharge v1 MSISDN v1 TopUpTxType v1 MPCharge v1 PaymentType IPG Integrationsleitfaden API Version 4 SCH First Data v1 ClientLocale v1 Language v1 ClientLocale v1 Country ClickandBuy all paths relative to ipgapi IPGApiOrderRequest vl Transaction PostAuth PostAuth Gutschrift v1 CreditCardTxType v1 Type v1 CreditCardData v1 CardNumber v1 CreditCardData v1 ExpMonth v1 CreditCardData v1 ExpYear v1 CreditCardData v1 CardCodeValue v1 CreditCardData v1 TrackData v1 CreditCard3DSecure v1 VerificationResponse v1 CreditCard3DSecure v1 PayerAuthenticationResponse v1 CreditCard3DSecure v1 AuthenticationValue v1 CreditCard3DSecure v1 XID v1 ClickandBuyTxType v1 Type v1 ClickandBuyData cab OrderDetails V1 PayPalTxType V1 Type m m m m v1 Payment v1 HostedDatalD v1 Payment vi HostedDataStorelD v1 Payment v1 DeclineHostedDataDuplicates
2. request setRequestHeader Content Type text xml setting the credentials request setCredentials WS10036000750 _ 1 testinger 0 gt lt body gt lt html gt Bitte beachten Sie dass das obige Skript im n chsten Kapitel um die Einstellung der Sicherheitsoptionen erweitert wird die f r den Aufbau eines SSL Kanals erforderlich sind IPG Integrationsleitfaden API Version 4 88 SCH First Data 14 SSL Verbindung aufbauen Vor dem Versand der HTTP Anfrage deren Erstellung im vorangehenden Kapitel beschrieben wurde muss ein sicherer Kommunikationskanal aufgebaut werden Er garantiert dass s mtlich bermittelten Daten verschl sselt sind und dass Client Ihre Applikation wie Server auf dem der First Data Austria API Web Service l uft sicher sein k nnen miteinander und mit sonst niemandem zu kommunizieren Beides wird durch den Aufbau einer SSL Verbindung zwischen Client und Server erreicht die Zertifikate austauschen Ein Zertifikat identifiziert eindeutig einen Kommunikationspartner Dieser Prozess l uft grunds tzlich wie folgt ab 1 Der Client leitet den Aufbau einer sicheren Verbindung ein indem er sein Client Zertifikat an den Server sendet 2 Der Server nimmt das Client Zertifikat entgegen und gleicht es mit dem Client Zertifikat ab das er f r diesen Client gespeichert hat 3 Ist es g ltig antwortet der Server indem er sein Server Zertifikat sendet 4 Der Client nim
3. IPG Integrationsleitfaden API Version 4 60 SCH First Data v1 Payment v1 ChargeTotal v1 Payment m m v1 Currency v1 TransactionDetails v1 Orderld v1 TransactionDetails v1 lp v1 TransactionDetails v1 ReferenceNumber v1 TransactionDetails v1 Tdate v1 TransactionDetails v1 TransactionOrigin v1 TransactionDetails v1 InvoiceNumber v1 TransactionDetails v1 PONumber v1 TransactionDetails v1 DynamicMerchantName v1 TransactionDetails o vi Comments v1 Billing v1 CustomerlD Billing Name Billing v1 Company v1 Billing v1 Address1 v1 Billing v1 Address2 v1 Billing v1 City Billing State Billing v1 Zip v1 Billing v1 Country Billing Phone Billing Fax Billing Email IPG Integrationsleitfaden API Version 4 61 r First Data v1 Shipping o v1 Type v1 Shipping o vi Name v1 Shipping o v1 Address1 v1 Shipping o v1 Address2 v1 Shipping o v1 Gity v1 Shipping o v1 State v1 Shipping o v1 Zip v1 Shipping o v1 Country v1 TopUpTxType v1 MPCharge v1 MNSP v1 TopUpTxType v1 MPCharge v1 MSISDN v1 TopUpTxType v1 MPCharge v1 PaymentType v1 ClientLocale v1 Language v1 ClientLocale v1 Country 9 2 Beschreibungen der XML Tags 9 2 1 CreditCardTxType
4. ds lt xs sequence gt lt xs sequence gt lt xs element name CLickandBuyTxType type v1 CLickandBuyTxType gt lt xs element name CLickandBuyData type v1 CLickandBuyData minOccurs J gt lt xs sequence gt lt xs sequence gt lt xs element name PayPalTxType type v1 PayPalTxType gt lt xs sequence gt lt xs seguence gt lt xs element name SofortTxType type v1 SofortTxType gt lt xs seguence gt lt xs seguence gt lt xs element name TopUpTxType type v1 TopUpTxType gt lt xs sequence gt lt xs choice gt lt xs element ref v1 Payment minOccurs gt lt xs element name TransactionDetails type v1 TransactionDetails minOccurs gt lt xs element ref v1 Billing minOccurs gt lt xs element ref v1 Shipping minOccurs gt lt xs element ref v1 CLientLocale minOccurs gt IPG Integrationsleitfaden API Version 4 102 SCH First Data lt xs element ref v1 Basket minOccurs 0 gt lt xs sequence gt lt xs complexType gt gt lt Options gt lt l ee gt lt xs complexType name TopUpTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs choice gt lt xs element name MPCharge gt lt xs complexType
5. 9 2 4 ClickandBuyTxType Path Name XML Schema type Description vl ClickandBuyTxType vl Type xs string Stores the transaction type Possible values are postAuth return credit and void 9 2 5 ClickandBuyData Path Name XML Schema type Description vl ClickandBuyData cab OrderDetails Xs complexType Stores detailed order information See http integration clickandbuy community com or the ClickandBuy xsd which is part of the IPG API wsdl PayTypes 1 0 0 xsd SOAPTypes 1 0 0 xsd 9 2 6 PayPalTxType Path Name XML Schema type Beschreibung vl PayPalTxType vl Type xs string Speichert die Transaktionsarten Reservierung R ckzahlung Gutschrift und Storno 9 2 7 Payment Pfad Name XML Schematyp Beschreibung vl Payment vl HostedDataID xs string Speichert die Hosted Data ID f r die Erweiterungsfunktion Data Storage vl Payment vl HostedDataStoreID xs string Speichert die Hosted Data Store ID f r die Erweiterungsfunktion Data Storage nur als technischer User vil Payment xs string Erm glicht das Sperren der Verwendung IPG Integrationsleitfaden API Version 4 64 r First Data vl DeclineHostedDataDuplic ates von gleichen Zahlungsinformationen f r mehrere Datens tze bei der Erweiterungsfunktion Data Storage vl Payment vl ChargeTotal x
6. Pfad Name XML Beschreibung Schematyp vl CreditCardTxType xs string Speichert den Transaktionstyp M gliche vi Type Werte sind sale forceTicket preauth postAuth return credit and void IPG Integrationsleitfaden API Version 4 62 SCH First Data 9 2 2 CreditCardData Pfad Name XML Beschreibung Schematyp vl CreditCardData xs string Speichert die Kreditkartennummer des vl CardNumber Kunden Vergewissern Sie sich dass diese Zeichenfolge nur Ziffern enth lt Die bermittlung der Nummer beispielsweise im Format xxXxX XXXX XXXX XXXX wurde zur R ckgabe eines Fehlers durch den First Data Austria API Web Service f hren vl CreditCardData xs string vl ExpMonth Speichert den Ablaufmonat der Kreditkarte des Kunden Vergewissern Sie sich dass dieses Element immer genau zwei Ziffern enth lt Eine Karte mit Ablaufdatum im Juli w rde bedeuten dass das dieses Element den Wert 07 enth lt vl CreditCardData xs string vl ExpYear Speichert das Ablaufjahr der Kreditkarte des Kunden Es gelten die gleichen Formatvorschriften wie f r das Element vl ExpMonth vl CreditCardData xs string vl CardCodeValue Speichert die drei oder vierstellige Kartenpr fnummer CVC CVV Sie ist meist auf der R ckseite der Karte aufgedruckt vl CreditCardData xs string vl TrackData Speichert die Spurdaten des Magnetstreifens bei Erfassung der Kartendaten mittels Kartenles
7. gt lt xs element name ExchangeRate type xs decimal minOccurs maxOccurs 1 gt lt xs element name DccApplied type xs boolean minOccurs maxOccurs 1 gt lt xs element name DccOffered type xs boolean minOccurs maxOccurs 1 gt lt xs element name ExpirationTimestamp type xs dateTime minOccurs 0 maxOccurs 1 gt lt xs element name MarginRatePercentage type xs decimal minOccurs 0 maxOccurs 1 gt lt xs element name ExchangeRateSourceName type v1 String32max minOccurs 0 maxOccurs 1 gt lt xs element name ExchangeRateSourceTimestamp type xs dateTime minOccurs maxOccurs 1 gt lt xs sequence gt lt xs complexType gt KI gt lt simple types gt lt l gt IPG Integrationsleitfaden API Version 4 143 SCH First Data lt xs simpleType name StringDate gt lt xs restriction base xs string gt lt YYYYMMDD gt lt xs pattern value 0 9 8 gt lt xs restriction gt lt xs simpleType gt lt xs schema gt IPG Integrationsleitfaden API Version 4 144 a First Data Fehleranalyse Merchant Exceptions Premature end of message lt detail gt XML is not wellformed Premature end of message lt
8. lt vl CreditCardData gt lt vl Payment gt lt vl ChargeTotal gt 19 00 lt vl ChargeTotal gt lt vl Currency gt 978 lt vl Currency gt lt v1 Payment gt lt v1 Transaction gt lt ipgapi IPGApiOrderRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Kurz gesagt enthalt die SOAP Anfragenachricht einen SOAP Envelope der aus einem Header und einem Body besteht Fur den Aufruf des Web Service sind keine speziellen Header Eintr ge erforderlich Der SOAP Body enth lt wie oben gezeigt als Subelement das XML Transaktionsdokument Bitte beachten Sie dass f r Transaktionen eines anderen Typs als Sale keine weitergehenden Anforderungen bestehen Damit sieht das allgemeine Format einer SOAP Anfragenachricht unabh ngig vom eigentlichen Transaktionstyp wie folgt aus lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiOrderRequest xmlns ipgapi http ipg online com ipgapi schemas ipgapi xmlns vl http ipg online com ipgapi schemas v1 gt lt vl Transaction gt lt transaction content gt lt v1 Transaction gt lt ipgapi IPGApiOrderReguest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt IPG Integrationsleitfaden API Version 4 69 SCH First Data Wie Sie sicher bemerkt haben gibt es keine spezifischen Eintr ge dar ber welche Web Service
9. lt ns2 PaymentType gt JCB lt ns2 PaymentType gt lt ns2 MPCharge gt lt ns2 TopUpTxType gt lt ns2 Payment gt lt ns2 ChargeTotal gt 15 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns2 Currency gt lt ns2 Payment gt lt ns2 Transaction gt lt ns4 IPGApiOrderRequest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel Ubersicht der XML Tags IPG Integrationsleitfaden API Version 4 56 SCH First Data 9 bersicht der XML Tags 9 1 bersicht nach Transaktionstyp Die folgende Tabelle zeigt f r jeden Transaktionstyp welche XML Tags bermittelt werden m ssen und welche optional verwendet werden k nnen Bitte verwenden Sie ausschlie lich hier angegebene Felder und beachten Sie die dargestellte Reihenfolge Verwendete Abk rzungen m Pflichtfeld o optional d optional mit Vorgabewert a und b maximal eine der beiden Angaben 1 wenn a oder b angegeben wurde optional Pflichtfeld wenn a und b nicht angegeben wurden 3 Pflichtfeld f r 3D Secure Transaktionen s N here Details im Abschnitt CreditCard3DSecure Kreditkarte alle Pfadangaben relativ zu ipgapi IPGApiOrderReguest g lt vl Transaction T o g 8 15 op LL A A O gt v1 CreditCardTxType m m m m mam m v1 Type v1 CreditCardData v1 CardNumber a 2 a v1 CreditCardData v1 ExpMonth a a a S v1 CreditCardD
10. Beschreibung faultcode xs string Dieses Element wird immer auf SOAP ENV Client gesetzt und zeigt an dass die Fehlerursache wahrscheinlich in ung ltigen bermittelten Transaktionsdaten zu finden ist faultstring xs string Dieses Element enth lt immer den Fehlerstring ProcessingException detail ipgapi IPGApiOrderResponse Zusammengesetztes Element Dieses Element enth lt die vom Kreditkartenprozessor zur ckgelieferte Fehlerbeschreibung Da es viele Gr nde f r das Ausl sen einer solchen Ausnahme gibt enth lt das folgende Kapitel eine bersicht zu den in diesem Element enthaltenen Daten Detaillierte Informationen zu einigen Fehlerursachen finden Sie im Abschnitt Processing Exceptions im Anhang IPG Integrationsleitfaden API Version 4 81 r First Data 12 Transaktionsergebnis auswerten 12 1 Erfolgreiche Transaktionen Der Statusbericht zu einer Transaktion wie er vom Internet Payment Gateway erstellt wird ist im Element ipgapi IPGApiOrderResponse enthalten und kann als die Daten verstanden werden die von der Web Service Operation zur ckgeliefert werden Nachfolgend sind seine Elemente relativ zum bergeordneten Element ipgapi IPGApiOrderResponse beschrieben Bitte beachten Sie dass die Antwort immer den vollen Bestand dieser Elemente enth lt auch wenn einige von ihnen eventuell leer sind Pfad Name XML Schematyp Beschreibung ipgapi xs
11. basic user WS101 1 myPW setting the request body with your SOAP message this automatically marks the request as POST Sdata data Sbody gt 13 2 ASP F r die Erstellung einer HTTP Anfrage in ASP gibt es mehrere Wege Nachfolgend ist hierzu die Verwendung von WinHTTP 5 1 beschrieben da es Bestandteil von Windows Server 2003 und Windows XP SP2 ist Au erdem werden nur wenige Codezeilen ben tigt um eine g ltige HTTP Anfrage zu erstellen Bitte beachten Sie dass das nachfolgende Codefragment in JavaScript verfasst ist Wenn Sie stattdessen VB Script verwenden ndern sich die gezeigten Statements nicht grundlegend lt language javascript gt lt html gt lt body gt lt storing the SOAP message in a variable note that the plain XML code is passed here as string for reasons of simplicity however it is certainly a good practice to build the XML e g with DOM furthermore when using special characters you should make sure that the XML string gets UTF 8 encoded which is not done here var body lt SOAP ENV Envelope gt lt SOAP ENV Envelope gt constructing the request object var request Server createObject WinHttp WinHttpRequest 5 1 initializing the request object with the HTTP method POST and the IPG API URL request open POST https test ipg online com ipgapi services setting the content typ
12. lt al TransactionValues gt lt al TransactionValues gt lt v1 CreditCardTxType gt lt v1 Type gt periodic lt v1 Type gt lt v1 CreditCardTxType gt lt v1 CreditCardData gt lt v1 CardNumber gt 403587 4977 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt v1 ExpYear gt 14 lt v1 ExpYear gt lt v1 Brand gt VISA lt v1 Brand gt lt v1 CreditCardData gt lt v1 Payment gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt v1 TransactionDetails gt lt v1 OrderId gt A 52421c39 69c4 4b2d 959d 9fdcd3a9428a lt v1 0OrderId gt lt v1 TDate gt 1497373209 lt v1 TDate gt lt v1 TransactionDetails gt IPG Integrationsleitfaden API Version 4 39 SCH First Data lt ipgapi IPGApiOrderResponse gt lt ipgapi ApprovalCode gt Y 416502 0014750513 PPXM 4625106408 lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt PPX lt ipgapi AVSResponse gt lt ipgapi Brand gt VISA lt ipgapi Brand gt lt ipgapi OrderId gt A 52421c39 69c4 4b2d 959d 9fdcd3a9428a lt ipgapi OrderId gt lt ipgapi PaymentType gt CREDITCARD lt ipgapi PaymentType gt lt ipgapi ProcessorApprovalCode gt 416502 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 6408 lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorCCVResponse gt M lt ipgapi ProcessorCCVResponse gt lt ipgapi ProcessorTraceNumber gt 462510 lt ipgapi ProcessorTraceNumber
13. lt v1 Item gt lt v1 Basket gt lt v1 Billing gt lt v1 Shipping gt lt al TransactionValues gt lt v1 CreditCardTxType gt lt v1 Type gt sale lt v1 Type gt lt v1 CreditCardTxType gt lt v1 CreditCardData gt lt v1 CardNumber gt 403587 4977 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt v1 ExpYear gt 14 lt v1 ExpYear gt lt v1 Brand gt VISA lt v1 Brand gt lt v1 CreditCardData gt lt v1 Payment gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt v1 TransactionDetails gt lt v1 OrderId gt API Test b9dfe857 7df9 4b46 bd48 9879adec3289 InquiryOrderTest testBasket 305 lt v1 OrderId gt lt v1 TDate gt 1382020626 lt v1 TDate gt lt v1 TransactionOrigin gt ECI lt v1 TransactionOrigin gt lt v1 TransactionDetails gt IPG Integrationsleitfaden API Version 4 33 SCH First Data lt ipgapi IPGApiOrderResponse gt lt ipgapi ApprovalCode gt Y 194737 0095905551 PPXM 1338513274 lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt PPX lt ipgapi AVSResponse gt lt ipgapi Brand gt VISA lt ipgapi Brand gt lt ipgapi OrderId gt API Test b9dfe857 7df9 4b46 bd48 9879adec3289 InquiryOrderTest testBasket 3 5 lt ipgapi OrderId gt lt ipgapi PaymentType gt CREDITCARD lt ipgapi PaymentType gt lt ipgapi ProcessorApprovalCode gt 194737 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 3274 lt
14. lt ns2 TransactionDetails gt lt ns2 OrderId gt 68d4a595 fd58 4859 83cd 1ae13962a3ac lt ns2 OrderId gt lt ns2 TransactionDetails gt lt ns2 Basket gt lt ns2 Item gt lt ns2 ID gt product ID xyz lt ns2 ID gt lt ns2 Description gt description of abc lt ns2 Description gt lt ns2 ChargeTotal gt 11 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns2 Currency gt lt ns2 Quantity gt 5 lt ns2 Quantity gt lt ns2 Option gt lt ns2 Name gt colour lt ns2 Option gt lt ns2 Choice gt blue lt ns2 Choice gt lt ns2 Option gt lt ns2 Option gt lt ns2 Name gt size lt ns2 Option gt lt ns2 Choice gt large lt ns2 Choice gt lt ns2 Option gt lt ns2 Item gt lt ns2 Basket gt lt ns2 Transaction gt lt ns5 IPGApiOrderRequest gt 6 9 2 Einen Produktkatalog aufsetzen Basisinformationen ber Ihre Produkte k nnen folgenderma en mitgeliefert werden lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 IPG Integrationsleitfaden API Version 4 46 SCH First Data xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns3 Action gt lt ns3 ManageProducts gt lt ns3 Function gt store lt ns3 Function gt lt ns3 Product gt lt ns3 ProductID gt product ID xyz lt ns3 ProductID gt lt ns2 ChargeTotal gt 2 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns
15. lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt void lt vl Type gt lt v1 CreditCardTxType gt lt v1 TransactionDetails gt lt vl OrderId gt 62e3b5df 2911 4e89 8356 1e49302b1807 lt v1 OrderId gt lt v1 TDate gt 1190244932 lt v1 TDate gt lt v1 TransactionDetails gt lt v1 Transaction gt lt ipgapi IPGApiOrderReguest gt IPG Integrationsleitfaden API Version 4 16 SCH First Data Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Originaltransaktion genutzt wurde nutzen Sie Void mit einem beliebigen TxType welcher Voids unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderID und TDate Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel Ubersicht der XML Tags Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Originaltransaktion genutzt wurde nutzen Sie Void mit einem beliebigen TxType welcher Voids unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderID und TDate Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel bersicht der XML Tags IPG Integrationsleitfaden API Version 4 17 SCH First Data 5 2 ClickandBuy 5 2 1 Wiederkehrende Bezahltransaktionen Nach einer wiederkehrenden Bezahltransaktion f r Cli
16. vl Country bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten 9 2 11 TopUpTxType Pfad Name XML Beschreibung Schematyp vl TopUpTxType xs string Speichert den Mobilfunknetzbetreiber Folgende Werte sind g ltig b T Mobile IPG Integrationsleitfaden API Versio n4 67 SCH First Data v1 MPCharge vl MNSP D2 Vodafone EP E Plus vi O2 vl TopUpTxType v1 MPCharge v1 MSISDN xs string Speichert die Mobilfunknummer die f r die Aufladung verwendet werden soll vl TopUpTxType v1 MPCharge vl PaymentType xs string Speichert die Zahlungsweise ggf separate Transaktion G ltige Werte sind Amex Cash Barzahlung Diners ECMC MasterCard JCB VISA 9 2 12 ClientLocale Pfad Name XML Schematyp Beschreibung vl ClientLocale vl Language xs string Wenn Sie die eMail Benachrichtigungs funktion benutzen wird diese Sprache f r die Kundenbenachrichtigung genutzt M gliche Werte sind de en it vl ClientLocale vl Country xs string Spezifiziert die Sprachvarianten Dieser Wert kann nur gestezt werden wenn vi Language gesetzt ist M gliche Werte sind DE GB IT Wenn Sie v1 Country nicht setzen wird ein passender Wert gew hlt Wenn Sie keine Sprachinformationen bergeben wird die Spracheinstellung aus Ihrem Webshop f r die eMail Benachrichtigunge
17. 4 DE A Z0 9 A NP Z0 9 XXXx A WY Z0 9 A Z0 9 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name AccountNumber gt lt xs simpleType gt lt xs restriction base xs string gt xs pattern value 9 1 10 DE 9 2 9 8 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs seguence gt lt xs choice gt lt xs element ref v1 MandateReference minOccurs gt lt xs element ref v1 MandateType minOccurs 0 gt lt xs sequence gt lt xs complexType gt lt xs element name MandateReference gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value A Za z 9 VWV 1 35 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name MandateType default SINGLE gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value SINGLE gt IPG Integrationsleitfaden API Version 4 109 SCH First Data lt xs enumeration value RECURRING_COLLECTION gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt deprecated gt lt xs complexType name UK DebitCardData gt lt xs seguence gt lt xs group ref v1 Card gt lt xs choice gt lt xs element name CardCodeValue type v1 CardCodeValue gt lt xs element name IssueNo gt lt xs simpleType gt lt xs rest
18. H1 font family Tahoma Arial sans serif color white background color 525D76 font size 22px H2 font family Tahoma Arial sans serif color white background color 525D76 font size 16px H3 font family Tahoma Arial sans serif color white background color 525D76 font size 14px BODY font family Tahoma Arial sans serif color black background color white B font family Tahoma Arial sans serif color white background color 525D76 P font family Tahoma Arial sans serif background white color black font size 12px A color black A name color black HR color 525D76 gt lt style gt lt head gt lt body gt lt h1 gt HTTP Status 401 lt h1 gt lt HR size 1 noshade noshade gt IPG Integrationsleitfaden API Version 4 156 SCH First Data lt p gt lt b gt type lt b gt Status report lt p gt lt p gt lt b gt message lt b gt lt u gt lt u gt lt p gt lt p gt lt b gt description lt b gt lt u gt This request requires HTTP authentication lt u gt lt p gt lt HR size 1 noshade noshade gt lt h3 gt Apache Tomcat 5 5 20 lt h3 gt lt body gt lt html gt Erklarung Das Zertifikat ist in Ordnung jedoch sind User oder Passwort falsch Fehleranalyse Login Fehler bei der Verwendung des Java Client java io IOException Keystore was tampered with or password was incorrect Erklarung Keystore oder Truststore ist falsch Sie k nnen das Passwort mit dem Keytool
19. PolicyQualifierInfo qualifiers 153 6 1 5 596 762 2 qualifier 0000 30 1E 1A 1C 68 74 74 70 73 3A 2F 2F 77 77 77 2E 0 https www 0010 76 65 72 69 73 69 67 6E 2E 63 6F 6D 2F 72 70 61 verisign com rpa II J 8 ObjectId 2 5 29 35 Criticality false AuthorityKeyldentifier OU VeriSign Trust Network OU c 1998 VeriSign Inc For authorized use only OU Class 3 Public Primary Certification Authority G2 O VeriSign Inc C US SerialNumber 7dd9fe07 cfa8leb7 107967fb a78934c6 9 ObjectId 2 5 29 17 Criticality false SubjectAlternativeName CN Class3CA2048 1 52 k k k k k k K K k k x KKK k k k K K K K k x x x K K x K k x K lt K KRAKK amp k k k k k k k k K K K K k k k k K K k k k k K k k K k k k k K k k k k k K KK lt html gt lt head gt lt title gt Apache Tomcat 5 5 20 Error report lt title gt lt style gt lt Hl font family Tahoma Arial sans serif color white background color 525D76 font size 22px H2 font family Tahoma Arial sans serif color white background color 525D76 font size 16px H3 font family Tahoma Arial sans serif color white background color 525D76 font size 14px BODY font family Tahoma Arial sans serif color black background color white B font family Tahoma Arial sans serif color white background color 525D76 P font family Tahoma Arial sans serif background white color black font size 12px A color black A name color black H
20. This vl Country member can only be set if the language is set Possible values are DE GB IT If you do not define a country a matching IPG Integrationsleitfaden API Version 4 75 SCH First Data country will be chosen IPG Integrationsleitfaden API Version 4 76 SCH First Data 11 SOAP Antwortnachricht lesen Die SOAP Antwortnachricht kann man als das Resultat der Web Service Operation betrachten Die Verarbeitung der SOAP Anfragenachricht kann darum entweder im Erfolgsfall zu einer SOAP Antwortnachricht d h dem zur ckgelieferten Parameter f hren oder im Fehlerfall d h bei Ausl sen einer Ausnahme zu einer SOAP Fehlermeldung Beide SOAP Nachrichtentypen sind im Body der HTTP Antwortnachricht enthalten 11 1 SOAP Antwortnachricht Eine SOAP Antwortnachricht wird als Resultat empfangen wenn der Kreditkartenprozessor vom First Data Austria Internet Payment Gateway angefragt Ihre Transaktion genehmigt hat Die Mitteilung folgt dem Schema lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt 1 transaction result gt lt ipgapi IPGApiOrderResponse gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Haben Sie eine Action geschickt erhalten Sie eine ipgapi
21. der xsd beschrieben The processing instruction target matching xX lt detail gt XML is not wellformed The processing instruction target matching xX mM 1L is not allowed lt detail gt M gliche Erkl rung Die gesamte Nachricht muss eine korrekte XML Nachricht sein sodass die IPG API Nachricht kein lt xml gt enthalten darf Unexpected characters before XML declaration lt detail gt Unexpected characters before XML declaration lt detail gt M gliche Erkl rung Die XML Nachricht muss mit lt xml beginnen Bitte berpr fen Sie ob ggf eine Leerzeile oder ein Leerzeichen zu Beginn stehen Unable to create envelope from given source lt detail gt XML is not a SOAP message Unable to create envelope from given source because the root element is not named Envelope lt detail gt M gliche Erkl rung Die SOAP Nachricht ist nicht korrekt Error with the determination of the type lt detail gt XML is not a valid SOAP message Error with the determination of the type Probably the envelope part is not correct lt detail gt M gliche Erkl rung Das SOAP Body Tag fehlt Source object passed to 0 has no contents lt detail gt IPG Integrationsleitfaden API Version 4 147 First Data Source object passed to 0 has no contents lt detail gt M gliche Erkl rung Das SOAP Body Tag ist leer unsupported top level namespace tag lt d
22. detail gt M gliche Erkl rung Sie haben eine leere Nachricht gesendet Content is not allowed in prolog lt detail gt XML is not wellformed Content is not allowed in prolog lt detail gt M gliche Erkl rung Die Nachricht kann nicht als XML interpretiert werden document structures must start and end within the same entity lt detail gt XML is not wellformed XML document structures must start and end within the same entity lt detail gt M gliche Erkl rung Die Nachricht beginnt wie eine XML Nachricht enth lt jedoch kein End Tag nach dem ersten Open Tag The element type SOAP ENV Body must be terminated lt detail gt XML is not wellformed The element type SOAP ENV Body must be terminated by the matching end tag amp lt SOAP ENV Body amp gt lt detail gt M gliche Erkl rung Ein End Tag zu einem Open Tag fehlt Im obigen Beispiel fehlt das End Tag lt SOAP ENV Body gt Element type irgend must be followed by either attribute lt detail gt XML is not wellformed Element type irgend must be followed by either attribute specifications amp gt or amp gt R lt detail gt IPG Integrationsleitfaden API Version 4 145 SCH First Data M gliche Erkl rung Bei der Nachricht handelt es sich nicht um korrektes XML Open quote is expected for attribute xmins ns3 lt detail gt XML is not wellformed Open quote is expected for attribute xmlns ns3 asso
23. e gt lt main e gt gt lt l e gt lt xs element name Transaction type v1 Transaction gt lt xs complexType name Transaction gt lt xs seguence gt lt xs choice gt lt xs seguence gt lt xs element name CreditCardTxType type v1 CreditCardTxType gt lt xs choice gt lt xs seguence gt lt xs element name CreditCardData type v1 CreditCardData minOccurs 9 ZS lt xs element ref v1 CreditCard3DSecure minOccurs 0 gt IPG Integrationsleitfaden API Version 4 101 a FirstData lt xs sequence gt lt xs element ref v1 EMVCardPresentRequest gt lt xs choice gt lt xs sequence gt lt xs sequence gt lt xs element name CustomerCardTxType type v1 CustomerCardTxType gt lt xs element name CustomerCardData type v1 CustomerCardData minOccurs 0 f gt lt xs sequence gt lt xs seguence gt lt xs element name DE DirectDebitTxType type v1 DE DirectDebitTxType gt lt xs element name DE DirectDebitData type v1 DE DirectDebitData minOccurs gt lt xs sequence gt lt xs seguence gt lt deprecated gt lt xs element name UK_DebitCardTxType type v1 UK DebitCardTxType gt lt xs element name UK DebitCardData type v1 UK DebitCardData minOccurs
24. gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name TrackData gt lt xs restriction base xs string gt lt track 1 length track 2 length track 3 length 98 64 107 lt xs pattern value a zA Z 9 1 261 gt lt xs restriction gt lt xs simpleType gt 261 e e e e e e e e s e e e ege gt lt TopUpTxType e e e e e e e e e e e e gt gt b Kl e e e Qa e e e e Q e E a gt lt MobileNetworkServiceProvider gt IPG Integrationsleitfaden API Version 4 111 SCH First Data lt xs element name MNSP gt lt xs simpleType gt lt xs restriction base xs string gt lt Deutsche Telekom gt lt xs enumeration lt Vodafon gt lt xs enumeration lt E gt lt xs enumeration lt 02 gt lt xs enumeration lt xs restriction gt lt xs simpleType gt lt xs element gt value D1 gt value D2 gt value EP gt value VI gt lt xs element name PaymentType gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration lt xs enumeration lt xs enumeration lt xs enumeration lt xs enumeration lt xs enumeration lt xs restriction gt lt xs simpleType gt lt xs element gt value Amex gt value Cash gt value Diners gt value ECMC gt value J
25. gt lt ns3 Action gt lt ns3 StoreHostedData gt lt ns3 DataStorageltem gt lt ns3 Function gt delete lt ns3 Function gt lt ns3 HostedDataID gt 9605c2d1 428c 4de2 940e 4bec4737ab5d lt ns3 HostedDataID gt lt ns3 DataStorageltem gt lt ns3 StoreHostedData gt lt ns3 Action gt lt ns4 IPGApiActionRequest gt Bei erfolgreicher L schung erhalten Sie folgende Antwort lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 IPGApiActionResponse gt IPG Integrationsleitfaden API Version 4 55 SCH First Data 8 Erweiterungsfunktion Pay amp Call Mit der Erweiterungsfunktion Pay amp Call k nnen Sie Prepaid Konten verschiedener Mobilfunkprovider ber das First Data Austria Internet Payment Gateway aufladen First Data Austria API bietet dazu den Transaktionstyp MPCharge bei dem der Netzbetreiber die Mobilfunknummer und der entsprechende Ladebetrag bermittelt werden lt ns4 IPGApiOrderRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas al gt lt ns2 Transaction gt lt ns2 TopUpTxType gt lt ns2 MPCharge gt lt ns2 MNSP gt D1 lt ns2 MNSP gt lt ns2 MSISDN gt 01707616513 lt ns2 MSISDN gt
26. ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorCCVResponse gt M lt ipgapi ProcessorCCVResponse gt lt ipgapi ProcessorTraceNumber gt 133851 lt ipgapi ProcessorTraceNumber gt lt ipgapi TDate gt 1382020626 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2013 10 17 16 37 06 MESZ lt ipgapi TDateFormatted gt lt ipgapi TerminalID gt 54000668 lt ipgapi TerminalID gt lt ipgapi IPGApiOrderResponse gt lt al TransactionState gt CAPTURED lt a1 TransactionState gt lt al UserID gt 1 lt al UserID gt lt al SubmissionComponent gt API lt a1 SubmissionComponent gt lt al TransactionValues gt lt ipgapi OrderValues gt lt ipgapi OrderValues gt lt al OrderId gt API Test 7c59f1cf 24e3 48ae b3fa e7daed007564 InquiryOrderTest testBasket 305 lt a1 OrderId gt lt al OrderDate gt 2013 10 17714 35 26 000102 00 lt a1 OrderDate gt lt v1 Basket gt lt v1 Item gt lt v1 ID gt ID lt v1 ID gt lt v1 Description gt Description lt v1 Description gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Quantity gt 13 lt v1 Quantity gt lt v1 Option gt lt v1 Name gt Name 2 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Option gt lt v1 Name gt Name 1 lt v1 Name gt IPG Integrationsleitfaden API Version 4 34 SCH First Data lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Item gt lt v1 Item gt lt v1 ID gt ID lt v1 ID gt lt v1 Descrip
27. lt v1 TransactionDetails gt lt ipgapi IPGApiOrderResponse gt lt ipgapi ApprovalCode gt Y 666159 8895985550 PPXM 86562808249 lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt PPX lt ipgapi AVSResponse gt lt ipgapi Brand gt VISA lt ipgapi Brand gt lt ipgapi OrderId gt API Test 7c59f1cf 24e3 48ae b3fa e7daed 07564 InquiryOrderTest testBasket 3 5 lt ipgapi OrderId gt lt ipgapi PaymentType gt CREDITCARD lt ipgapi PaymentType gt lt ipgapi ProcessorApprovalCode gt 666159 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 0249 lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorCCVResponse gt M lt ipgapi ProcessorCCVResponse gt lt ipgapi ProcessorTraceNumber gt 065620 lt ipgapi ProcessorTraceNumber gt lt ipgapi TDate gt 1382020526 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2013 10 17 16 35 26 MESZ lt ipgapi TDateFormatted gt lt ipgapi Terminal ID gt 54000669 lt ipgapi TerminalID gt lt ipgapi IPGApiOrderResponse gt lt al TransactionState gt CAPTURED lt a1 TransactionState gt lt al UserID gt 1 lt al UserID gt lt al SubmissionComponent gt API lt a1 SubmissionComponent gt lt a1 TransactionValues gt lt ipgapi OrderValues gt lt ipgapi IPGApiActionResponse gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 4 Getlast Transactions Dieser Befehl gibt Auskunft ber die letzten Transaktionen IPG Integrationsleitfaden API Version 4 36
28. re dies beispielsweise Card expiry date exceeded ipgapi ErrorMessage xs string Speichert die vom Internet Payment Gateway zur ckgelieferte Fehlermeldung Sie folgt immer der Syntax SGS XXXXXX Message wobei XXXXXX ein sechsstelliger Fehlercode ist und Message den Fehler beschreibt diese Beschreibung kann von der Mitteilung des Prozessors abweichen Im Beispiel oben k nnte die Fehlermeldung scs 000033 Card expiry date exceeded zur ckgeliefert werden Halten Sie den Fehlercode und die Mitteilung bereit wenn Sie sich an den Support wenden ipgapi OrderId xs string Speichert die Order ID Im Gegensatz zu einer Genehmigung wird diese Order ID niemals f r eine weitere Transaktion ben tigt jedoch f r die Ermittlung der Fehlerursache Halten Sie darum diese Angabe bereit wenn Sie sich an den Support wenden ipgapi ApprovalCode xs string Im Falle eines Transaktionsfehlers ist dieses Element leer IPG Integrat ionsleitfaden API Version 4 84 r First Data ipgapi AVSResponse xs string Enth lt die Antwort des Adressenverifikationssystems AVS ipgapi TDate xs string Speichert das TDate hnlich wie die Order ID wird das TDate niemals f r eine weitere Transaktion ben tigt jedoch f r die Ermittlung der Fehlerursache Halten Sie darum diese Angabe bereit wenn Sie sich an den Support wenden ipgapi TransactionResult xs string I
29. xs simpleType gt lt xs element gt IPG Integrationsleitfaden API Version 4 120 a FirstData lt xs element name AuthenticationValue minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs string gt lt xs minLength value 20 gt lt xs maxLength value 32 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name XID minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs minLength value 20 gt lt xs maxLength value 32 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name Payment gt lt xs complexType gt lt xs seguence gt lt xs element name HostedDataID type v1 String128max minOccurs gt lt xs element name HostedDataStoreID type v1 String2 max minOccurs 0 gt lt xs element name DeclineHostedDataDuplicates type xs boolean minOccurs default false gt lt xs group ref v1 Amount minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs group name Amount gt lt xs seguence gt lt xs seguence minOccurs gt lt xs element name SubTotal type v1 AmountValueType gt lt xs element name ValueAddedTax type v1 AmountValueType minOccurs 9 gt lt xs element name DeliveryAmount type v1 AmountValueType minOccurs gt lt xs sequ
30. Brand XS string Der Name der Kreditkarte die f r die Transaktion genutzt wurde ipgapi Country XS string Das kartenherausgebende Land 12 2 Fehlerhafte Transaktionen Eine SOAP Fehlernachricht enth lt ein Element ipgapi IPGApiOrderResponse das als Unterelement eines SOAP Elements detail bergeben wird Bitte beachten Sie dass dessen Unterelemente exakt die gleichen wie im Falle einer Transaktionsgenehmigung sind Ihre Bedeutung im Falle eines Fehlers ist nachfolgend erkl rt IPG Integrationsleitfaden API Version 4 83 SCH First Data Pfad Name XML Schematyp Beschreibung ipgapi CommercialServiceProvider xs string Gibt Ihren Provider an ipgapi TransactionTime xs string Zeitstempel des Internet Payment Gateways vor R cklieferung des Transaktionsfehlers ipgapi ProcessorReferenceNumber xs string In manchen F llen kann dieses Element leer sein Nimmt eine Nummer auf die der Kreditkartenprozessor als Referenz auf diese Transaktion nutzen kann Diese Nummer m ssen Sie in keiner weiteren Transaktion mehr angeben Sie sollten diese Angabe jedoch bereithalten wenn Sie Probleme mit Ihrer Transaktion feststellen und Kontakt mit dem Support aufnehmen m chten ipgapi ProcessorResponseMessag xs string Speichert die vom Kreditkartenprozessor zur ckgelieferte Fehlermeldung Im Falle einer abgelaufenen Kreditkarte w
31. Client eingereichte unkorrekte Informationen zum Shop zur Order Ursache des Fehler sind Faultstrin xs strin i sl Dieses Element enth lt immer den Fehlerstring MerchantException Detail reason xs strin x gt Dieses Element enth lt n here Angaben zur Fehlerursache Detaillierte Informationen zu einigen Fehlerursachen finden Sie im Abschnitt Merchant Exceptions im Anhang 11 2 2 2 ProcessingException Dieser Fehlertyp wird immer dann ausgegeben wenn First Data Austria API bei der Verarbeitung Ihrer Transaktion einen Fehler erkannt hat Der Unterschied zu den brigen Fehlertypen besteht darin dass First Data Austria API die Transaktion akzeptiert und an den Kreditkartenprozessor weitergeleitet hat Erst der Prozessor hat aufgrund eines Verarbeitungsfehlers eine Ausnahme ausgel st Dies ist beispielsweise der Fall wenn das Konto des Kunden nicht genug Deckung aufweist oder die verwendete Kreditkarte abgelaufen ist Letzterer Grund kann die folgende beispielhafte ProcessingException nach sich ziehen lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt SOAP ENV Fault gt lt faultcode gt SOAP ENV Client lt faultcode gt lt faultstring xml lang en US gt ProcessingException Processing the request resulted in an error see SOAP details for more information lt faultstring gt lt detail gt lt ipg
32. Data you supply the IP in the format XXX XXX XXX XXX e g 128 0 10 2 would be a valid IP vl TransactionDetails ReferenceNumber xs string Stores the six digit reference number you have received as the result of a successful external authorization e g by phone The Internet Payment Gateway needs this number for uniquely mapping a ForceTicket transaction to a previously performed external authorization vl vl TransactionDetails TDate xs string Stores the TDate of the Sale PostAuth ForceTicket Return or Credit transaction this Void transaction refers to A TDate value is returned within the response to a successful transaction of one of these five types When performing a Void transaction you have to pass the TDate in addition to the order ID for uniquely identifying the transaction to be voided The scenario presented below gives an example vl vl TransactionDetails TransactionOrigin xs string The source of the transaction The possible values are ECI if the order was received via email or Internet moro mail order telephone order and RETAIL face to face vl TransactionDetails xs string Stores the invoice number vil InvoiceNumber vl TransactionDetails xs string Stores the purchase order number vi PONumber vl TransactionDetails xs string Stores a dynamic merchant name for the vil DynamicMerchantN
33. FirstData 6 4 1 Die letzten Transaktionen eines Shops lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas a1 xmlns ns3 http ipg online com ipgapi schemas v1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns2 Action gt lt ns2 GetLastTransactions gt lt ns2 count gt 2 lt ns2 count gt lt ns2 GetLastTransactions gt lt ns2 Action gt lt ns5 IPGApiActionRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 4 2 Alle Transaktionen eines Shops und einer definierten TransactionlD Eine transactionlD besteht aus e Orderld e TDat Datum der Transaktion lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap enveLope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas a1 xmlns ns3 http ipg online com ipgapi schemas v1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns2 Action gt lt ns2 GetLastTransactions gt lt ns2 count gt 2 lt ns2 count gt lt ns2 OrderId gt A eb65437a c538 4cdd 82b3 d316ae1
34. HostedDataStorelD Data Vault product in this store only as technical user vi Payment xs string Declines duplicate credit card or vl DeclineHostedDataDuplicates German direct debit accounts vl Payment xs decimal Stores the Sub Total of an order If vi SubTotal tihis member is set then also ChargeTotal has to be set vl Payment xs decimal Stores the VAT of an order If this vl ValueAddedTax member is set then also SubTotal has to be set vi Payment xs decimal Stores the delivery amount of an vi DeliveryAmount order If this member is set then also SubTotal has to be set vl Payment xs double Stores the transaction amount Make vi ChargeTotal sure that the number of positions after the decimal point does not exceed 2 e g 3 123 would be invalid however 3 12 3 1 and 3 are correct vl Payment xs string Stores the currency as a three digit vl Currency ISO 4217 value e g 978 for Euro 10 1 8 TransactionDetails Path Name XML Schema Description type vl TransactionDetails xs string Stores the order ID This must be unique vl Orderld per Store ID If no Order ID is transmitted the Internet Payment Gateway will generate one automatically vl TransactionDetails xs string Stores the customer s IP address which can vl Ip be used by the Web Service API for fraud detection by IP address Make sure that IPG Integrationsleitfaden API Versio n4 72 SCH First
35. Operation aufgerufen werden soll Tats chlich weist First Data Austria API das Element ipgapi IPGApiOrderReguest automatisch der entsprechenden Web Service Operation zu 10 1 Beschreibung der XML Tags 10 1 1 CreditCardTxType Path Name XML Schema type Description vl CreditCardTxType vl Type xs string Stores the transaction type Possible values are sale forceTicket preAuth postAuth return credit and void 10 1 2 CreditCardData Path Name XML Schema type Description vl CreditCardData vl CardNumber xs string Stores the customer s credit card number Make sure that the string contains only digits i e passing the number e g in the format XXXX XXXX XXXX XXXX Will result in an error returned by the Web Service API vl CreditCardData vl ExpMonth xs string Stores the expiration month of the customer s credit card Make sure that the content of this element always contains two digits i e a card expiring in July will have this element with value 07 vl CreditCardData vl ExpYear xs string Stores the expiration year of the customer s credit card The same formatting restrictions as for the v1 ExpMonth element apply here vl CreditCardData vl CardCodeValue xs string Stores the three or four digit card security code CSC sometimes also referred to as card verification value CVV or code CVC which is typically
36. Parameterbestand bereitstellen um unabh ngig von der verwendeten Programmiersprache eine g ltige HTTP Anfrage zu erstellen Parameter Wert Beschreibung URL https Dies ist die vollst ndige URL des First Data Austria APl Web Service Abh ngig von der f f Funktionalit t die Sie f r die Erstellung von ipgapi service HTTPS Anfragen einsetzen m ssen Sie die URL eventuell in Host und Service aufteilen und diese Angaben in die entsprechenden Header der HTTPS Anfrage eintragen test ipg online com Content Type text xml Dieser zus tzlche HTTPS Header muss ebenfalls festgelegt werden Grund daf r ist die SOAP Anfragenachricht die in XML kodiert und als Inhalt im Body der HTTPS POST Anfrage transportiert werden soll Authorization Type Basic Die Identit t Ihres Shops wird vom Internet E E Payment Gateway anhand dieser iel userID Identifizierungsangaben festgestellt Um First Data Austria API verwenden zu k nnen Password yourPassword m ssen Sie Ihre Store ID Ihre User ID und das Passwort als Inhalt eines HTTPS Basic Autorisierungsheaders bermitteln Beispiel Wenn Ihre Store ID 101 Ihre User ID 007 und Ihr Passwort mypw lauten dann ist der Benutzername f r die Autorisierung WS101 1 Der komplette HTTPS Autorisierungsheader w rde so aussehen Authorization Basic VIMxMDEuX y4wMDc 6bX10Vw Bitte beachten Sie dass die letzte Zeichenfolge das Ergebnis einer Base64 Kodierung des
37. Version 4 53 SCH First Data lt ns3 ExpYear gt 12 lt ns3 ExpYear gt lt ns2 CreditCardData gt lt ns2 HostedDataID gt d56feaaf 2d96 4159 8fd6 887e07fc9052 lt ns2 HostedDataID gt lt ns4 DataStorageItem gt lt ns4 IPGApiActionResponse gt Existiert die von Ihnen bermittelte Hosted Data ID nicht erhalten Sie eine entsprechende Fehlermeldung lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas vl gt lt ns4 successfully gt true lt ns4 successfully gt lt ns2 Error Code SGSDAS 020301 gt lt ns2 ErrorMessage gt Hosted data id 6c814261 a843 49fb bacd 1411d3780286 not found lt ns2 ErrorMessage gt lt ns2 Error gt lt ns4 IPGApiActionResponse gt 7 6 L schen hinterlegter Datens tze ber den Action Request delete k nnen Sie nicht mehr ben tigte Datens tze l schen lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas al gt lt ns3 Action gt lt ns3 StoreHostedData gt lt ns3 DataStorageltem gt lt ns3 Function gt delete lt ns3 Function gt lt ns3 HostedDataID gt 9605c2d1 428c 4de2 940e 4bec4737ab5d lt ns3 HostedDatalD gt lt ns3 DataStorageltem gt lt ns3 StoreHostedData gt lt ns3 Action gt lt ns4 IPGApiA
38. base xs string gt lt xs maxLength value 6 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String3max gt lt xs restriction base xs string gt lt xs maxLength value 3 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name CurrencyType gt lt xs restriction base xs string gt lt http de wikipedia org wiki ISO_4217 gt lt http en wikipedia org wiki ISO_4217 gt lt xs pattern value 9 3 A Z 3 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name AmountVaLueType gt lt xs restriction base xs decimal gt lt xs fractionDigits value 3 gt lt xs totalDigits value 12 gt lt xs minInclusive value gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name BINType gt lt xs restriction base xs int gt lt xs totalDigits value 6 gt lt xs restriction gt lt xs simpleType gt lt xs schema gt IPG Integrationsleitfaden API Version 4 129 a FirstData a1 xsd lt xml version 1 0 encoding UTF 8 gt lt xs schema xmlns xs http www w3 org 2001 XMLSchema xmlns a1 http ipgq online com ipgapi schemas a1 xmlns v1 http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi targetNamespace http ipg online com ipgapi schemas al elementFormDefault qualified gt xs import namespace http ipg on
39. das Teil des JDK bin directory ist berpr fen c Programme Java jdk1 6 0_07 bin keytool exe list v keystore lt your keystore or truststore gt storepass lt your keystore or truststore password gt javax net ssl SSLHandshakeException sun security validator ValidatorException No trusted certificate found Erkl rung Ihr Truststore ist falsch Sie k nnen das Truststore mit dem Keytool das Teil des JDK ist berpr fen c Programme Java jdk1 6 0 07 bin keytool exe list v keystore lt lhr Truststore gt storepass lt lhr Truststore Passwort gt Dabei muss sich der Herausgeber Verisign in der Ausgabe befinden c 1998 VeriSign Inc For authorized use Public Primary Certification Authority G2 O VeriSign Das Beispiel auf der folgenden Seite zeigt einen Ausgabe abhangig vom JDK Bitte pr fen Sie auch die MD5 und SHA1 Werte IPG Integrationsleitfaden API Version 4 157 FirstData C gt c Programme Java jdk1 6 0 16 bin keytool exe list v keystore truststore jks storepass IPGAPI Keystore Typ JKS Keystore Provider SUN Ihr Keystore enth lt 3 Eintr ge Aliasname verisign cacert Erstellungsdatum 26 11 2009 Eintragstyp trustedCertEntry Eigner OU VeriSign Trust Network OU c 1998 VeriSign Inc For authorized use only OU Class 3 Public Primary Certification Authority G2 O VeriSign Inc C US Aussteller OU VeriSign Trust Network OU c 1998 VeriSign In
40. ein Zertifikat von einem Server eintrifft Darum muss das Server Zertifikat von First Data Austria API ebenfalls hier installiert werden Auf diese Weise kann IIS das bei der Kontaktaufnahme mit dem Web Service empfangene Server Zertifikat auf seine Vertrauensw rdigkeit pr fen W hlen Sie Trusted Root Certification Authorities aus dem Zweig Certificates Local Computer und ffnen Sie den Ordner Certificates 15 Klicken Sie mit der rechten Maustaste auf den Ordner Certificates w hlen Sie All Tasks und klicken Sie auf Import Damit rufen Sie den Certificate Import Wizard auf 16 Klicken Sie auf Next W hlen Sie die PEM Datei mit dem Server Zertifikat und klicken Sie auf Next Bitte beachten Sie dass dieser Prozess genau so abl uft wie in Kapitel 3 beschrieben 17 W hlen Sie Place all certificates in the following store und suchen Sie den Ordner Trusted Root Certification Authorities sofern er noch nicht angezeigt wird Klicken Sie auf Next 18 Pr fen Sie die angezeigten Einstellungen und klicken Sie auf Finish Das Server Zertifikat ist damit im Store des lokalen Computers f r vertrauensw rdige Zertifikate installiert Hier kann IIS das Server Zertifikat zum Abgleich mit dem First Data Austria API Server Zertifikat heranziehen das w hrend des SSL Einrichtungsprozesses empfangen wurde Nach der Installation beider Zertifikate sollte man davon ausgehen k nnen dass die Umgebung die ASP eine Kommunikation via SSL erlaubt ferti
41. gleich aussieht Vergessen Sie jedoch nicht die doppelten Backslashs im Pfad durch einzelne zu ersetzen d h der Pfadname des Zertifikats w rde dann wie folgt lauten LOCAL MACHINE My WS101 _ 1 Bitte beachten Sie dass dieses Skript im n chsten Kapitel um die Statements erweitert wird die f r die eigentliche HTTP Anfrage notwendig sind IPG Integrationsleitfaden API Version 4 92 SCH First Data 15 HTTPS POST Anfrage senden und die Antwort empfangen Die eigentliche Kommunikation mit dem First Data Austria API Web Service beginnt wenn die HTTPS Anfrage gesendet und auf eine Antwort gewartet wird Wie dies geschieht ist wiederum von der Programmiersprache abh ngig die Sie verwenden Die meisten HTTP Bibliotheken decken die zugrunde liegenden Kommunikationsdetails voll ab und verk rzen diesen Prozess auf einen einzigen Operationsaufruf der als Ergebnisobjekt die HTTP Antwort zur ckliefert Die erforderlichen Parameter um erfolgreich eine HTTP POST Anfrage ber SSL durchzuf hren und eine Antwort mit einem 200 HTTP Statuscode als Inhalt zu empfangen sind in den beiden vorangehenden Kapiteln beschrieben Die Festlegung ung ltiger oder falscher Parameter f hrt dazu dass der Webserver auf dem der First Data Austria API Web Service l uft einen HTTP Standardfehlercode im HTTP Header der Antwort zur ckgibt oder einen SSL Fehler sendet Die Bedeutung dieser Codes k nnen Sie jedem HTTP SSL Leitfaden entnehmen Es gibt
42. gt lt ipgapi ReferencedTDate gt 1407373209 lt ipgapi ReferencedIDate gt lt ipgapi TDate gt 1407373209 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2014 08 07 03 00 09 CEST lt ipgapi TDateFormatted gt lt ipgapi TerminalID gt 54000666 lt ipgapi TerminalID gt lt ipgapi IPGApiOrderResponse gt lt al TransactionState gt CAPTURED lt a1 TransactionState gt lt al UserID gt 1 lt a1 UserID gt lt al SubmissionComponent gt BUS lt a1 SubmissionComponent gt lt al TransactionValues gt lt ipgapi IPGApiActionResponse gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 5 Wiederkehrende Zahlungen Der Action Request RecurringPayment erm glicht Ihnen die Einrichtung von regelm igen Abbuchungen von einem Kreditkartenkonto Daneben kann auch eine einzelne Transaktion vorgemerkt werden die automatisch zu einem sp teren Zeitpunkt ausgef hrt wird Grunds tzlich stehen drei Funktionen zur Verf gung install modify und cancel Das folgende Beispiel zeigt Einrichtung einer einmaligen Zahlung die zum 31 12 2011 ausgef hrt werden soll lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns2 Action gt lt ns2 RecurringPayment gt lt ns2 Function gt install lt ns2 Function gt IPG Integrationsleitfaden API Version 4 40 SCH First Data lt ns2 RecurringPaymentInfo
43. gt lt xs element name CryptogramInformationData 9F27 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 1 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name CVMResults 9F34 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 3 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name DedicatedFileName 84 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 5 gt lt xs maxLength value 16 gt lt xs restriction gt IPG Integrationsleitfaden API Version 4 116 a FirstData lt xs simpleType gt lt xs element gt lt xs element name InterfaceDeviceSerialNumber 9F1E minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs string gt lt xs length value 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name IssuerApplicationData 9F1 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs maxLength value 32 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name IssuerAuthenticationData 91 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 8 gt lt xs maxLength value 16 gt lt
44. jedoch eine wichtige Ausnahme Wenn die von Ihnen angegebenen HTTP Parameter korrekt sind der Web Service aber aufgrund eines unkorrekten Wertes in der SOAP Anfragenachricht z B eine ung ltige Kreditkartennummer Ihre Transaktion nicht verarbeiten konnte wird eine SOAP Ausnahme ausgel st und in den Body einer HTTP Antwort eingetragen die den Fehlercode 500 enth lt Einzelheiten zur Ursache der Ausnahme enth lt die SOAP Fehlermitteilung die im Kontext des folgenden Kapitels beschrieben wird Zum Abschluss der in den vorangehenden Kapiteln schrittweise aufgebauten PHP und ASP Skripts steuern die beiden n chsten Kapitel die notwendigen Statements f r die Durchf hrung eines HTTP Aufrufs mittels dieser Programmiersprachen bei 15 1 PHP Auch hier erfolgt wieder eine zweigeteilte Erkl rung f r die PHP cURL Erweiterung bzw die Nutzung des cURL Befehlszeilentools 15 1 1 PHP cURL Erweiterung nutzen Das PHP Skript unter Nutzung der cURL Erweiterung wird vervollst ndigt durch die nachfolgenden Statements zur Ausf hrung des HTTP Aufrufs Beachten Sie dass der HTTP Aufruf eine SOAP Antwortmitteilung oder Fehlermeldung im Body der HTTP Antwort zur ckliefert lt php telling cURL to return the HTTP response body as operation result value when calling curl exec curl setopt ch CURLOPT RETURNTRANSFER 1 calling cURL and saving the SOAP response message in a variable which contains a string like lt SOAP ENV Envel
45. lt xs group gt IPG Integrationsleitfaden API Version 4 134 FirstData lt xs element name RequestCardRateForDCC gt lt xs complexType gt lt xs sequence gt lt xs element name StoreId type v1 String2 max gt lt xs element name BIN type v1 BINType gt lt xs element name BaseAmount type v1 AmountValueType minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name RequestMerchantRateForDynamicPricing gt lt xs complexType gt lt xs sequence gt lt xs element name StoreId type v1 String2 max gt lt xs element name ForeignCurrency type v1 CurrencyType gt lt xs element name BaseAmount type v1 AmountValueType minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name StoreHostedData gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name DataStorageItem type a1 DataStorageItem maxOccurs unbounded gt lt xs sequence gt lt xs complexType gt lt xs element gt IPG Integrationsleitfaden API Version 4 135 SCH First Data lt xs complexType lt xs sequence gt lt xs choice gt name DataStorageItem gt lt xs element name CreditCardData type v1 CreditCardData gt lt xs element name DE DirectDebitData type v1 DE DirectDebitData gt lt xs element name OrderId
46. lt ns4 ProcessorTraceNumber gt 001151 lt ns4 ProcessorTraceNumber gt lt ipgapi TDate gt 1330682626 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2012 03 02 11 03 46 MEZ lt ipgapi TDateFormatted gt lt ns4 TerminalID gt 99000003 lt ns4 TerminalID gt lt ns4 TransactionResult gt APPROVED lt ns4 TransactionResult gt lt ns4 TransactionTime gt 1250599048 lt ns4 TransactionTime gt lt ns4 IPGApiOrderResponse gt lt ns2 ResponseCode gt 00 lt ns2 ResponseCode gt lt ns2 TransactionValues gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt void lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 TransactionDetails gt lt ns3 OrderId gt A 5337067b 33cb 4173 b003 129ccf437c0c lt ns3 OrderId gt lt ns3 TDate gt 1250599046 lt ns3 TDate gt lt ns3 TransactionDetails gt lt ns4 IPGApiOrderResponse gt lt ns4 ApprovalCode gt Y 9451977 0000075790 PPX 0011521145 lt ns4 ApprovalCode gt lt ns4 lt ns4 AVSResponse gt PPX lt ns4 AVSResponse gt CommercialServiceProvider gt BNLP lt ns4 CommercialServiceProvider gt lt ns4 OrderId gt A 5337067b 33cb 4173 b003 129ccf437c0c lt ns4 OrderId gt lt ns4 ProcessorApprovalCode gt 9451977 lt ns4 ProcessorApprovalCode gt lt ns4 ProcessorReceiptNumber gt 1145 lt ns4 ProcessorReceiptNumber gt lt ns4 ProcessorReferenceNumber gt 9451977
47. printed on the back of the credit card For information about the benefits of CSC contact support vl CreditCardData vl TrackData xs string Stores the track data of a card when using a card reader instead of keying in card data can optionally be used instead of transmitting CardNumber ExpMonth and ExpYear This field needs to contain at least the concatenated track 1 and 2 data Track data 3 is optional The track data must include the track and field separators as they are stored on the card Example for IPG Integrationsleitfaden API Versio n4 70 SCH First Data the track data separator from track data 1 and 2 without the data vl CreditCardData vl TrackData xs string Optional field for the brand of the credit card If this field is set the transaction will only be processed if the card number matches the brand Zu XML Tags die sich auf Card Present Transaktionen mit einem Kartenleser und PIN Eingabe Device beziehen finden Sie weitere Details im Appendix dieses Dokuments 10 1 3 CreditCard3DSecure Path Name XML Schema Description type vl CreditCard3DSecure xs string Stores the VerificationResponse VERes of vl VerificationResponse your Merchant Plug in vl CreditCard3DSecure xs string Stores the PayerAuthenticationResponse vl PayerAuthenticationResp PARes of your Merchant Plug in onse vl CreditCard3DSecure xs s
48. restriction base xs string gt lt xs pattern value 0 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element ref v1 TransactionOrigin minOccurs gt lt xs element ref v1 Terminal minOccurs 0 gt IPG Integrationsleitfaden API Version 4 122 SCH First Data lt xs element name InguiryRateReference type v1 InquiryRateReference minOccurs gt lt xs all gt lt xs complexType gt lt xs element name Basket gt lt xs complexType gt lt xs seguence gt lt xs element name ProductStock minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value check gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name Item maxOccurs 100 gt lt xs complexType gt lt xs seguence gt lt xs element name ID type v1 String128max gt lt xs element name Description type v1 String128max gt lt xs group ref v1 Amount gt lt xs element name Quantity type xs int gt lt xs element name Option minOccurs maxOccurs 100 gt lt xs complexType gt lt xs all gt lt xs element name Name type v1 String128max gt lt xs element name Choice type v1 String128max gt lt xs all gt lt xs complexType gt lt xs element gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs sequence gt lt xs complexType gt lt xs elem
49. string Speichert den Firmennamen des Kunden vl Company Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die erste Zeile der D EE EE Kundenadresse Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die zweite Zeile der yi Ad ress2 Kundenadresse Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die Stadt des Kunden Wenn vil City bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert das Bundesland des Kunden li Stake Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die Postleitzahl des Kunden vi Zip Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert das Land des Kunden Wenn vl Country bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die Telefonnummer des Kunden ls Ba Wenn bereitgestellt erscheint die Angabe IPG Integrationsleitfaden API Versio n4 66 SCH First Data sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die Faxnummer des Kunden ai Wenn bereitgestellt er
50. string Gibt Ihren Provider an CommercialServiceProvider ipgapi TransactionTime xs string Zeitstempel des Internet Payment Gateways vor R cklieferung der Transaktionsgenehmigung ipgapi xs string In manchen F llen kann dieses ProcessorReteroneceNinber Element leer sein Es nimmt eine Nummer auf die der Kreditkartenprozessor als Referenz auf diese Transaktion nutzen kann Diese Nummer m ssen Sie in keiner weiteren Transaktion mehr angeben Sie sollten diese Angabe jedoch bereithalten wenn Sie Probleme mit Ihrer Transaktion feststellen und Kontakt mit dem Support aufnehmen m chten ipgapi xs string Im Falle einer Genehmigung enth lt ProcessorResponseMessag dieses Element folgenden String Function performed error free ipgapi xs string Der Response Code der ProcessorResponseCod Zahlungsverarbeitung ipgapi xs string Der Genehmigungs Code der ProcessorApprovalCode Zahlungsverarbeitung ipgapi xs string Die Belegnummer der ProcessorReceiptNumber Zahlungsverarbeitung ipgapi xs string Die Trace Nummer der ProcessorTraceNumber Zahlungsverarbeitung ipgapi ErrorMessage xs string Im Falle einer Genehmigung ist dieses Element leer ipgapi OrderId xs string Dieses Element enth lt die Order ID F r Sale PreAuth ForceTicket und Credit Transaktionen wird eine neue Order ID zuruckgeliefert Bei IPG Integrationsleitfaden API Version 4 82 SCH First Da
51. type v1 CreditCardData minOccurs gt lt xs element name DE DirectDebitData type v1 DE DirectDebitData minOccurs gt lt xs element ref v1 MandateReference minOccurs gt lt xs element name ReferencedOrderId type v1 String100max minOccurs 0 gt lt xs element ref v1 Payment minOccurs gt IPG Integrationsleitfaden API Version 4 138 SCH First Data XS 3 lt XS lt Xs lt XS lt XS element element element element element ref v1 Basket minOccurs gt ref v1 Billing minOccurs gt ref v1 CreditCard3DSecure minOccurs gt ref v1 Shipping minOccurs gt name Ip minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 25 6 5 2 4 1 9 1 9 9 25 5 2 4 1 0 9 1 9 0 9 V 25 0 5 2 0 4 1 0 9 1 9 0 9 V 25 0 5 2 0 4111 0 9 1 9 0 9PD gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name Transactionorigin default ECI minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value ECI gt lt xs enumeration value MOTO gt lt xs enumeration value RETAIL gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs simpleType name Function gt l
52. von 7 Euro IPG Integrationsleitfaden API Version 4 95 SCH First Data Amount amount new Amount 7 978 ISO 4217 EUR 978 CreditCard cC new CreditCard 1111222233334444 07 17 null CCSaleTransaction transaction IPGApiTransactionFactory createSaleTransactionCredit amount cC some transactions may include further information e g the customer transaction setName a name try IPGApiResult result client commitTransaction transaction now you can read the conclusion System out println result getOrderId System out println result getTransactionTime LE sn catch ProcessingException e ERROR transaction not passed 16 3 Erstellen einer Aktion Die folgende Factory Class kann zur Erstellung der ben tigten Klasse verwendet werden de firstdata ipgapi client transaction IPGApiActionFactory Um eine Aktion auszuf hren muss die commitAction Methode des IPGApiClient verwendet werden Die weitere Vorgehensweise erfolgt entsprichend der Zahlungstransaktionen 16 4 Einsatz eines Proxys Bevor der IPGApiClient hinter einem Proxy verwendet werden kann muss die Proxy Konfiguration des Clients mit der IPGApiClient Methode vorgenommen werden IPGApiClient setProxy final String host final Integer port final String user final String domain final String password Die Parameter user domain und password sollten leer sein sofern keine Identifikation ben tig
53. wenn First Data Austria API den Fehler darauf zur ckf hren kann dass vom Ihrem Online Shop unkorrekte Informationen bermittelt wurden Dies kann folgende Gr nde haben 1 Ihr Shop ist nicht freigeschaltet Sollten Sie diese Fehlermitteilung erhalten obwohl Ihr Shop bereits freigeschaltet sein sollte wenden Sie sich bitte an unser technisches Support Team 2 Die f r die HTTPS Autorisierung bermittelte Kombination von Store ID User ID ist syntaktisch unkorrekt 3 Die XML Nachricht entspricht nicht dem Schema Eine MerchantException sieht wie folgt aus lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt SOAP ENV Fault gt lt faultcode gt SOAP ENV Client lt faultcode gt lt faultstring xml lang en US gt MerchantException lt faultstring gt lt detail gt lt detailed explanation gt lt detail gt IPG Integrationsleitfaden API Version 4 79 First Data lt SOAP ENV Fault gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Die Elemente der SOAP Fehlermitteilung relativ zum Element SoAP ENV Envelope SOAP ENV Body SOAP ENV Fault werden wie folgt gesetzt Pfad Name XML Schematyp Beschreibung Faultcode xs string Dieses Element wird immer auf SOAP ENV Client gesetzt und zeigt an dass vom
54. xs string minOccurs gt lt xs element name CommercialServiceProvider type xs string minOccurs gt lt xs element name ErrorMessage type xs string minOccurs gt lt xs element name OrderId type xs string minOccurs gt lt xs element name PayerSecuritylevel type xs string minOccurs gt lt xs element name PaymentType type xs string minOccurs gt lt xs element name ProcessorApprovalCode type xs string minOccurs gt lt xs element name ProcessorReceiptNumber type xs string minOccurs 0 gt lt xs element name ProcessorCCVResponse type xs string minOccurs gt lt xs element name ProcessorReferenceNumber type xs string minOccurs ds lt xs element name ProcessorResponseCode type xs string minOccurs gt lt xs element name ProcessorResponseMessage type xs string minOccurs gt lt xs element name ProcessorTraceNumber type xs string minOccurs gt lt xs element name ReferencedTDate type xs string minOccurs gt lt xs element name TDate type xs string minOccurs gt lt xs element name TDateFormatted type xs string minOccurs gt lt xs element name TerminalID type xs string minOccurs gt lt xs element name TransactionResult type xs string minOccurs gt lt xs element name TransactionTime type xs string minOccurs gt lt xs element ref ipgapi EMVCardPresentRe
55. z B 10012345678 Sie wird f r die Basisautorisierung ben tigt User ID Die User ID bezeichnet den Anwender der das Zugriffsrecht auf First Data Austria API besitzt z B 1 Auch dieses Element wird f r die Basisautorisierung ben tigt Password Das f r die Basisautorisierung ben tigte Passwort Client Certificate p12 File Das in einer p12 Datei gespeicherte Client Zertifikat Der Dateiname folgt der Syntax wsstorelD userlD p 2 Im Beispielfall der oben genannten Store ID User ID w rde er ws101 1 p12 lauten Diese Datei dient zur Authentifizierung des Clients gegen ber dem Internet Payment Gateway F r eine Verbindung mit Java ben tigen Sie ein ks File z B WS10012345678 _ 1 ks Client Certificate Installation Password Das f r die Installation der p12 Datei mit dem Client Zertifikat ben tigte Passwort Client Certificate Private Key Der in einer Schl ssel Datei gespeicherte private Schl ssel des Client Zertifikats Der Dateiname folgt der Syntax wsstorelD userlD key Im Beispielfall der oben genannten Store ID User ID w rde er WS10012345678 1 key lauten Einige Tools die Sie bei der Einrichtung Ihrer Applikation f r die Nutzung von First Data Austria API unterst tzen erfordern ein Passwort f r die Client Authentifizierung gegen ber dem Internet Payment Gateway Client Certificate Private Key Password Dieses Passwort sch tzt den privaten Schl ssel des Client Zertifikats Einige Tools die Sie b
56. 11 Pr fen Sie die angezeigten Einstellungen und klicken Sie auf Fertig stellen eventuell m ssen Sie die Installation nochmals best tigen Das Server Zertifikat ist damit im Speicher des lokalen Computers f r vertrauensw rdige Zertifikate installiert Hier kann Microsoft Internet Explorer nach dem Server Zertifikat suchen um das empfangene First Data Austria API Server Zertifikat zu berpr fen wenn die oben genannte WSDL URL aufgerufen wird 12 Sie k nnen jetzt ein Microsoft Internet Explorer Fenster ffnen und die oben genannte URL in das Adressenfeld eintragen 13 Nach Aufruf der URL fordert der Server ihren Browser auf das Client Zertifikat zu senden um sicherzustellen dass er wirklich mit Ihrer Applikation kommuniziert Da Sie zuvor das Zertifikat installiert haben wird es ohne weitere Eingabeaufforderung an Sie an den Server gesendet d h diesen Schritt bemerken Sie nicht Anschlie end sendet First Data Austria API das Server Zertifikat um sich gegen ber Ihrer Anwendung eindeutig auszuweisen Dieses Zertifikat wird mit dem vertrauensw rdigen Zertifikat verglichen das Sie zuvor installiert haben Auch dies geschieht automatisch so dass Sie keine Eingabe vornehmen m ssen Nun wird eine sichere Verbindung aufgebaut Alle Daten die zwischen Ihrer Applikation und dem First Data Austria API Web Service bertragen werden sind somit SSL verschl sselt 14 Als n chstes m ssen Sie Ihre Identifizierungsangaben f r die Autor
57. 2 Currency gt lt ns3 0fferStarts gt 2014 12 27T13 29 41 000 01 00 lt ns3 0fferStarts gt lt ns3 OfferEnds gt 2015 09 19T14 29 41 000402 00 lt ns3 OfferEnds gt lt ns2 Option gt lt ns2 Name gt colour lt ns2 Option gt lt ns2 Choice gt blue lt ns2 Choice gt lt ns2 Option gt lt ns2 Option gt lt ns2 Name gt size lt ns2 Option gt lt ns2 Choice gt large lt ns2 Choice gt lt ns2 Option gt lt ns3 Product gt lt ns3 ManageProducts gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt OfferStarts und OfferEnds sind optional und k nnen dazu genutzt werden um die Sichtbarkeit von Produkten in der Kundenanwendung einzuschr nken ohne dass dies Einfluss auf den Verkauf der Produkte h tte Es gibt weitere optionale Feldbeschreibungen wie Description OptionName und Name Weitere Details finden Sie im Anhang a1 xsd dieses Dokumentes lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api clickandbuy com webservices pay 1 0 0 gt lt ns3 Action gt IPG Integrationsleitfaden API Version 4 47 SCH First Data lt ns3 ManageProducts gt lt ns3 Function gt display lt ns3 Function gt lt ns3 Product gt lt ns3 ProductID gt product ID xyz lt ns3 ProductID gt lt ns3 Product gt lt ns3 ManageProducts gt lt ns3 Action gt lt ns5 IPGApiActi
58. 2 Datei mit dem Client Zertifikat abgelegt haben 2 Doppelklicken Sie auf die p12 Datei mit dem Client Zertifikat 3 Klicken Sie auf Weiter Pr fen Sie den Dateinamen der bereits dem Pfadnamen der p12 Datei mit dem Client Zertifikat entsprechen sollte und klicken Sie auf Weiter 4 Geben Sie das Passwort f r die Installation des Client Zertifikats ein und klicken Sie auf Weiter 5 W hlen Sie die Option Zertifikatspeicher automatisch ausw hlen und klicken Sie auf Weiter Damit platzieren Sie das Zertifikat in Ihrem pers nlichen Zertifikatspeicher genauer im pers nlichen Zertifikatspeicher des lokal angemeldeten Windows Anwenders 6 Pr fen Sie die angezeigten Einstellungen und klicken Sie auf Fertig stellen Damit ist Ihr Client Zertifikat installiert 7 Als n chstes m ssen Sie das Server Zertifikat installieren Am einfachsten geschieht dies indem Sie den Ordner ffnen in dem Sie die PEM Datei mit dem Server Zertifikat gespeichert haben und diese Datei in geotrust crt umbenennen 8 Doppelklicken Sie anschlie end auf die umbenannte Datei mit dem Server Zertifikat IPG Integrationsleitfaden API Version 4 9 SCH First Data 9 Klicken Sie auf Zertifikat installieren Damit rufen Sie den gleichen Assistenten wie oben auf 10 Klicken Sie auf Weiter W hlen Sie Alle Zertifikate in folgendem Speicher speichern und suchen Sie den Ordner Vertrauensw rdige Stammzertifizierungsstellen Klicken Sie auf OK und dann Weiter
59. 3 http ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 PayPalTxType gt lt ns4 Type gt void lt ns4 Type gt lt ns4 PayPalTxType gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4f48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TDate gt 1321609898 lt ns4 TDate gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt In case your system is not aware of the payment method that has been used for the original transaction the Void can be performed using any TxType which supports Voids The gateway will then select the correct payment method based on the referenced Order ID and TDate 5 3 4 Gutschrift Bitte beachten Sie dass die Gutschrift transaction spezielle Nutzerrechte erfordert Das aufgef hrte XML Statement ist ein Beispiel f r eine Gutschrift Transaktion mit dem minimalen Set an Befehlen lt ns5 IPGApiOrderReguest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 PayPalTxType gt lt ns4 Type gt credit lt ns4 Type gt lt ns4 PayPalTxType gt lt ns4 ClickandBuyData gt lt ns4 Payment gt lt ns4 ChargeTotal gt 1 lt ns4 ChargeTotal gt IPG Integrationsleitfaden API Version 4 23 SCH First Data lt ns4 Currency gt EUR
60. 3 Action gt lt ns3 GetLastOrders gt lt ns3 Count gt 5 lt ns3 Count gt lt ns3 DateFrom gt 2014 04 05T10 23 37 143 02 00 lt ns3 DateFrom gt lt ns3 DateTo gt 2014 05 05110 23 37 143102 00 lt ns3 DateTo gt IPG Integrationsleitfaden API Version 4 30 SCH First Data lt ns3 GetLastOrders gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 3 3 Alle Bestellungen eines Shops f r eine bestimmte OrderID Dieser Befehl unterst tzt eine umfangreiche Abfrage von durchgef hrten Bestellungen eines bestimmten Shops in einem definierten Zeitraum lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas vi xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay_1_0 0 gt lt ns3 Action gt lt ns3 GetLastOrders gt lt ns3 Count gt 2 lt ns3 Count gt lt ns3 OrderID gt Test SGSDAO ConversionDate 1382020873203 lt ns3 OrderID gt lt ns3 GetLastOrders gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope 6 3 4 Response Alle Abfragemethoden liefern Antworten mit derselben Struktur zur ck e Der Erfolgsstatu
61. 4 AVSResponse gt lt ns4 OrderId gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns4 OrderId gt lt ns4 ProcessorApprovalCode gt 356887 lt ns4 ProcessorApprovalCode gt lt ns4 ProcessorReceiptNumber gt 9753 lt ns4 ProcessorReceiptNumber gt lt ns4 ProcessorTraceNumber gt 061278 lt ns4 ProcessorTraceNumber gt lt ns4 TDate gt 1273570668 lt ns4 TDate gt lt ns4 TDateFormatted gt 2010 05 11 11 37 48 MESZ lt ns4 TDateFormatted gt lt ns4 TerminalID gt 54000668 lt ns4 TerminalID gt lt ns4 IPGApiOrderResponse gt lt ns2 ReceiptNumber gt 9753 lt ns2 ReceiptNumber gt lt ns2 TraceNumber gt 61278 lt ns2 TraceNumber gt lt ns2 TransactionState gt VOIDED lt ns2 TransactionState gt lt ns2 TransactionValues gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt credit lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 CreditCardData gt IPG Integrationsleitfaden API Version 4 27 SCH First Data lt ns3 CardNumber gt 5426 4979 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt lt ns3 ExpYear gt 12 lt ns3 ExpYear gt lt ns3 CreditCardData gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 InvoiceNumber gt invoice number lt ns3 InvoiceNumber gt lt ns3 Orderld gt a058e6e1 fec7 4e63 a092 fab4
62. 4 ClickandBuyTxType gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4f48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TDate gt 1321609898 lt ns4 TDate gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderReguest gt Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Originaltransaktion genutzt wurde nutzen Sie Void mit einem beliebigen TxType welcher Voids unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderID und TDate 5 2 4 Credit Gutschrift Bitte beachten Sie dass f r diese Funktion eine gesonderte Beauftragung und Freischaltung notwendig ist Kontaktieren Sie hierzu bei Bedarf Ihren Ansprechpartner in unserem Vertriebsteam Das folgende XML Dokument entspricht einer Credit Transaktion mit dem Mindestbestand an Elementen lt ns5 IPGApiOrderReguest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 htp api clickandbuy com webservices pay 1 0 0 mlns ns4 http ipg online com ipgapi schemas v1 gt IPG Integrationsleitfaden API Version 4 19 SCH First Data lt ns4 Transaction gt lt ns4 ClickandBuyTxType gt lt ns4 Type gt credit lt ns4 Type gt lt ns4 ClickandBuyTxType gt lt ns4 ClickandBuyData gt lt ns4 Payment gt lt ns4 ChargeTotal gt 1 lt ns4 ChargeTotal gt lt ns4 Curr
63. 6 c22 lt ns2 OrderId gt lt ns2 TDate gt 1407373211 lt ns2 TDate gt lt ns2 GetLastTransactions gt lt ns2 Action gt IPG Integrationsleitfaden API Version 4 37 SCH First Data lt ns5 IPGApiActionRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 4 3 Response Alle Antworten dieser Abfragen weisen dieselbe Struktur auf e Erfolgsstatus lt ipgapi successfully gt true lt ipgapi successfully gt e Auflistung der Transaktionen lt a1 TransactionValues gt lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiActionResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi xmlns al http ipg online com ipgapi schemas a1 xmlns pay 1 0 http api cLickandbuy com webservices pay 1 0 0 xmlns v1 http ipg online com ipgapi schemas v1 gt lt ipgapi successfully gt true lt ipgapi successfully gt lt al TransactionValues gt lt v1 CreditCardTxType gt lt v1 Type gt periodic lt v1 Type gt lt v1 CreditCardTxType gt lt v1 CreditCardData gt lt v1 CardNumber gt 403587 4977 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt v1 ExpYear gt 14 lt v1 ExpYear gt lt v1 Brand gt VISA lt v1 Brand gt lt v1 CreditCardData gt lt v1 Payment gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 C
64. 75 75 77 77 78 78 79 82 82 83 86 87 SCH First Data 13 1 1 cURL PHP Erweiterung nutzen 13 1 2 cURL Befehlszeilentool nutzen 13 2 ASP 14 SSL Verbindung aufbauen 14 1 PHP 14 1 1 PHP cURL Erweiterung nutzen 14 1 2 o cURL Befehlszeilentool nutzen 14 2 ASP 15 HTTPS POST Anfrage senden und die Antwort empfangen 15 1 PHP 15 1 1 PHP cURL Erweiterung nutzen 15 1 2 cURL Befehlszeilentool nutzen 15 2 ASP 16 Verwendung eines Java Client zur Nutzung des Web Service 16 1 Erzeugung einer IPGApiClient Instanz 16 2 Transaktionen erstellen und Antwort verarbeiten 16 3 Erstellen einer Aktion 16 4 Einsatz eines Proxys 17 Anhang ipgapi xsd v1 xsd al xsd Fehleranalyse Merchant Exceptions Fehleranalyse Processing Exceptions Fehleranalyse Login Fehler bei der Verwendung von cURL Fehleranalyse Login Fehler bei der Verwendung des Java Client IPG Integrationsleitfaden API Version 4 87 87 88 89 89 89 90 90 93 93 93 93 94 95 95 95 96 96 97 97 101 130 145 150 155 157 SCH First Data Unterst tzung bei Fragen F r das First Data Austria Internet Payment Gateway sind verschiedene Handb cher erh ltlich Der vorliegende API Integrationsleitfaden ist f r die technische Integration besonders n tzlich Daneben finden Sie im Benutzerhandbuch First Data Austria Virtual Terminal wichtige Hinweise zum Abrufen von Berichten und Grafiken zu Ihren Zahlungsvorg ngen sowie zur Transaktionsverarbeitung durch manuelle E
65. 8A minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 8 9 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name MessageControlField DF4F minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 8 9 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name IPGApiActionResponse gt lt xs complexType gt lt xs sequence gt lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt XS f gt element element element element element element element element element element element name successfully type xs boolean gt name OrderId type xs string minOccurs 0 gt ref al Error minOccurs 0 maxOccurs unbounded gt name ResuLtInfo type al ResultInfoType minOccurs gt ref v1 Basket minOccurs 0 gt ref v1 Billing minOccurs gt ref al Product minOccurs maxOccurs unbounded gt ref al ProductStock minOccurs maxOccurs unbounded gt ref v1 MandateReference minOccurs gt ref v1 Shipping minOccurs gt ref al TransactionValues minOccurs maxOccurs unbounded lt xs element name RecurringPaymentIn
66. Anfrage mit den oben genannten Parametern mittels folgender PHP Statements erstellt lt php storing the SOAP message in a variable note that the plain XML code is passed here as string for reasons of simplicity however it is certainly a good practice to build the XML e g with DOM furthermore when using special characters you should make sure that the XML string gets UTF 8 encoded which is not done here Sbody lt SOAP ENV Envelope gt lt SOAP ENV Envelope gt initializing cURL with the IPG API URL ch curl init https test ipg online com ipgapi services setting the request type to POST curl_setopt Sch CURLOPT POST 1 setting the content type curl setopt ch CURLOPT HTTPHEADER array Content Type text xml setting the authorization method to BASIC curl setopt ch CURLOPT HTTPAUTH CURLAUTH BASIC supplying your credentials R e R curl setopt ch CURLOPT USERPWD WS101 1 myPW filling the reguest body with your SOAP message LOPT POSTFIELDS body curl setopt ch CU gt Wie die f r eine SSL Kommunikation notwendigen Sicherheitsoptionen eingestellt werden ist im n chsten Kapitel in Form einer Erweiterung des obigen Skripts beschrieben 13 1 2 cURL Befehlszeilentool nutzen Aus den oben genannten Gr nden ziehen Sie es vielleicht vor anstelle der Erw
67. CB gt value VISA gt lt xs element name EMVCardPresentRequest gt lt xs complexType gt lt xs sequence gt lt xs element ref vi CryptData gt lt xs choice gt IPG Integrationsleitfaden API Version 4 112 SCH First Data lt xs element ref v1 EMVRequestData gt lt xs element ref v1 TLVData gt lt xs choice gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name CryptData gt lt xs complexType gt lt xs all gt lt xs element name SRED gt lt xs complexType gt lt xs all gt lt xs element name Value gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt lt xs length value 256 gt gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name KSN gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name PINBLock minOccurs gt lt xs complexType gt lt xs all gt lt lt xs element name Format gt lt xs simpleType gt lt xs restriction base xs string gt IPG Integrationsleitfaden API Version 4 113 SCH First Data lt xs length value 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt gt lt xs element name Value gt lt xs si
68. G ltig von Wed Mar 25 01 00 00 CET 2009 bis Mon Mar 25 00 59 59 CET 2019 Digitaler Fingerabdruck des Zertifikats MD5 AB OF D7 09 45 EA 3C 10 60 B6 17 BC 8E 09 07 69 SHA1 62 F3 C8 97 71 DA 4C E0 1A 91 FC 13 E0 2B 60 57 B4 54 7A 1D Unterschrift Algorithmusname SHAlwithRSA Version 3 Erweiterungen 1 ObjectId 2 5 29 15 Criticality true KeyUsage Key CertSign Crl Sign 2 ObjectId 2 5 29 19 Criticality true BasicConstraints CA true PathLen 0 3 ObjectId 2 5 29 14 Criticality false SubjectKeyldentifier Keyldentifier 0000 A5 EF OB 11 CE CO 41 03 A3 4A 65 90 48 B2 1C EO A Je H 0010 57 2D 7D 47 W G 4 ObjectId 1 3 6 1 5 5 7 1 1 Criticality false AuthorityInfoAccess IPG Integrationsleitfaden API Version 4 159 SCH First Data accessMethod 1 3 6 1 5 5 7 48 1 accessLocation URIName http ocsp verisign com 5 ObjectId 1 3 6 1 5 5 7 1 12 Criticality false 6 ObjectId 2 5 29 31 Criticality false CRLDistributionPoints DistributionPoint URIName http crl verisign com pca3 g2 crl 1 7 ObjectId 2 5 29 32 Criticality false CertificatePolicies CertificatePolicyId 2 16 840 1 113733 1 7 23 3 PolicyQualifierInfo qualifierID 1 3 6 1 5 5 7 2 1 qualifier 0000 16 1C 68 74 74 70 73 3A 2F 2F 77 77 77 2E 16 65 https www ve 0010 72 69 73 69 67 6E 2E 63 6F 6D 2F 63 70 73 risign com cps
69. IPGApiActionResponse Wieder sind hier keine Header definiert Der SOAP Body enth lt das eigentliche Transaktionsresultat im Element ipgapi IPGApiOrderResponse oder ipgapi IPGApiOrderReguest Seine Unterelemente und deren Bedeutung sind im n chsten Kapitel beschrieben Ein kurzes Beispiel eine genehmigte Sale Transaktion wird in einer SOAP Nachricht hnlich der nachfolgenden verpackt lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt BNLP lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1192111687392 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt 3105 lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt Function performed error free lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt lt ipgapi OrderId gt 62e3b5df 2911 4e89 8356 1e49302b1807 lt ipgapi OrderId gt lt ipgapi OrderId gt 62e3b5df 2911 4e89 8356 1e49302b1807 lt ipgapi OrderId gt IPG Integrationsleitfaden API Version 4 77 SCH First Data lt ipgapi ApprovalCode gt Y 440368 0000057177 PPXM 0043364291 lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt P
70. Kunden e Der Eingang dieser HTTPS Antwort veranlasst den Shop die SOAP Nachricht und das darin enthaltene XML Antwortdokument auszulesen e In Abh ngigkeit von den im XML Antwortdokument enthaltenen Daten wird an den Kunden eine Genehmigungsseite gesendet wenn die Transaktion erfolgreich war und andernfalls eine Fehlerseite e Die Genehmigungs oder Fehlerseite wird angezeigt Zusammengefasst muss Ihre Applikation folgende Schritte vollziehen um Zahlungstransaktionen einzureichen und das Ergebnis auszuwerten e Ein XML Dokument mit den kodierten Transaktionen erstellen e Das XML Dokument in eine SOAP Anfragenachricht packen e Eine HTTP POST Anfrage erstellen die im HTTP Header die n tigen Informationen zur Identifikation Ihres Shops und im Body die SOAP Anfragenachricht enth lt e Eine SSL Verbindung zwischen Ihrer Applikation und First Data Austria API aufbauen IPG Integrationsleitfaden API Version 4 11 a First Data e Die HTTPS POST Anfrage an das First Data Austria Internet Payment Gateway senden und die Antwort entgegennehmen e Die SOAP Antwortmitteilung aus dem Body der HTTPS Antwort auslesen e Das in der SOAP Antwortmitteilung enthaltene XML Antwortdokument analysieren Diese sieben Schritte sind in den nachfolgenden Kapiteln beschrieben IPG Integrationsleitfaden API Version 4 12 r First Data 5 Erstellung von Transaktionen in XML Dieses Kapitel beschreibt die Erstellung der verschiedenen Transaktionstypen in
71. PX lt ipgapi AVSResponse gt lt ipgapi TDate gt 1192140473 lt ipgapi TDate gt lt ipgapi TransactionResult gt APPROVED lt ipgapi TransactionResult gt lt ipgapi TerminalID gt 123456 lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt 00 lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt 440368 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 4291 lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt 004336 lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 11 2 SOAP Fehlernachricht Im Allgemeinen hat eine vom First Data Austria API Web Service zur ckgelieferte SOAP Fehlernachricht das folgende Format lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt SOAP ENV Fault gt lt faultcode gt SOAP ENV Client lt faultcode gt lt faultstring xml lang en US gt lt fault message gt lt faultstring gt lt detail gt lt fault message gt lt detail gt lt SOAP ENV Fault gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Grunds tzlich enth lt das Element faultstring den Fehlertyp Je nach Fehlertyp werden die anderen Elemente besetzt Bitte beachte
72. R color 525D76 gt lt style gt lt head gt lt body gt lt h1 gt HTTP Status 401 lt hl gt lt HR size 1 noshade noshade gt IPG Integrationsleitfaden API Version 4 160 SCH First Data lt p gt lt b gt type lt b gt Status report lt p gt lt p gt lt b gt message lt b gt lt u gt lt u gt lt p gt Sp lt b gt description lt b gt lt u gt This request requires HTTP authentication lt u gt lt p gt lt AR size 1 noshade noshade gt lt h3 gt Apache Tomcat 5 5 20 lt h3 gt lt body gt lt html gt Erkl rung User ID oder Passwort ist falsch IPG Integrationsleitfaden API Version 4 161
73. Request hinterlegen Dabei ist es auch m glich mehrere Datens tze gleichzeitig zur Speicherung zu bertragen Das folgende Beispiel zeigt die Hinteregung eines Datensatzes mit Kreditkartendaten sowie eines Eintrags mit Kontonummer und Bankleitzahl Bitte beachten Sie dass auch hier gilt wird eine bereits vorhandene Hosted Data ID bermittelt wird der bisher vorhandene Datensatz aktualisiert lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns2 Action gt lt ns2 StoreHostedData gt lt ns2 DataStorageltem gt lt ns2 CreditCardData gt lt ns3 CardNumber gt 4035875676474977 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt lt ns3 ExpYear gt 08 lt ns3 ExpYear gt lt ns2 CreditCardData gt lt ns2 HostedDataID gt d763bba7 1cfa 4d3d 94af 9fbe29ec0e26 lt ns2 HostedDataID gt lt ns2 DataStorageItem gt lt ns2 DataStorageltem gt lt ns2 DE DirectDebitData gt lt ns3 BankCode gt 50014560 lt ns3 BankCode gt lt ns3 AccountNumber gt 32121503 lt ns3 AccountNumber gt lt ns2 DE DirectDebitData gt lt ns2 HostedDataID gt 691c7cb3 a752 4d6d abde 83cad63de258 lt ns2 HostedDataID gt lt ns2 DataStorageItem gt lt ns2 StoreHostedData gt lt ns2 Action gt lt ns4 IPGApiActionRequest gt Bei erfolgreicher Hinterlegung erhalten Sie folg
74. SCH First Data Internet Payment Gateway Integrationsleitfaden API First Data Austria GmbH Leonard Bernstein StraBe 10 1220 Wien 2015 First Data Austria GmbH Alle Rechte vorbehalten SCH First Data Internet Payment Gateway INTEGRATIONSLEITFADEN API Version 4 Inhalt GO BE N gt 5 1 5 1 1 5 1 2 5 1 3 5 1 4 5 1 5 5 1 6 5 1 7 5 2 5 2 1 5 2 2 5 2 3 5 2 4 5 2 5 5 3 5 3 1 5 3 2 5 3 3 Das aufgef hrte XML Statement ist ein Beispiel f r eine Stornierungs Transaktion mit Einf hrung Notwendige Elemente So funktioniert die API Transaktionen an das Gateway senden Erstellung von Transaktionen in XML Kreditkarten Lastschrift Transaktionen Sale Verkauf PreAuth Vorautorisierung PostAuth Buchung einer Vorautorisierung ForcedTicket Buchung telefonisch erfolgter Vorautorisierungen Return R ckzahlung Credit Gutschrift Void Storno ClickandBuy Wiederkehrende Bezahltransaktionen Return R ckzahlung Void Storno Credit Gutschrift Transaktionsstatus PayPal Wiederkehrende Zahlungen Return Stornierung dem minimalen Set an Befehlen 5 3 4 5 4 5 4 1 Gutschrift SOFORT berweisung Return 6 Zus tzliche Aktionen ber den Web Service IPG Integrationsleitfaden API Version 4 11 13 13 13 14 14 15 15 16 16 18 18 18 19 19 20 21 21 22 23 23 23 25 25 25 SCH First Data 6 1 6 2 6 3 6 3 1 Manueller Kassenschnitt Anfra
75. Strings ws101 1 myPw ist HTTP Body SOAP Anfrage XML Der Body der HTTP POST Anfrage enthalt die SOAP Anfragemitteilung IPG Integrationsleitfaden API Version 4 86 SCH First Data 13 1 PHP HTTP Kommunikation in PHP erfolgt meist mit Hilfe von cURL das sowohl als Bibliothek als auch als Befehlszeilen Tool erh ltlich ist In neuere PHP Versionen ist cURL bereits als Erweiterung integriert die noch aktiviert werden muss damit die cURL Funktionalit t in jedem PHP Skript verf gbar ist Wenn Ihr Web Server unter Microsoft Windows l uft ist dies schnell erledigt Auf Unix Linux Maschinen muss dazu PHP m glicherweise erst kompiliert werden Darum k nnten Sie anstelle der Verwendung der cURL Erweiterung auch in Betracht ziehen das cURL Befehlszeilentool Ihres PHP Skripts aufzurufen Nachfolgend sind beide Vorgehensweisen ber cksichtigt wobei wir mit der Nutzung der cURL Erweiterung in PHP 5 2 4 auf einer Windows Maschine beginnen 13 1 1 cURL PHP Erweiterung nutzen In den meisten F llen gen gt f r die Aktivierung der CURL Erweiterung in PHP 5 2 4 die Kommentarkennzeichnung der folgenden Zeile in der php ini Konfigurationsdatei zu entfernen extension php curl dll Bitte beachten Sie dass andere PHP Versionen andere Vorgehensweisen erfordern k nnten um die cURL Unterst tzung in PHP zu aktivieren Weitere Informationen hierzu finden Sie in Ihrer PHP Dokumentation Nach Aktivierung von CURL wird eine HTTP
76. XML Wie im vorangehenden Szenario ausgef hrt wird eine Transaktion erst in einem XML Dokument kodiert das seinerseits als Nutzlast in eine SOAP Nachricht verpackt wird Das bedeutet die XML kodierte Transaktion entspricht den Parametern die an die First Data Austria API Web Service Operation bermittelt werden Bitte beachten Sie dass es eine Vielzahl von Web Service Tools gibt die Sie bei der Erstellung von Client Stubs unterst tzen und es ihnen vielleicht ersparen sich mit dem eigentlichen XML Format n her auseinanderzusetzen Ein grundlegendes Verst ndnis des XML Formats ist jedoch unabdingbar daf r korrekte Transaktionen unabh ngig von der verf gbaren Unterst tzung durch Tools erstellen zu k nnen Darum sollten Sie sich mit dem XML Format vertraut machen das First Data Austria API f r die Kodierung von Transaktionen verwendet 5 1 Kreditkarten Lastschrift Transaktionen Unabh ngig vom Transaktionstyp sieht die grundlegende Struktur des XML Dokuments einer Kreditkarten Lastschrift Transaktion wie folgt aus lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl CreditCardTxType gt lt vl CreditCardData gt lt vl CreditCardData gt lt vl Payment gt lt vl Payment gt lt vl TransactionDetails gt lt vl TransactionDetails gt lt vl Billing gt lt vl Billi
77. abgelehnt Die vom Merchant Plug in generierte XID muss f r Visa Transaktionen gesetzt werden Bitte entnehmen Sie Details zu diesen Feldern den 3D Secure Dokumentationen der Kreditkartenorganisationen lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1233659493267 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS 005002 The merchant is not setup to support the requested service lt ipgapi ErrorMessage gt lt ipgapi OrderId gt IPGAPI REQUEST 9c555d62 3850 4726 8589 5a2444c98c5d lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt lt ipgapi TransactionResult gt FAILED lt ipgapi TransactionResult gt lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt detail gt Erkl rung In diesem Beispiel wurde versucht eine Direct Debit Transaktion zu senden jedoch ist der H ndler f r diese Zahlungsart nicht registriert Sollten Sie dieses Ergebnis f r eine Zahlart bekommen die Sie beauftragt haben kontaktieren Sie bitte unser technsiches Support Team IPG I
78. al gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 OrderId gt A 65aacf74 72ac 4684 b447 abb6d54ea5e4 lt ns3 OrderId gt lt ns3 TransactionDetails gt lt ns4 IPGApiOrderResponse gt lt ns4 ErrorMessage gt Invalid credit card number lt ns4 ErrorMessage gt lt ns4 OrderId gt A 65aacf74 72ac 4684 b447 abb6d54ea5e4 lt ns4 OrderId gt lt ns4 TransactionTime gt 1250599045 lt ns4 TransactionTime gt lt ns4 IPGApiOrderResponse gt lt ns2 TransactionValues gt lt ns4 IPGApiActionResponse gt Erfolgreich berpr fte Kreditkarten k nnen im selben Weg gespeichert werden wie Sale Transaktionen Details finden Sie im Kapitel Erweiterungsfunktion Data Storage IPG Integrationsleitfaden API Version 4 44 r First Data 6 7 Transaktionsstatus Einige Payment Endpoints senden das Transaktionsergebnis nicht in Ihrer Antwort mit In diesen F llen sendet das IPG einen Best tigungscode der mit einem Fragzeichen beginnt Der Befehl GetExternalTransactionState erlaubt Ihnen den Status solcher Transaktionen abzufragen 6 8 Anfrage von email notifications Der Befehl SendEMailNotification st t eine Email Benachrichtigung an f r eine definierte Transaktion an Weitere Informationen zum Thema Email Benachrichtigungen finden Sie im Benutzerhandbuch lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipg
79. ame cardholder s statement vl TransactionDetails xs string Stores the comments vi Comments 10 1 9 InquiryRateReference Path Name XML Schema Description type vl InquiryRateReference xs long A reference to a rate inquiry for vl InquiryRateld transactions with Global Choice or Dynamic Pricing vl InquiryRateReference xs boolean Specifies whether a cardholder has vl DccApplied choosen to accept the proposed currency conversion offering when using Global Choice IPG Integrationsleitfaden API Version 4 73 SCH First Data 10 1 10 Billing Path Name XML Schema type Description vl Billing vl CustomerID xs string Stores your ID for your customer vl Billing vl Name xs string Stores the customer s name If provided it will appear on your transaction reports vl Billing vl Company xs string Stores the customers company If provided it will appear on your transaction reports vl Billing vl Addressl xs string Stores the first line of the customer s address If provided it will appear on your transaction reports vl Billing vl Address2 xs string Stores the second line of the customer s address If provided it will appear on your transaction reports vl Billing vl City xs string Stores the customer s city If provided it will appear on your transaction reports vl Billing vl State xs string Stores the cu
80. api IPGApiOrderResponse xmlns ipgapi https ipg online com ipgapi schemes ipgapi gt lt ipgapi CommercialServiceProvider gt BNLP lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1192111156423 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt IPG Integrationsleitfaden API Version 4 80 SCH First Data Card expiry date exceeded lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS 000033 lt ipgapi ErrorMessage gt lt ipgapi OrderId gt Card expiry date exceeded 62e3b5df 2911 4e89 8356 1e49302b1807 lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt 1192139943 lt ipgapi TDate gt lt ipgapi TransactionResult gt FAILED lt ipgapi TransactionResult gt lt ipgapi lt ipgapi lt ipgapi lt ipgapi lt ipgapi lt ipgapi IPGApiOrderResponse gt lt detail gt lt SOAP ENV Fault gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Terminal ID gt 123456 lt ipgapi TerminalID gt ProcessorResponseCode gt ProcessorApprovalCode gt ProcessorReceiptNumber gt ProcessorTraceNumber gt Die Unterelemente der SOAP Fehlermitteilung relativ zum Element SOAP ENV Envelope SOAP ENV Body SOAP ENV Fault werden wie folgt gesetzt Pfad Name XML Schematyp
81. api schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 xmlns ns4 http api clickandbuy com webservices pay 1 0 0 gt lt ns2 Action gt lt ns2 SendEMailNotification gt lt ns2 OrderId gt 0 8 15 lt ns2 OrderId gt lt ns2 TDate gt 1250599046 lt ns2 TDate gt lt ns2 SendEMailNotification gt lt ns2 Action gt lt ns5 IPGApiActionRequest gt 6 9 Warenkorbinformationen und Produktkatalog 6 9 1 Warenkorbinformationen in Transaktionsbenachrichtigungen Das folgende Beispiel zeigt wie Warenkorbinformationen genutzt werden k nnen um Details ber die Verk ufe zu dokumentieren lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt xmlns ns3 lt ns2 Transaction gt lt ns2 CreditCardTxType gt IPG Integrationsleitfaden API Version 4 45 SCH First Data lt ns2 Type gt sale lt ns2 Type gt lt ns2 CreditCardTxType gt lt ns2 CreditCardData gt lt ns2 CardNumber gt 49358 7XXXXXX4977 lt ns2 CardNumber gt lt ns2 ExpMonth gt 12 lt ns2 ExpMonth gt lt ns2 ExpYear gt 14 lt ns2 ExpYear gt lt ns2 CreditCardData gt lt ns2 Payment gt lt ns2 ChargeTotal gt 1 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns2 Currency gt lt ns2 Payment gt
82. as Sitem Sresult Sresult Sitem gt 15 2 ASP Die Durchf hrung des eigentliche HTTP Aufrufs mit WinHTTP in ASP besteht aus einem einfachen Operationsaufruf mit der SOAP Anfrage XML als Parameter Nach erfolgreicher Durchf hrung der Anfrage wird eine SOAP Antwort oder Fehlermeldung zur ckgeliefert die durch Zugriff auf die responseText Eigenschaft des Anfrageobjekts als Zeichenkette ausgelesen werden kann Wie eine solche SOAP Antwortnachricht aussieht ist im n chsten Kapitel beschrieben Die folgenden Statements vervollst ndigen das ASP Skript lt language javascript gt lt html gt lt body gt lt doing the HTTP call with the SOAP request message as input request send body saving the SOAP response message in a string variable var response request responseText gt lt body gt lt html gt IPG Integrationsleitfaden API Version 4 94 SCH First Data 16 Verwendung eines Java Client zur Nutzung des Web Service First Data Austria bietet einen Java Client an der Ihnen die Nutzung des Web Service des Internet Payment Gateways schnell und einfach erm glicht Eine Instanz der IPGApiClient Klasse steuert die Verbindung mit dem Web Service erstellt XML und SOAP Nachrichten und wertet die Antwortnachrichten aus Um eine Transaktion zu generieren oder eine Antwort zu verarbeiten werden einfache Java Bean Klassen verwendet 16 1 Erzeugung einer IPGApiClient Instanz Der IPGApiClient
83. as v1 gt lt ns4 successfully gt true lt ns4 successfully gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt preauth lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 Orderld gt A 5337067b 33cb 4173 b003 129ccf437c0c lt ns3 OrderId gt lt ns3 TDate gt 1250599046 lt ns3 TDate gt lt ns3 TransactionDetails gt lt ns4 IPGApiOrderResponse gt IPG Integrationsleitfaden API Version 4 42 SCH First Data IPG Integrationsleitfaden API lt ns4 ApprovalCode gt Y 66923202 0000075790 PPXM 0011511144 lt ns4 ApprovalCode gt lt ns4 lt ns4 AVSResponse gt PPX lt ns4 AVSResponse gt CommercialServiceProvider gt BNLP lt ns4 CommercialServiceProvider gt lt ns4 OrderId gt A 5337067b 33cb 4173 b003 129ccf437c0c lt ns4 OrderId gt lt ns4 ProcessorApprovalCode gt 66923202 lt ns4 ProcessorApprovalCode gt lt ns4 ProcessorReceiptNumber gt 1144 lt ns4 ProcessorReceiptNumber gt lt ns4 ProcessorReferenceNumber gt 66923202 lt ns4 ProcessorReferenceNumber gt lt ns4 lt ns4 ProcessorResponseCode gt 00 lt ns4 ProcessorResponseCode gt ProcessorResponseMessage gt Function performed error free lt ns4 ProcessorResponseMessage gt
84. ata v1 ExpYear S a v1 CreditCardData v1 CardCodeValue o j i v1 CreditCardData v1 TrackData B b p b v1 CreditCardData v1 Brand 2 2 v1 CreditCard3DSecure 3 3 3 3 v1 VerificationResponse v1 CreditCard3DSecure S amp v1 PayerAuthenticationResponse v1 CreditCard3DSecure S s v1 AuthenticationValue IPG Integrationsleitfaden API Version 4 57 SCH First Data v1 CreditCard3DSecure v1 XID v1 ClickandBuyTxType v1 Type v1 ClickandBuyData cab OrderDetails Payment HostedDatalD Payment HostedDataStorelD Payment DeclineHostedDataDuplicates Payment SubTotal v1 Payment v1 ValueAddedTax v1 Payment v1 DeliveryAmount v1 Payment v1 ChargeTotal v1 Payment v1 Currency v1 TransactionDetails v1 Orderld v1 TransactionDetails vi lp v1 TransactionDetails v1 ReferenceNumber v1 TransactionDetails v1 Tdate v1 TransactionDetails v1 TransactionOrigin v1 TransactionDetails v1 InvoiceNumber v1 TransactionDetails v1 PONumber 9 gt Q S v1 TransactionDetails v1 DynamicMerchantNumber gt 2 v1 TransactionDetails o 5 O v1 Comments v1 TransactionDetails v1 Terminal o o o o v1 TerminallD v1 TransactionDetails v1 InquiryRateReference v1 Billing v1 CustomerlD IPG Integrationsleitfaden API Version 4 r First Data
85. c For authorized use only OU Class 3 Public Primary Certification Authority G2 O VeriSign Inc C US Seriennummer 7dd9fe07cfa8leb7107967fba78934c6 G ltig von Mon May 18 02 00 00 CEST 1998 bis Wed Aug 02 01 59 59 CEST 2028 Digitaler Fingerabdruck des Zertifikats MD5 A2 33 9B 4C 74 78 73 D4 6C E7 C1 F3 8D CB 5C E9 SHAl 85 37 1C A6 E5 50 14 3D CE 28 03 47 1B DE 3A 09 E8 F8 77 0F Unterschrift Algorithmusname SHAlwithRSA Version 1 k lt K K x k k K k K lt k x K k lt K x x K k x KIT x lt TH x KH K x AH lt x lt x x A x lt KKKA K x k k k K x x K k k x lt lt x x K k lt x x k k lt x x x K x A lt lt x x x x lt KK Aliasname cacert Erstellungsdatum 23 07 2008 Eintragstyp trustedCertEntry Eigner OU Equifax Secure Certificate Authority O Fquifax C US Aussteller OU Equifax Secure Certificate Authority O Equifax C US Seriennummer 35def4cf G ltig von Sat Aug 22 18 41 51 CEST 1998 bis Wed Aug 22 18 41 51 CEST 2018 Digitaler Fingerabdruck des Zertifikats MD5 67 CB 9D C0 13 24 8A 82 9B B2 17 1E D1 1B EC D4 SHAl D2 32 09 AD 23 D3 14 23 21 74 E4 0D 7F 9D 62 13 97 86 63 3A Unterschrift Algorithmusname SHAlwithRSA Version 3 Erweiterungen 1 ObjectId 2 5 29 16 Criticality false PrivateKeyUsage To Wed Aug 22 18 41 51 CEST 2018 2 ObjectId 2 5 29 15 Criticality false KeyUsage K
86. ciated with an element type ns3 IPGApiOrderRequest lt detail gt M gliche Erkl rung Der Wert eines Attributs ist nicht in Anf hrungszeichen The prefix ipgapi for element ipgapi lt detail gt XML is not wellformed The prefix ipgapi for element ipgapi IPGApiOrderRequest is not bound lt detail gt M gliche Erkl rung Der Namensraum ipgapi ist nicht deklariert Um einen Namensraum zu deklarieren muss das Pr fix xmIns verwendet werden z B xmins ipgapi http ipg online com ipgapi schemas ipgapi as attribute in the top level tag of the IPG API message IPGApiOrderRequest or IPGApiActionReguest The prefix xmin for attribute xmin ns2 lt detail gt XML is not wellformed The prefix xmln for attribute xmln ns2 associated with an element type ns3 IPGApiOrderRequest is not bound lt detail gt M gliche Erkl rung Um einen eigenen Namensraum zu deklarieren ist nur xmlns erlaubt In diesem Fall wurde xmin verwendet Unable to create envelope from given source lt detail gt XML is not wellformed Unable to create envelope from given source because the namespace was not recognized lt detail gt IPG Integrationsleitfaden API Version 4 146 SCH First Data M gliche Erkl rung Die XML Nachricht sowie die SOAP Nachricht sind korrekt jedoch hat die IPG API Nachricht im Body keinen oder falsch deklarierte Namensr ume Die korrekten Namensr ume sind in
87. ckandBuy die ber Connect oder das Virtuelle Terminal des First Data Austria Internet Payment Gateways eingereicht wurde kann auch die API bis zur maximalen Transaktionszahl oder dem autorisierten Betrag genutzt werden Das folgende XML Dokument entspricht einem Beispiel f r eine PostAuth Transaktion mit den minimal notwendigen Elementen lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http api clickandbuy com webservices pay 1 0 0 xmlns ns3 http ipg online com ipgapi schemas al xmlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 ClickandBuyTxType gt lt ns4 Type gt postAuth lt ns4 Type gt lt ns4 ClickandBuyTxType gt lt ns4 Payment gt lt ns4 ChargeTotal gt 1 lt ns4 ChargeTotal gt lt ns4 Currency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4 48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel Ubersicht der XML Tags 5 2 2 Return R ckzahlung Das folgende XML Dokument entspricht einem Beispiel f r eine Return Transaktion mit den minimal notwendigen Elementen lt ns5 IPGApiOrderReguest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http api clickandb
88. ctionRequest gt Eine erfolgreiche L schung wird mit folgender Antwort best tigt lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 IPGApiActionResponse gt 7 7 Pr fen bestehender Datensatze Gespeicherte Kreditkartendetails k nnen mit der Aktion Validate berpr ft werden lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 hmlns ns4 http api clickandbuy com webservices pay 1 0 0 gt lt ns2 Action gt lt ns2 Validate gt IPG Integrationsleitfaden API Version 4 54 SCH First Data lt ns3 Payment gt lt ns3 HostedDataID gt 5937c993 8011 46e6 b9bc fac07eff4b50 lt ns3 HostedDataID gt lt ns3 Payment gt lt ns2 Validate gt lt ns2 Action gt lt ns5 IPGApiActionRequest gt Eine Pr fung deutscher Debitkarten wird nicht unterst tzt und wird mit einer Fehlermeldung beantwortet 7 8 L schen bestehender Datensatze Mit der Aktion Delete k nnen Datens tze die nicht l nger ben tigt werden gel scht werden lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas al
89. ec689716 lt ns3 OrderId gt lt ns3 Ip gt 127 0 0 1 lt ns3 Ip gt lt ns3 TDate gt 1273570670 lt ns3 TDate gt lt ns3 TransactionOrigin gt ECI lt ns3 TransactionOrigin gt lt ns3 TransactionDetails gt lt ns3 Billing gt lt ns3 CustomerID gt customerID lt ns3 CustomerID gt lt ns3 Billing gt lt ns4 IPGApiOrderResponse gt lt ns4 ApprovalCode gt Y 533118 0000144821 PPXM 0160050943 lt ns4 ApprovalCode gt lt ns4 AVSResponse gt PPX lt ns4 AVSResponse gt lt ns4 OrderId gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns4 OrderId gt lt ns4 ProcessorApprovalCode gt 533118 lt ns4 ProcessorApprovalCode gt lt ns4 ProcessorReceiptNumber gt 0943 lt ns4 ProcessorReceiptNumber gt lt ns4 ProcessorTraceNumber gt 016005 lt ns4 ProcessorTraceNumber gt lt ns4 TDate gt 1273570670 lt ns4 TDate gt lt ns4 TDateFormatted gt 2010 05 11 11 37 50 MESZ lt ns4 TDateFormatted gt lt ns4 TerminalID gt 54000669 lt ns4 TerminalID gt lt ns4 IPGApiOrderResponse gt lt ns2 ReceiptNumber gt 943 lt ns2 ReceiptNumber gt lt ns2 TraceNumber gt 16005 lt ns2 TraceNumber gt lt ns2 TransactionState gt CAPTURED lt ns2 TransactionState gt lt ns2 TransactionValues gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt void lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 CreditCardData gt lt ns3 CardNumber gt 5426 4979 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt
90. ei der Einrichtung Ihrer Applikation f r die Nutzung von First Data Austria API unterst tzen erfordern dieses Passwort f r die Client Authentifizierung gegen ber dem Internet Payment Gateway Seine Namenssyntax lautet ckp creation Timestamp Ein Beispiel ckp 1193927132 Client Certificate PEM File Das in einer PEM Datei gespeicherte Client Zertifikat Der Dateiname folgt der Syntax wsstorelD userlD pemlm Beispielfall der oben genannten Store ID User ID w rde er WS10012345678 1 pem lauten Einige Tools die Sie bei der Einrichtung Ihrer Applikation f r die Nutzung von First Data Austria API unterst tzen erfordern anstelle der oben erw hnten p12 Datei diese Datei Server Certificate PEM File Das in der PEM Datei geotrust pem gespeicherte Server Zertifikat Es identifiziert den Server auf dem First Data Austria API l uft F r eine Verbindung mit Java ben tigen Sie das truststore ks file IPG Integrationsleitfaden API Version 4 8 SCH First Data 3 So funktioniert die API Im Folgenden wird die Funktionsweise von First Data Austria API anhand einer Kreditkarten Transaktion erkl rt Andere Transaktionsarten erfolgen nach demselben Prinzip In den meisten F llen leitet ein Kunde den Kommunikationsprozess im Ganzen ein indem er Waren oder Dienstleistungen mit seiner Kreditkarte in Ihrem Online Shop bezahlt In der Folge sendet Ihr Shop eine Kreditkartentransaktion in der Regel zur Abbuchung des Betrags vom Konto des Kund
91. ei keine mit einer spezifischen Plattform verbundenen Anforderungen da der Web Service Standard auf einem Bestand an offenen Standards basiert Kurz gesagt sind Sie frei in der Wahl einer beliebigen Programmiersprache z B J2EE NET PHP ASP usw die Ihre Applikation in die Lage versetzt mit dem First Data Austria API Web Service zu kommunizieren e Einfache Integration Die Kommunikation mit einem Web Service ist einfach Ihre Applikation muss dazu eine SOAP Anfragenachricht erstellen die Ihre Transaktion enth lt sie via HTTPS an den Web Service senden und auf eine SOAP Antwortnachricht mit dem Statusbericht zu Ihrer Transaktion warten Da SOAP und HTTP mit dem Ziel einer gewissen bersichtlichkeit entwickelte Protokolle sind ist die Erstellung von Anfragen und Antworten nicht sehr schwierig Au erdem m ssen Sie dies nur selten selbst programmieren da es in nahezu jeder Programmiersprache hierf r ein reichhaltiges Angebot an Bibliotheken gibt Im Allgemeinen ben tigt man f r die Erstellung einer SOAP Anfrage und die Verarbeitung der Antwort nur wenige ZeilenProgrammcode e Sicherheit S mtliche Kommunikation zwischen Ihrer Applikation und First Data Austria API ist SSL verschl sselt Dies erm glicht die Verwaltung eines Client Zertifikats durch Ihre Applikation das die Anwendung gegen ber dem Web Service eindeutig identifiziert In gleicher Weise verwaltet First Data Austria API ein Server Zertifikat das Ihre Applikation da
92. eiterung das cURL Befehlszeilentool zu verwenden Die Nutzung dieses Tools erfordert keinerlei PHP Konfigurationsbem hungen Ihr PHP Skript muss nur die ausf hrbare Programmdatei mit einem Bestand von Parametern aufrufen Da die Sicherheitseinstellungen erst im folgenden IPG Integrationsleitfaden API Version 4 87 F rst Data Kapitel behandelt werden zeigt das Skript unten nur die Einrichtung der HTTP Standardparameter Die SSL Parameter kommen im n chsten Kapitel hinzu lt php storing the SOAP message in a variable note that you have to escape and Nn since the latter makes the command line tool fail furthermore note that the plain XML code is passed here as string for reasons of simplicity however it is certainly a good practice to build the XML e g with DOM finally when using special characters you should make sure that the XML string gets UTF 8 encoded which is not done here Sbody lt SOAP ENV Envelope gt lt SOAP ENV Envelope gt setting the path to the cURL command line tool adapt this path to the path where you have saved the cURL binaries Spath C curl curl exe setting the IPG API URL SapiUrl https test ipg online com ipgapi services setting the content typ ScontentType header Content Type text xml setting the authorization method to BASIC and supplying your credentials user
93. eitfaden API Version 4 132 SCH First Data lt xs element name GetExternalConsumerInformation gt lt xs complexType gt lt xs seguence gt lt xs element name Storeld type v1 String2 max minOccurs gt lt xs element name OrderId type v1 String1 max minOccurs gt lt xs element name DataProvider gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value Biirgel gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name FirstName type v1 String3 max gt lt xs element name Surname type v1 String3 max gt lt xs element name Birthday type a1 StringDate gt lt xs element name Street type v1 String3 max gt lt xs element name HouseNumber type v1 String1 max gt lt xs element name PostCode type v1 String1 max gt lt xs element name City type v1 String30max gt lt xs element name Country gt lt xs simpleType gt lt xs restriction base xs string gt lt ISO 3166 gt lt xs pattern value 8 9 3 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name DisplayProcessorMessages type xs boolean minOccurs default true gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name GetLastOrders gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String2 max minOccurs
94. element gt IPG Integrationsleitfaden API Version 4 131 SCH First Data lt xs element name Email type v1 String64max minOccurs 0 gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name Validate gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String20max minOccurs gt lt xs choice gt lt xs element name CreditCardData type v1 CreditCardData minOccurs 9 gt lt xs element name CustomerCardData type v1 CustomerCardData minOccurs 0 73 lt xs element name DE DirectDebitData type v1 DE_DirectDebitData minOccurs gt lt xs choice gt lt xs element ref v1 Payment minOccurs gt lt xs element name TransactionDetails type v1 TransactionDetails minOccurs gt lt xs element ref v1 Billing minOccurs gt lt xs Sequence gt lt xs complexType gt lt xs element gt lt xs element name GetExternalTransactionStatus gt lt xs complexType gt lt xs all gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name OrderId type v1 Stringl max gt lt xs element name TDate minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt IPG Integrationsl
95. ement name UnpredictableNumber 9F37 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 4 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name TLVData gt IPG Integrationsleitfaden API Version 4 119 SCH First Data lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs maxLength value 1024 gt lt xs restriction gt lt xs simpleType gt lt xs element gt Gi see gt gt lt common gt gt gt lt xs element name CreditCard3DSecure gt lt xs complexType gt lt xs all gt lt xs element name VerificationResponse gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value N gt lt xs enumeration value U gt lt xs enumeration value Y gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name PayerAuthenticationResponse minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value A gt lt lt xs enumeration value E gt gt lt xs enumeration value N gt lt xs enumeration value U gt lt xs enumeration value Y gt lt xs restriction gt lt
96. en via First Data Austria API Nach Empfang der Transaktion leitet das First Data Austria Internet Payment Gateway die Transaktion zur Genehmigung an den Kreditkartenprozessor weiter Je nach Ergebnis wird die Genehmigung oder eine Fehlermeldung an Ihren Online Shop zur ckgesendet Das bedeutet dass s mtliche Aspekte der Kommunikation und Verarbeitung von der First Data Austria API Schnittstelle abgedeckt werden und Sie nur wissen m ssen wie Sie mit diesem Web Service kommunizieren Transaktion Kauf durchf hren Verarbeiten EV H gt x Ergebnisseite Ergebnis Genehmigung senden senden Ablehnung Online Shop First Data senden Kreditkartenprozessor Der Web Service Standard definiert eine solche Schnittstelle mittels Web Service Definition Language WSDL Im Falle von First Data Austria API finden Sie eine WSDL Datei zur Definition des Web Service unter https test ipg online com ipgapi services order wsdl Bitte beachten Sie dass Sie Ihr Client Zertifikat Ihre Identifizierungsangaben und das Server Zertifikat bereitstellen m ssen um die Datei in einem Web Browser einzusehen oder abzurufen Wenn Sie beispielsweise die WSDL Datei in Microsoft Internet Explorer unter Microsoft Windows XP betrachten wollen m ssen Sie zuerst Ihr Client Zertifikat und das Server Zertifikat installieren und dann die oben genannte URL aufrufen Dazu f hren Sie folgende Schritte aus 1 ffnen Sie den Ordner in dem Sie Ihre p1
97. ence gt lt ChargeTotal SubTotal ValueAddedTax DeliveryAmount gt IPG Integrationsleitfaden API Version 4 121 SCH First Data lt xs element name ChargeTotal type v1 AmountValueType gt lt xs element name Currency type v1 CurrencyType gt lt xs element gt lt xs sequence gt lt xs group gt lt xs complexType name TransactionDetails gt lt xs all gt lt xs element name Comments type v1 String1 24max minOccurs 0 gt lt xs element name InvoiceNumber type v1 String48max minOccurs gt lt xs element name DynamicMerchantName type v1 String1 max minOccurs gt lt xs element name PONumber type v1 String128max minOccurs gt lt xs element name OrderId type v1 String1 max minOccurs gt lt xs element ref v1 0fflineApprovalType minOccurs gt lt xs element name Ip minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 25 0 5 2 4 1 9 1 9 9 3 25 5 2fe a l e 9 1 9 e 9 1 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ReferenceNumber minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value NEW 9a zA Z 1 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TDate minOccurs gt lt xs simpleType gt lt xs
98. ency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 Billing gt lt ns4 Email gt x y zz lt ns4 Email gt lt ns4 Billing gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt Anders als andere Bezahlmethoden beinhalten ClickandBuy Transaktionen keine Kartennummer Daf r ben tigen diese Transaktionen die registrierte eMail Adresse des Zahlungsempf ngers Die eMail Adresse ist in das Feld ns4 Billing ns Email einzutragen 5 2 5 Transaktionsstatus nderungen im Status von ClickandBuy Transaktionen werden automatisch im ClickandBuy Merchent Messege System MMS angezeigt Wenn Sie den letzten Status der Transaktion anfragen wollen k nnen Sie den API Webservice GetExternalTransactionStatus nutzen lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http api clickandbuy com webservices pay 1 0 0 xmlns ns3 htp ipg online com ipgapi schemas al xmlns ns4 http ipg online com ipgapi schemas v1 gt lt ns3 Action gt lt ns3 GetExternalTransactionStatus gt lt ns3 OrderId gt C 32121f4d 852f 4 48 8095 8585b917c079 lt ns3 OrderId gt lt ns3 TDate gt 1321603908 lt ns3 TDate gt lt ns3 GetExternalTransactionStatus gt lt ns3 Action gt lt ns5 IPGApiActionReguest gt Nach einer erfolgreichen Transaktion ist der aktuelle Status in der Antwort im Feld TransactionState abrufbar lt ipgapi IPGApiActionResponse xmlns ipgapi http ipg online com ipgap
99. ende Best tigung lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 IPGApiActionResponse gt IPG Integrationsleitfaden API Version 4 52 SCH First Data Konnten eine oder mehrere Datens tze nicht hinterlegt werden werden die betroffenen Hosted Data IDs in der Antwort entsprechend gekennzeichnet lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas vl gt lt ns4 successfully gt true lt ns4 successfully gt lt ns2 Error Code SGSDAS 020300 gt lt ns2 ErrorMessage gt Could not store the hosted data id 691c7cb3 a752 4d6d abde 83cad63de258 Reason An internal error has occured while processing your reguest lt ns2 ErrorMessage gt lt ns2 Error gt lt ns4 IPGApiActionResponse gt 7 4 Sperrung der Verwendung von gleichen Zahlungsinformationen f r mehrere Datens tze Zur Vermeidung dass Kunden sich bei Ihnen mehrmals mit denselben Zahlungsinformationen registrieren k nnen besteht die M glichkeit bei der Speicherung das zus tzliche Tag DeclineHostedDataDuplicates zu bermitteln G ltige Werte f r diesen Parameter sind true und false Wird der Wert true bergeben u
100. ent gt lt xs element name Terminal gt lt xs complexType gt lt xs all gt IPG Integrationsleitfaden API Version 4 123 SCH First Data lt xs element name TerminalID gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 0 9 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name OfflineApprovalType gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value OFFLINE APPROVAL gt lt Fallback Unable to go online approval gt lt xs enumeration value FALLBACK gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionOrigin default ECI gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value ECI gt lt xs enumeration value MOTO gt lt xs enumeration value RETAIL gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name Billing gt lt xs complexType gt lt xs all gt lt xs element lt xs element lt xs element lt xs element lt xs element name CustomerID type v1 String32max minOccurs gt name Name type v1 String96max minOccurs gt name Company type v1 String96max minOccurs gt name Address1 type v1 St
101. equence gt lt xs complexType gt lt xs element name TransactionValues gt lt xs complexType gt IPG Integrationsleitfaden API Version 4 141 SCH First Data lt xs complexContent gt lt xs extension base v1 Transaction gt lt xs seguence gt lt xs element ref ipgapi IPGApiOrderResponse minOccurs gt lt xs element name ReceiptNumber type xs string minOccurs gt lt xs element name ResponseCode type xs string minOccurs gt lt xs element name TraceNumber type xs string minOccurs gt lt xs element name TransactionState type xs string minOccurs gt lt xs element name UserID type xs string minOccurs gt lt xs element name GiroPayTxType type v1 DE DirectDebitTxType minOccurs gt lt xs element name GiroPayData type v1 DE DirectDebitData minOccurs gt lt xs element name SubmissionComponent type xs string minOccurs gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs element gt lt xs complexType name RecurringPaymentValues gt lt xs complexContent gt lt xs extension base a1 RecurringPaymentInformation gt lt xs seguence gt lt xs element name State gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value Cancelled gt lt xs enumeration value Inactivated gt lt xs enumeration value Installed gt lt xs re
102. er HostedDatalD Zahlungstransaktionen durchf hren ohne dass eine erneute Angabe von Kartennummer und Verfalldatum bzw Kontonummer und Bankleitzahl notwendig sind Bitte beachten Sie dass die Kartenpr fnummer meistens auf der R ckseite der Kreditkarte nicht gespeichert werden darf und daher bei Kreditkartenzahlungen zus tzlich vom Kunden angegeben werden muss F r den Zahlungsablauf im Shop empfiehlt es sich in Ihrem System z B auch die letzten vier Stellen der hinterlegten Kreditkartennummer vorzuhalten sodass Sie diese dem Kunden anzeigen k nnen und er wei welche seiner ggf mehreren Karten bei Ihnen f r die Zahlung registriert ist lt ipgapi IPGApiOrderRequest xmins vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt IPG Integrationsleitfaden API Version 4 51 SCH First Data lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt sale lt vl Type gt lt vl CreditCardTxType gt lt vl Payment gt lt v1 HostedDataID gt HDID customer 1234567 lt v1 HostedDataID gt lt vl ChargeTotal gt 19 00 lt vl ChargeTotal gt lt vl Currency gt 978 lt vl Currency gt lt v1 Payment gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt 7 3 Hinterlegen eines Datensatzes ohne gleichzeitige Zahlungstransaktion Neben der M glichkeit neue Datens tze im Zuge einer Zahlungstransaktion zu hinterlegen k nnen Sie auch Hosted Data IDs ber einen Action
103. er kann optional an Stelle von CardNumber ExpMonth und ExpYear bergeben werden Hierbei m ssen mindestens die zusammenh ngenden Daten aus Spur 1 und 2 inkl der Trenner 3 2 bergeben werden Spur 3 Daten sind optional vl CreditCardData xs string vl TrackData Optionales Feld f r die Bezeichnung der Kreditkarte Bei Nutzung des Feldes wird die Transaktion dann ausgef hrt wenn die Kartennummer mit dem Brand bereinstimmt 9 2 3 CreditCard3DSecure Pfad Name XML Beschreibung Schematyp vl CreditCard3DSecure xs string Speichert die VerificationResponse vl VerificationResponse VERes des Merchant Plug in vl CreditCard3DSecure xs string vl PayerAuthenticationResp onse Speichert die PayerAuthenticationResponse PARes des Merchant Plug in IPG Integrationsleitfaden API Version 4 63 r First Data vl CreditCard3DSecure vl AuthenticationValue xs string Speichert die AuthenticationValue MasterCard AAV or VISA CAAV des Merchant Plug in vl CreditCard3DSecure vi XID xs string Speichert die XID des Merchant Plug in Bitte beachten Sie dass es sich hierbei um Werte handelt die Sie ggf von einem eigenen Merchant Plug in oder einer L sung eines 3D Secure Anbieters erhalten Die Verwendung der Erweiterungsfunktion Online Secure ist aus technischen Gr nden f r Transaktionen ber die API L sung nicht m glich
104. eration value MAESTRO gt lt xs enumeration value MASTERCARD gt lt xs enumeration value VISA gt lt xs enumeration value UNIONPAY gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs complexType gt lt xs complexType name CustomerCardData gt lt xs sequence gt lt xs choice gt lt xs group ref v1 Card gt lt xs element name TrackData type v1 TrackData gt lt xs choice gt lt xs sequence gt lt xs complexType gt lt xs complexType name DE DirectDebitData gt lt xs seguence gt lt xs choice minOccurs gt lt xs seguence gt lt xs element name BIC minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value A Z 4 DE A Z0 9 A NP Z0 9 XXX A WY Z 9 A Z HIPP gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name IBAN gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value DE 0 9 2 0 9 8 0 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt IPG Integrationsleitfaden API Version 4 108 SCH First Data lt xs sequence gt lt xs element name TrackData type v1 TrackData gt lt deprecated gt lt xs seguence gt lt xs element name BankCode gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 0 9 8 A Z
105. etail gt Included XML is not a valid IPG API message unsupported top level namespace tag irgendwas in the soap body Only one of http ipg online com ipgapi schemas ipgapi IPGApiActionRequest http ipg online com ipgapi schemas ipgapi IPGApiOrderRequest allowed lt detail gt M gliche Erkl rung Das erste Tag der IPG API Nachricht muss einem IPGApiActionRequest oder IPGApiOrderRequest entsprechen Im obigen Beispiel hat das Tag keinen Namensraum unsupported top level namespace tag http lt detail gt Included XML is not a valid IPG API message unsupported top level namespace tag http firstdata de ipgapi schemas ipgapi IPGApiOrderRequest in the soap body Only one of http ipg online com ipgapi schemas ipgapi IPGApiActionRequest http ipg online com ipgapi schemas ipgapi IPGApiOrderRequest allowed lt detail gt M gliche Erkl rung Das Top Level Tag entspricht keinem zugelassenen Tag In diesem Fall ist der Namensraum falsch cvc pattern valid lt detail gt cvc pattern valid Value 1 234 is not facet valid with respect to pattern 1 9 0 9 0 12 0 9 Ns 0 9 1 2 for type AnonType ChargeTotalAmount cvc type 3 1 3 The value 1 234 of element ns3 ChargeTotal is not valid lt detail gt M gliche Erkl rung Der Wert eines Tags entspricht nicht der Deklaration in der xsd Im Beispiel ist der Wert dreistellig obwohl nur zwei Stellen erlaubt sind c
106. ey CertSign Crl Sign 3 ObjectId 2 5 29 14 Criticality false SubjectKeyldentifier Keyldentifier 0000 48 E6 68 F9 2B D2 B2 95 D7 47 D8 23 20 10 4F 33 H h t G 03 0010 98 90 9F D4 4 ObjectId 1 2 840 113533 7 65 0 Criticality false 5 ObjectId 2 5 29 31 Criticality false IPG Integrationsleitfaden API Version 4 158 SCH First Data CRLDistributionPoints DistributionPoint CN CRL1 OU Equifax Secure Certificate Authority O Equifax C US 6 ObjectId 2 5 29 19 Criticality false BasicConstraints CA true PathLen 2147483647 7 ObjectId 2 5 29 35 Criticality false AuthorityKeyIdentifier KeyIdentifier 0000 48 E6 68 F9 2B D2 B2 95 D7 47 D8 23 20 10 4F 33 H h G O3 0010 98 90 9F D4 jk K K k k k K k k k k K k K K k k K k K K k k k k K K x lt k k K lt x k k k lt lt lt k k k lt x K K k k x K K x x K k lt x x K k x TH x lt K x AH lt lt x x x lt KK Aliasname verisign g2 Erstellungsdatum 26 11 2009 Eintragstyp trustedCertEntry Eigner CN VeriSign Class 3 Secure Server CA G2 OU Terms of use at https www verisign com rpa c 09 OU VeriSign Trust Network O VeriSign Inc C US Aussteller OU VeriSign Trust Network OU c 1998 VeriSign Inc For authorized use only OU Class 3 Public Primary Certification Authority G2 O VeriSign Inc C US Seriennummer 6e4ffab3c5e669c4d167c992abe858c4
107. fad angegeben werden ws101 1 ist der Name des Client Zertifikats Diesen Namen m ssen Sie durch den Namen Ihres Client Zertifikats ersetzen Dazu schauen Sie nach welcher Name f r das Client Zertifikat in der mmc Konsole angezeigt wird nachdem Sie es wie oben beschrieben installiert haben IWAM MyMachine schlie lich gibt den IIS Benutzernamen an Beachten Sie dass IIS 5 1 in der Voreinstellung 1wam MachineName verwendet Das bedeutet wenn Ihre Maschine den Namen SServerMachine tr gt lautet der IIS Benutzername IWAM IISServerMachine Bitte beachten Sie dass andere IIS Versionen eventuell einem anderen Namensschema folgen Wenn Sie den Namen Ihrer Maschine oder den IIS Benutzernamen nicht kennen schlagen Sie in der IIS Dokumentation nach oder wenden Sie sich an Ihren Administrator Nun k nnen Sie SSL in Ihrem ASP Code nutzen Der gegen ber dem im vorangehenden Kapitel begonnenen Skript hinzugekommene Code beschr nkt sich auf nur ein zus tzliches Statement Es teilt WinHTTP mit welches Client Zertifikat gesendet werden soll und wo es zu finden ist wenn es zur Kontaktaufnahme mit dem Internet Payment Gateway kommt lt language javascript gt lt html gt lt body gt lt setting the path where the client certificate to send can be found request setClientCertificate LOCAL _MACHINE My WS101 _ 1 gt lt body gt lt html gt Beachten Sie das der Code bei Verwendung von VB Script weitgehend
108. formation type al RecurringPaymentValues minOccurs 0 gt lt xs element name DataStorageItem type a1 DataStorageItem minOccurs maxOccurs unbounded gt lt xs element name ProcessorResponseCode type xs string minOccurs gt lt xs element name ProcessorRequestMessage type xs string minOccurs gt IPG Integrationsleitfaden API Version 4 100 a FirstData lt xs element name ProcessorResponseMessage type xs string minOccurs gt lt xs element name OrderValues type a1 OrderValueType minOccurs 0 maxOccurs unbounded gt lt xs element name CardRateForDCC type al InquiryRateType minOccurs maxOccurs 1 gt lt xs element name MerchantRateForDynamicPricing type al InquiryRateType minOccurs maxOccurs 1 gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs schema gt v1 xsd lt xml version 1 0 encoding UTF 8 gt lt xs schema xmlns xs http www w3 org 2001 XMLSchema xmlns vi http ipg onLine com ipgapi schemas v1 xmins cab http api clickandbuy com webservices pay 1 0 targetNamespace http ipg online com ipgapi schemas v1 elementFormDefault qualified gt lt xs import namespace http api cLickandbuy com webservices pay 1 0 0 schemaLocation schemas CLickAndBuy PayTypes 1 0 xsd gt lt l
109. g der XML Sale Transaktion packt der Online Shop diese in eine SOAP Nachricht Diese beschreibt die aufzurufende Web Service Operation und bermittelt die XML Transaktion als Parameter dieser Operation e Nach Zusammenstellen der SOAP Nachricht bereitet der Online Shop diese f r die bertragung ber das Internet vor indem der Inhalt in eine HTTPS POST Anfrage gepackt wird Au erdem legt der Shop den HTTP Header fest insbesondere seine Identifizierungsangaben diese m ssen mit den Identifizierungsangaben bereinstimmen die Sie f r die Anzeige der WSDL Datei bermittelt haben e Danach baut der Online Shop eine SSL Verbindung auf indem Client und Server Zertifikat bermittelt werden e Dann sendet der Online Shop die HTTPS Anfrage an den First Data Austria API Web Service und wartet auf eine HTTPS Antwort e First Data Austria API nimmt die HTTPS Anfrage entgegen und liest die Autorisierungsinformationen aus die der Shop in den HTTP Header eingetragen hat e Nachdem erfolgreich berpr ft wurde dass der Shop zur Nutzung von First Data Austria API berechtigt ist wird die im Body der HTTPS Anfrage enthaltene SOAP Nachricht ausgelesen und die Web Service Operation f r die Handhabung der Transaktionsverarbeitung angesto en e First Data Austria API f hrt die Transaktionsverarbeitung durch erstellt ein XML Antwortdokument packt es in eine SOAP Nachricht und sendet die SOAP Nachricht im Body einer HTTPS Antwort zur ck an den
110. g eingerichtet ist Eine Sache bleibt jedoch noch zu tun damit die Kommunikation nicht fehlschl gt IIS unter dem Ihr ASP l uft hat einen Windows Anwender der nicht ber die n tigen Rechte f r den Zugriff auf den private Schl ssel des Client Zertifikats verf gt Auch wenn der Zugriff auf den privaten Schl ssel nicht wirklich notwendig f r den Aufbau einer SSL Verbindung mit dem Internet Payment Gateway ist braucht der IIS Anwender Zugriffsrechte f r die Ausf hrung des Authentifizierungsprozesses in ASP F r die Zuweisung von Rechten an einen Anwender halt Microsoft das Tool WinHttpCertCfg exe zum kostenlosen Download bereit Sie finden es unter http www microsoft com downloads details aspx familyid c42e27ac 3409 40e9 8667 c748e422833f amp displaylang en Nach Installation des Tools ffnen Sie ein Befehlseingabefenster wechseln in das Verzeichnis in dem Sie das Tool installiert haben und geben die folgende Befehlszeile ein um dem IIS Anwender die Zugriffsrechte zuzuteilen winhttpcertcfg g c LOCAL MACHINE My s WS101 1 a IWAM MyMachine IPG Integrationsleitfaden API Version 4 91 SCH First Data LOCAL MACHINENMy gibt den Schl ssel Store an in dem die pers nlichen Zertifikate f r den lokalen Maschinen Account gespeichert sind Nach Installation des Client Zertifikats im pers nlichen Zertifikate Store wie oben beschrieben ist das Client Zertifikat unter dem genannten Pfad zu finden Es muss dann kein anderer P
111. g96max minOccurs 0 gt name City type v1 String96max minOccurs gt name State type v1 String96max minOccurs 0 gt name Zip type v1 String24max minOccurs gt name Country type v1 String32max minOccurs 0 gt lt xs complexType gt lt xs element gt lt xs element name ClientLocale gt lt xs complexType gt lt xs all gt lt xs element name Language gt lt xs simpleType gt lt xs restriction base xs string gt lt ISO 639 1 gt IPG Integrationsleitfaden API Version 4 125 SCH First Data lt xs pattern value a z 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name Country minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs string gt lt ISO 3166 gt lt xs pattern value A Z 23 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt l gt lt reference types gt KG gt lt xs element name InquiryRateld type xs Long gt lt xs complexType name InquiryRateReference gt lt xs seguence gt lt xs element ref v1 InquiryRateId minOccurs 1 ma
112. gen zu einer Bestellung Inquiry Order Get Last Orders Latest orders of a Store 6 3 2 Latest orders of a Store within a given date range 6 3 3 Alle Bestellungen eines Shops f r eine bestimmte OrderID 25 26 30 30 30 31 Dieser Befehl unterst tzt eine umfangreiche Abfrage von durchgef hrten Bestellungen eines bestimmten Shops in einem definierten Zeitraum 6 3 4 Response 6 4 6 4 1 Get Last Transactions Die letzten Transaktionen eines Shops 6 4 2 Alle Transaktionen eines Shops und einer definierten TransactionID 6 4 3 Response 6 5 6 6 6 7 Wiederkehrende Zahlungen Validierung von Kreditkartendaten Transaktionsstatus 31 31 36 37 37 38 40 42 45 Einige Payment Endpoints senden das Transaktionsergebnis nicht in Ihrer Antwort mit In diesen F llen sendet das IPG einen Best tigungscode der mit einem Fragzeichen beginnt 6 8 6 9 6 9 1 Anfrage von email notifications Warenkorbinformationen und Produktkatalog Warenkorbinformationen in Transaktionsbenachrichtigungen 6 9 2 Einen Produktkatalog aufsetzen 6 9 3 Den Lagerbestand managen 6 9 4 Sale Transaktionen und Lagerbestand 7 Erweiterungsfunktion Data Storage 7 1 Speicherung Aktualisierung von Zahlungsinformationen bei einer Transaktion 7 2 Zahlungstransaktionen mit hinterlegten Daten 7 3 Hinterlegen eines Datensatzes ohne gleichzeitige Zahlungstransaktion 7 4 Sperrung der Verwendung von gleichen Zahlungsinformationen f r mehrere Da
113. gt lt xs complexContent gt lt xs complexType gt lt xs complexType name CLickandBuyTxType gt lt xs complexContent gt lt xs extension base v1 Options gt IPG Integrationsleitfaden API Version 4 105 SCH First Data lt xs sequence gt lt xs element name Type gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value credit gt lt xs enumeration value postAuth gt lt xs enumeration value return gt lt xs enumeration value void gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name PayPaLTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs seguence gt lt xs element name Type gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value credit gt lt xs enumeration value postAuth gt lt xs enumeration value return gt lt xs enumeration value void gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name SofortTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs seguence gt IPG Integrationsleitfaden API Version 4 106 SCH First Data lt xs element name Type
114. gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt detail gt Erkl rung Wurde eine korrekte Transaktion gesendet kann ein Grund f r diese Ablehnung sein dass die Ihrer Store ID zugeordneten Terminal IDs f r das Transaktionsvolumen nicht ausreichen Bitte kontaktieren Sie Ihren Vertriebsansprechpartner um weitere Terminal IDs zur Lastverteilung zu bestellen IPG Integrationsleitfaden API Version 4 154 SCH First Data Fehleranalyse Login Fehler bei der Verwendung von cURL About to connect to test ipg online com port 443 0 Trying 217 73 32 55 connected Connected to test ipg online com 217 73 32 55 port 443 0 unable to set private key file C APl config WS120666668 _ 1 key type PEM Closing connection 0 curl 58 unable to set private key file C APl config WS120666668 _ 1 key type PEM Erkl rung Keystore und Passwort passen nicht Bitte berpr fen Sie Keystore und Passwort und ob Sie das WS lt storeld gt _ 1 pem file verwendet haben Andern Sie die Dateiendung auf cer k nnen Sie das Zertifikat mit einem Doppelklick ffnen Bitte machen Sie diese Anderung nach der berpr fung wieder r ckg ngig SSL certificate problem verify that the CA cert is OK Details error 14090086 SSL routines SSL3_GET_SERVER_CERTIFICATE ce
115. gt lt xs element name Count default 18 minOccurs gt lt xs simpleType gt lt xs restriction base xs positiveInteger gt IPG Integrationsleitfaden API Version 4 133 SCH First Data lt xs maxInclusive value 100 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name DateFrom type xs dateTime minOccurs gt lt xs element name DateTo type xs dateTime minOccurs gt lt xs element name OrderID type v1 String1 max minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name GetLastTransactions gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name count default 18 minOccurs gt lt xs simpleType gt lt xs restriction base xs positiveInteger gt lt xs maxInclusive value 100 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs group ref al TransactionID minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs group name TransactionID gt lt xs seguence gt lt xs element name OrderId type v1 Stringl max gt lt xs element name TDate gt lt xs SimpleType gt lt xs restriction base xs string gt lt xs pattern value 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt
116. gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value return gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs seguence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name Options gt lt xs seguence gt lt xs element name Storeld type v1 String20max minOccurs gt lt xs seguence gt lt xs complexType gt lt l I nn e e em gt lt Card gt l e e gt gt lt xs complexType name CreditCardData gt lt xs seguence gt lt xs choice gt lt xs seguence gt lt xs group ref v1 Card minOccurs gt lt xs element name CardCodeValue type v1 CardCodeValue minOccurs gt lt xs sequence gt lt xs element name TrackData type v1 TrackData gt lt xs choice gt lt xs element name Brand minOccurs gt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value AMEX gt lt xs enumeration value DINERS DISCOVER gt IPG Integrationsleitfaden API Version 4 107 a FirstData lt xs enumeration value JCB gt lt xs enumeration value LASER gt lt xs enum
117. gt lt xsvall gt lt xs element ref v1 MNSP gt lt MobilePhoneNumber gt lt xs element name MSISDN minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 8 9 5 15 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element ref v1 PaymentType gt lt xs all gt lt xs complexType gt lt xs element gt lt xs choice gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name CreditCardTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs seguence gt IPG Integrationsleitfaden API Version 4 103 SCH First Data lt xs element name Type gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value credit gt lt xs enumeration value forceTicket gt lt xs enumeration value postAuth gt lt xs enumeration value preAuth gt lt xs enumeration value return gt lt xs enumeration value sale gt lt xs enumeration value void gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs seguence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name CustomerCardTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs seguence gt lt xs element name Type gt lt xs simpleType gt lt xs restricti
118. gt 9754 lt ns2 ReceiptNumber gt lt ns2 TraceNumber gt 61279 lt ns2 TraceNumber gt lt ns2 TransactionValues gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt postauth lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 CreditCardData gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 Orderld gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns3 OrderId gt lt ns3 Ip gt 127 0 0 1 lt ns3 Ip gt lt ns3 TDate gt 1273570673 lt ns3 TDate gt lt ns3 TransactionOrigin gt ECI lt ns3 TransactionOrigin gt lt ns3 TransactionDetails gt lt ns3 Billing gt lt ns3 CustomerID gt customerID lt ns3 CustomerID gt lt ns3 Billing gt lt ns4 IPGApiOrderResponse gt lt ns4 ApprovalCode gt N 10501 invalid postauth attempt lt ns4 ApprovalCode gt lt ns4 Orderld gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns4 OrderId gt lt ns4 TDate gt 1273570673 lt ns4 TDate gt lt ns4 TDateFormatted gt 2010 05 11 11 37 53 MESZ lt ns4 TDateFormatted gt lt ns4 IPGApiOrderResponse gt lt ns2 TransactionState gt DECLINED lt ns2 TransactionState gt lt ns2 TransactionValues gt lt ns4 IPGApiActionResponse gt IPG Integrationsleitfaden API Version 4 29 SCH First Data 6 3 GetLast Orders Dieser Befehl stellt eine Abfrage ber die letzten Bestellungen da
119. i schemas ipgapi xmlns al http ipg online com ipgapi schemas al xmlns pay 1 0 0 ttp api clickandbuy com webservices pay 1 0 0 xmlns vl http ipg online com ipgapi schemas v1 gt lt ipgapi successfully gt true lt ipgapi successfully gt lt al TransactionValues gt lt vl Payment gt lt vl ChargeTotal gt 1 lt vl ChargeTotal gt lt vl Currency gt 978 lt vl Currency gt lt vl Payment gt lt vl TransactionDetails gt lt vl OrderId gt C 32121f4d 852f 4 48 8095 8585b917c079 lt vl OrderId gt IPG Integrationsleitfaden API Version 4 20 SCH First Data lt v1 TDate gt 1321603908 lt v1 TDate gt lt vl TransactionDetails gt lt ipgapi IPGApiOrderResponse gt lt ipgapi ApprovalCode gt Y 000000 0009459525 PPX 1173994001 lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt PPX lt ipgapi AVSResponse gt lt ipgapi OrderId gt C 32121f4d 852f 4 48 8095 8585b917c079 lt ipgapi OrderId gt lt ipgapi PaymentType gt CLICKANDBUY lt ipgapi PaymentType gt lt ipgapi ProcessorApprovalCode gt 000000 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 4001 lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorCCVResponse gt lt ipgapi ProcessorTraceNumber gt 117399 lt ipgapi ProcessorTraceNumber gt lt ipgapi TDate gt 1321603908 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2011 11 18 09 11 48 MEZ lt ipgapi TDateFormatted gt lt ipgapi TerminalID gt 54000666 l
120. ieben m ssen Sie Ihrem Web Service Tool bekannt geben dass die Kommunikation unter SSL Verschl sselung erfolgt und es darum erforderlich ist dass Sie Ihr Client Zertifikat senden und das Server Zertifikat als vertrauensw rdig annehmen Zudem m ssen Sie Ihre Identifizierungsangaben senden Wie dies geschieht ist in erster Linie von Ihrem Web Service Tool abh ngig Lesen Sie die Einzelheiten in der Dokumentation des Tools nach IPG Integrationsleitfaden API Version 4 10 SCH First Data 4 Transaktionen an das Gateway senden Dieses Kapitel soll Ihnen ein grundlegendes Verst ndnis von den Schritten vermitteln die f r die Einreichung von Transaktionen an das First Data Austria Internet Payment Gateway auszuf hren sind Es beschreibt was geschieht wenn ein Kunde mit seiner Kreditkarte bei einem Online Shop bezahlt das f r die Einreichung von Transaktionen First Data Austria API einsetzt e Der Kunde klickt im Online Shop auf die Schaltfl che Bezahlen e Der Online Shop zeigt ein Formular an das den Kunden zur Eingabe seiner Kreditkartennummer Monat und Jahr des Ablaufdatums der Karte sowie der Kartenpr fnummer auffordert e Der Kunde nimmt die Eingaben vor und sendet die Daten an den Online Shop ab d h er kauft die Waren e Der Online Shop empf ngt die Daten und erstellt ein XML Dokument f r eine Sale Transaktion das die vom Kunden gesendeten Daten sowie den vom Kunden zu zahlenden Gesamtbetrag enth lt e Nach Erstelun
121. ingabe der Daten Wenn Sie in der verf gbaren Dokumentation keine Antwort auf Ihre Fragen finden hilft Ihnen gerne unser Support Team weiter Tel 43 800 005 680 Der Anruf ist f r Sie kostenlos E Mail Technik FirstData_Austria telecash de IPG Integrationsleitfaden API Version 4 SCH First Data 1 Einf hrung Die First Data Austria API ist eine Schnittstelle f r die Anwendungsprogrammierung API Application Programming Interface Sie erm glicht Ihnen die Anbindung einer eigenen Applikation an das First Data Austria Internet Payment Gateway Auf diese Weise kann Ihre Applikation Zahlungen ohne jeglichen Anwendereingriff einreichen Bitte beachten Sie dass bei einer Speicherung oder Verarbeitung von Kreditkarten Inhaberdaten in Ihrer eigenen Applikation unbedingt die Sicherheitsstandards der Kreditkartenindustrie PCI DSS einzuhalten sind und je nach Transaktionsvolumen eine Pr fung der von Ihnen verwendeten Systemkomponenten durch einen qualifizierten Sicherheitspr fer notwendig sein kann Technisch gesehen ist First Data Austria API ein Web Service der an einem entfernten Standort die Abwicklung von Transaktionen bernimmt Diese Auslegung bietet drei wesentliche Vorteile die nachfolgend zusammenfassend dargelegt sind e Plattform Unabh ngigkeit Kommunikation mit dem First Data Austria API Web Service bedeutet dass Ihre Applikation nur in der Lage sein muss SOAP Nachrichten zu senden und zu empfangen Es gibt hierb
122. ipping xs string Stores the second line of the shipping idi gi address If provided it will appear on your transaction reports vl Shipping xs string Stores the recipient s city If provided it will vi City appear on your transaction reports vl Shipping xs string Stores the recipient s state If provided it sl Sk a will appear on your transaction reports vl Shipping xs string Stores the recipient s zip code If provided vi Zip it will appear on your transaction reports vl Shipping xs string Stores the recipient s country If provided it vl Country will appear on your transaction reports 10 1 12 TopUpTxType Path Name XML Schema Description type v1 TopUpTxType xs string Stores the Mobile Network Service vi MPCharge Provider Possible values are pi T Mobile p2 Vodafone EP E Plus v vl MNSP 02 v1 TopUpTxType xs string Stores the mobile phone number that shall v1 MPCharge be used for the top up v1 MSISDN vl TopUpTxType xs string Stores the payment type separate v1 MPCharge transaction Possible values are Amex Cash Diners ECMC MasterCard JCB vl PaymentType VISA 10 1 13 ClientLocale Path Name XML Schema Description type vl ClientLocale xs string If you are using the email transaction vl Language notification feature this language will be used for notifications to your customer Possible values are de en it vl ClientLocale xs string Specifies the variant of the language
123. isierung bermitteln Als Benutzername m ssen Sie Ihre Store ID und User ID in folgender Syntax eingeben wsstorelD userlD Beispiel Wenn Ihre Store ID 101 lautet Ihre User ID 007 und Ihr Passwort mypw m ssen Sie in das Feld User Name ws101 1 und in das Feld Password mypw eingeben Ihre Identifizierungsangaben werden vor der bermittlung an den Server verschl sselt da zu diesem Zeitpunkt bereits eine SSL Verbindung besteht Klicken Sie auf OK 15 Die First Data Austria API WSDL Datei wird angezeigt Die WSDL Datei definiert die vom Web Service angebotenen Operationen deren Eingabe und Antwortparameter und wie diese Operationen aufgerufen werden k nnen Im Falle des First Data Austria API Web Service definiert sie nur eine Operation 1PGApiorder die durch Senden einer SOAP HTTPS Anfrage an folgende URL aufrufbar ist https test ipg online com ipgapi services Diese Operation verwendet eine XML kodierte Transaktion als Input und liefert eine XML kodierte Antwort zur ck F r die Nutzung von First Data Austria API ist es nicht notwendig ist den Aufbau der WSDL Datei zu verstehen Die nachfolgenden Kapitel leiten Sie durch die Einrichtung Ihres Shops f r die Erstellung und Einreichung von Kreditkartentransaktionen Wenn Sie Tools von Fremdanbietern zur Einrichtung Ihres Shops f r den Zugriff auf First Data Austria API nutzen m ssen Sie eventuell die URL angeben unter der die WSDL Datei zu finden ist Ahnlich wie oben beschr
124. kann mit verschiedenen Konstruktoren instantiiert werden Das folgende Beispiel zeigt wie der einfachste Konstruktor verwendet wird Zur Vollst ndigkeit und Vereinfachung des Beispiels ist auch die getBytes Methode angegeben String url https test ipg online com ipgapi services String storeld your store id String password your password byte key getBytes path to your keyStore ks String keyPW your key store password IPGApiClient client new IPGApiClient url storeld password key keyPW getBytes reads a resource and returns a byte array param resource the resource to read return the resource as byte array public static byte getBytes final String resource throws IOException final InputStream input IO class getResourceAsStream resource if input null throw new IOException resource try 1 final byte bytes new bytelinput available input read bytes return bytes finally try input close catch IOException e log warn resource 16 2 Transaktionen erstellen und Antwort verarbeiten Es gibt verschiedene Klassen f r Kreditkarten und Lastschrifttransaktionen F r die Erstellung der ben tigten Klassen kann die folgende Factory Class verwendet werden de firstdata ipgapi client transaction IPGApiTransactionFactory Das folgende Beispiel zeigt eine Sale Transaktion mit Kreditkarte und einem Betrag
125. l weiterzugeben sind wie folgt lt php setting the path where cURL can find the certificate to verify the received server certificate against SserverCert cacert C certs geotrust pem setting the path where cURL can find the client certificate clientCert cert C certs WS101 _ 1 pem setting the path where cURL can find the client certificate s private key clientKey key C certs WS101 _ 1 key setting the key password SkeyPW pass ckp 1193927132 gt Bitte beachten Sie dass dieses Skript im n chsten Kapitel um die Statements erweitert wird die f r die eigentliche HTTP Anfrage notwendig sind 14 2 ASP Damit der oben beschriebene Initialisierungsprozess funktioniert erwartet ASP dass Client und Server Zertifikat in Zertifikate Stores vorliegen Mit anderen Worten m ssen erst beide Zertifikate installiert werden ehe ASP via SSL kommunizieren kann Die folgenden Schritte leiten Sie durch diesen Einrichtungsprozess Sie gehen davon aus dass ASP in Microsoft IIS 5 1 unter Windows XP l uft 1 Klicken Sie auf Start dann auf Run Geben Sie mmc ein und klicken Sie auf OK 2 Offnen Sie das Men File und w hlen Sie Add Remove Snap In 3 Klicken Sie auf Add 4 Wahlen Sie unter Snap In die Option Certificates und klicken Sie auf Add 5 Sie werden aufgefordert das Konto auszuw hlen f r dass Sie die Zertifikate verwalten wollen Da IIS den Computer Acc
126. le gt true lt a1 MoreResultsAvailable gt lt ipgapi ResultInfo gt lt ipgapi OrderValues gt lt al OrderId gt API Test b9dfe857 7df9 4b46 bd48 9879adec3289 InquiryOrderTest testBasket 385 lt a1 OrderId gt lt al OrderDate gt 2013 10 17714 37 06 000102 00 lt a1 OrderDate gt lt v1 Basket gt lt v1 Item gt lt v1 ID gt ID lt v1 ID gt lt v1 Description gt Description lt v1 Description gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Quantity gt 13 lt v1 Quantity gt lt v1 Option gt lt v1 Name gt Name 2 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Option gt lt v1 Name gt Name 1 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Item gt lt v1 Item gt lt v1 ID gt ID lt v1 ID gt lt v1 Description gt Description lt v1 Description gt IPG Integrationsleitfaden API Version 4 32 SCH First Data lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Quantity gt 13 lt v1 Quantity gt lt v1 Option gt lt v1 Name gt Name 2 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Option gt lt v1 Name gt Name 1 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Item gt lt v1 Item gt lt v1 ID gt ID 3 lt v1 ID gt lt v1 Description gt Description 3 lt v1 Description gt lt v1 ChargeTotal gt 3 lt v1 ChargeTotal gt lt v1 Quantity gt 33 lt v1 Quantity gt
127. lement gt lt xs element name Product gt lt xs complexType gt lt xs seguence gt lt xs element name ProductID type v1 String50max gt lt xs element name Description type v1 String4000max minOccurs gt lt xs element name OfferStarts type xs dateTime minOccurs gt lt xs element name OfferEnds type xs dateTime minOccurs gt lt xs group ref v1 Amount minOccurs 0 gt lt xs element name Choice type al ProductChoice minOccurs maxOccurs 99 gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs complexType name ProductChoice gt lt xs all gt lt xs element name OptionName type v1 String128max gt lt xs element name Name type v1 String128max gt lt xs all gt lt xs complexType gt lt xs element name ManageProductStock gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name Function gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value add gt lt xs enumeration value delete gt lt xs enumeration value display gt lt xs enumeration value subtract gt lt xs restriction gt lt xs simpleType gt IPG Integrationsleitfaden API Version 4 137 SCH First Data lt xs element gt lt xs element ref al ProductStock maxOccurs unbounded gt lt xs sequence gt lt xs complexTy
128. line com ipgapi schemas ipgapi schemaLocation schemas ipgapi xsd gt xs import namespace http ipg online com ipgapi schemas v1 schemaLocation schemas v1 xsd gt lt l e gt lt Request e gt lt l HT e em gt lt xs element name Action gt lt xs complexType gt lt xs sequence gt lt xs choice gt lt XS lt XS SEX S lt XS KZ lt xs lt xs lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt Xs element element element element element element element element element element element element element element choice gt ref a1 InitiateClearing gt ref a1 InquiryOrder gt ref a1 StoreHostedData gt name RecurringPayment type al RecurringPayment gt ref a1 Validate gt ref al GetExternalTransactionStatus gt ref a1 GetExternalConsumerInformation gt ref a1 SendEMailNotification gt ref al GetLastOrders gt ref al GetLastTransactions gt ref a1 ManageProducts gt ref a1 ManageProductStock gt ref al RequestCardRateForDCC gt ref a1 RequestMerchantRateForDynamicPricing gt
129. lt ipgapi ErrorMessage gt lt ipgapi OrderId gt IPGAPI REQUEST d26ea5c1 d0de 41d2 8c41 3d6755fc204c lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt 1235390830 lt ipgapi TDate gt lt ipgapi TransactionResult gt DECLINED lt ipgapi TransactionResult gt lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt detail gt Erkl rung Diese Fehlermeldung tritt beispielsweise auf wenn beim Storno einer Kreditkarten Transaktion eine abweichende Zahlart Direct Debit angegeben wurde lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1234346305732 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS 032000 Unknown processor error occured lt ipgapi ErrorMessage gt lt ipgapi OrderId gt IPGAPI REQUEST b3223ee5 156b 4d22 bc3f 910709d59202 lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt 1234346284 lt ipgapi TDate gt lt ipgapi TransactionResult gt DECLINED lt ipgapi TransactionResult gt lt ipgapi TerminalID
130. lt ns2 Option gt lt ns2 Choice gt large lt ns2 Choice gt lt ns2 Option gt lt ns3 Quantity gt 13 lt ns3 Quantity gt lt ns3 ProductStock gt lt ns3 ManageProductStock gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt 6 9 4 Sale Transaktionen und Lagerbestand Nachdem Sie den Lagerbestand eingerichtet haben k nnen Sie diesen f r die Pr fung nutzen ob der Lagerbestand f r Ihre Verk ufe ausreicht Sollte der Lagerbestand f r den anstehenden Verkauf nicht gen gen wird die Transaktion abgelehnt Um diese Funktionalit t zu nutzen f gen Sie diesen Befehl hinzu add lt ns2 ProductStock gt check lt ns2 ProductStock gt to Basket lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns2 Transaction gt lt ns2 CreditCardTxType gt lt ns2 Type gt sale lt ns2 Type gt lt ns2 CreditCardTxType gt lt ns2 CreditCardData gt lt ns2 CardNumber gt 403587XXXXXX4977 lt ns2 CardNumber gt lt ns2 ExpMonth gt 12 lt ns2 ExpMonth gt lt ns2 ExpYear gt 14 lt ns2 ExpYear gt lt ns2 CreditCardData gt lt ns2 Payment gt IPG Integrationsleitfaden API Version 4 49 SCH First Data lt ns2 ChargeTotal gt 1 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns2 Currency gt lt ns2 Payment gt lt n
131. lt ns4 Currency gt lt ns4 Payment gt lt ns4 Billing gt lt ns4 Email gt x y zz lt ns4 Email gt lt ns4 Billing gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt Anders als bei anderen Zahlarten enthalten PayPal Transaktionen keine Zahlinformationen wie Kartennummern enthalten Deshalb erfordert diese Transaktion die registrierte Mail Adresse des Zahlungsempf ngers Die Mail Adresse ist in dem Feld ns4 Billing ns4 Email einzutragen IPG Integrationsleitfaden API Version 4 24 FirstData 5 4 SOFORT berweisung 5 4 1 Return Das folgende XML Statement zeigt beispielhaft eine Return transaction lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns3 http ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 SofortTxType gt lt ns4 Type gt return lt ns4 Type gt lt ns4 SofortTxType gt lt ns4 Payment gt lt ns4 ChargeTotal gt 1 00 lt ns4 ChargeTotal gt lt ns4 Currency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4f48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt F r den Fall dass Ihr System die Zahlmethode nicht kennen sollte die f r die urspr ngliche Transaktion genutzt wurde kann jeder beliebige TxType f r eine Return Transak
132. lt ns4 ProcessorReferenceNumber gt lt ns4 lt ns4 ProcessorResponseCode gt 00 lt ns4 ProcessorResponseCode gt ProcessorResponseMessage gt Version 4 43 SCH First Data Function performed error free lt ns4 ProcessorResponseMessage gt lt ns4 ProcessorTraceNumber gt 001152 lt ns4 ProcessorTraceNumber gt lt ns4 TDate gt 1250599046 lt ns4 TDate gt lt ns4 TerminalID gt 99000003 lt ns4 TerminalID gt lt ns4 TransactionResult gt APPROVED lt ns4 TransactionResult gt lt ns4 TransactionTime gt 1250599049 lt ns4 TransactionTime gt lt ns4 IPGApiOrderResponse gt lt ns2 ResponseCode gt 00 lt ns2 ResponseCode gt lt ns2 TransactionValues gt lt ns4 IPGApiActionResponse gt Im negativen Fall enth lt das Tag successfully den Wert false und eine Fehlermeldung ErrorMessage die Auskunft dar ber gibt warum die Karte abgelehnt wurde lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns4 successfully gt false lt ns4 successfully gt lt ns2 Error Code SGS 002303 gt lt ns2 ErrorMessage gt Invalid credit card number lt ns2 ErrorMessage gt lt ns2 Error gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt preauth lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 Payment gt lt ns3 ChargeTot
133. lt ns3 ExpYear gt 12 lt ns3 ExpYear gt lt ns3 CreditCardData gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 InvoiceNumber gt invoice number lt ns3 InvoiceNumber gt lt ns3 OrderId gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns3 OrderId gt lt ns3 1p gt 127 0 0 1 lt ns3 Ip gt lt ns3 TDate gt 1273570672 lt ns3 TDate gt lt ns3 TransactionOrigin gt ECI lt ns3 TransactionOrigin gt IPG Integrationsleitfaden API Version 4 28 SCH First Data lt ns3 TransactionDetails gt lt ns3 Billing gt lt ns3 CustomerID gt customerID lt ns3 CustomerID gt lt ns3 Billing gt lt ns4 IPGApiOrderResponse gt lt ns4 ApprovalCode gt Y 356887 0000144820 PPX 0612799754 lt ns4 ApprovalCode gt lt ns4 AVSResponse gt PPX lt ns4 AVSResponse gt lt ns4 Orderld gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns4 OrderId gt lt ns4 ProcessorApprovalCode gt 356887 lt ns4 ProcessorApprovalCode gt lt ns4 ProcessorReceiptNumber gt 9754 lt ns4 ProcessorReceiptNumber gt lt ns4 ProcessorTraceNumber gt 061279 lt ns4 ProcessorTraceNumber gt lt ns4 TDate gt 1273570672 lt ns4 TDate gt lt ns4 TDateFormatted gt 2010 05 11 11 37 52 MESZ lt ns4 TDateFormatted gt lt ns4 TerminalID gt 54000668 lt ns4 TerminalID gt lt ns4 IPGApiOrderResponse gt lt ns2 ReceiptNumber
134. lt xs element ref v1 CLientLocale minOccurs gt IPG Integrationsleitfaden API Version 4 130 SCH First Data lt xs sequence gt lt xs complexType gt lt xs element gt lt l gt lt actions gt E gt lt xs element name InitiateClearing gt lt xs complexType gt lt xs seguence gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name InquiryOrder gt lt xs complexType gt lt xs all gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name OrderId type v1 String100max minOccurs gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name SendEMailNotification gt lt xs complexType gt lt xs all gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name OrderId type v1 String1 max gt lt xs element name TDate gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 0 9 10 gt lt xs restriction gt lt xs simpleType gt lt xs
135. lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 5 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionCertificateHashValue 98 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 20 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionDate 9A minOccurs gt lt xs simpleType gt IPG Integrationsleitfaden API Version 4 118 SCH First Data lt xs restriction base xs int gt lt xs pattern value 1 9 0 9 0 1 0 9 0 3 0 9 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionSequenceCounter 9F41 minOccurs gt lt xs simpleType gt lt xs restriction base xs int gt lt xs pattern value 9 4 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionStatusInformation 9B minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TransactionType 9C minOccurs gt lt xs simpleType gt lt xs restriction base xs int gt lt xs minInclusive value gt lt xs maxInclusive value 99 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs el
136. m Fehlerfall kann es drei m gliche Werte geben e DECLINE e FRAUD e FAILED DECLINE wird zur ckgeliefert wenn der Kreditkartenprozessor die Transaktion ablehnt z B weil das Konto des Kunden keine ausreichende Deckung aufweist FRAUD wird zur ckgeliefert wenn das Internet Payment Gateway einen Betrugsversuch vermutet Sollte es bei der Verarbeitung zu einem internen Fehler des Gateways kommen wird FAILED zur ck geliefert ipgapi TerminallD xs string Die bei der Transaktion verwendete Terminal ID IPG Integrationsleitfaden API Version 4 85 SCH First Data 13 HTTPS POST Anfrage erstellen Eine HTTPS POST Anfrage werden Sie nur sehr selten eigenh ndig erstellen m ssen F r die Zusammenstellung von HTTPS Anfragen gibt es eine Vielzahl von Tools und Bibliotheken die Sie bei dieser Aufgabe unterst tzen In den meisten F llen ist die daf r erforderliche Funktionalit t Bestandteil des Standardbestands von Bibliotheken der mit der technologischen Umgebung ausgeliefert wird die Sie zur Entwicklung Ihres Online Shops einsetzen Da es bei der Nutzung dieser Bibliotheken geringf gige Unterschiede gibt kann an dieser Stelle keine allgemeing ltige Vorgehensweise beschrieben werden Zur Darstellung der Grundkonzepte zeigen die folgenden Kapitel Beispiele f r die Erstellung einer g ltigen HTTPS Anfrage in PHP und ASP Im Allgemeinen m ssen Sie den folgenden
137. mas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas vl gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 OrderId gt e368a525 173f 4f56 9ae2 beb4023a6993 lt ns4 OrderId gt lt ns4 IPGApiActionResponse gt 66 Validierung von Kreditkartendaten Mit dem Action Request Validate k nnen Sie Kreditkartendaten validieren Dabei wird im Hintergrund eine Vorautorisierung auf das Kreditkartenkonto in H he von 1 EUR durchgef hrt und im Anschluss sofort wieder storniert lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1l xmlns ns3 http ipg online com ipgapi schemas al gt lt ns3 Action gt lt ns3 Validate gt lt ns3 CreditCardData gt lt ns2 CardNumber gt 403587567644977 lt ns2 CardNumber gt lt ns2 ExpMonth gt 12 lt ns2 ExpMonth gt lt ns2 ExpYear gt 12 lt ns2 ExpYear gt lt ns3 CreditCardData gt lt ns3 Validate gt lt ns3 Action gt lt ns4 IPGApiActionRequest gt In der Antwort erhalten Sie alle Informationen zu den beiden Vorg ngen Die entscheidende Information finden Sie im Tag successfully steht hier der Wert true konnten die Kartendaten erfolgreich validiert werden lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schem
138. mi e s m e l U enk gt lt Request gt KG vr m r e e A ge e ge e je w r gt lt xs element name IPGApiOrderRequest gt lt xs complexType gt lt xs choice gt lt xs element ref v1 Transaction gt lt xs choice gt lt xs complexType gt lt xs element gt lt xs element name IPGApiActionRequest gt lt xs complexType gt lt xs choice gt lt xs element ref al Action gt lt xs choice gt lt xs complexType gt lt xs element gt IPG Integrationsleitfaden API Version 4 97 a FirstData lt Response oe gt lt l e gt lt The values and sub values can be null even if it is not explicitly marked You should not consider the answer to this XSD otherwise you would get an error if we add a new field gt lt xs element name IPGApiOrderResponse gt lt xs complexType gt lt xs all gt lt xs element name ApprovalCode type xs string minOccurs gt lt xs element name AVSResponse type xs string minOccurs gt lt xs element name Brand type xs string minOccurs gt lt xs element name Country type
139. mpleType gt lt xs restriction base xs hexBinary gt lt lt xs length value 256 gt gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name KSN gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 10 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name EMVRequestData gt lt xs complexType gt lt xs all gt lt xs element name AmountAuthorised 9F 2 minOccurs gt lt xs simpleType gt lt xs restriction base xs long gt lt xs pattern value 9 1 123 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name AmountOther 9F 3 minOccurs gt IPG Integrationsleitfaden API Version 4 114 SCH First Data lt xs simpleType gt lt xs restriction base xs long gt lt xs pattern value 0 9 1 12 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationCryptogram 9F26 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 8 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationIdentifier 4F minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary g
140. mt das Server Zertifikat entgegen und gleicht es mit dem vertrauensw rdigen Server Zertifikat ab 5 Ist es g ltig ffnen beide Parteien einen gemeinsamen SSL Kanal weil sie sicher sein k nnen miteinander und mit sonst niemandem zu kommunizieren Alle zwischen den Parteien ausgetauschten Daten sind verschl sselt Gem diesem Ablauf muss Ihre Applikation zwei Dinge tun Erstens die Kommunikation durch Senden des Client Zertifikats er ffnen Zweites das empfangene Server Zertifikat verifizieren Wie dies geschieht ist von Plattform zu Plattform verschieden Um jedoch die Grundkonzepte zu erl utern werden nachfolgend die im vorangehenden Kapitel begonnenen PHP und ASP Skripts um die f r den Aufbau einer SSL Verbindung ben tigten Statements erweitert 14 1 PHP Bei der Beschreibung des Aufbaus einer sicheren HTTP Kommunikation wird in den beiden folgenden Abschnitten die Unterscheidung zwischen PHP cURL Erweiterung und Befehlszeilentool fortgef hrt Unabh ngig von der von Ihnen letztlich verwendeten Methode werden Sie mit einem speziellen Merkmal von cURL konfrontiert CURL verlangt dass das Client Zertifikat als PEM Datei bermittelt wird und der zugeh rige private Schl ssel in einer gesonderten Datei Abschlie end muss das Passwort zum privaten Schl ssel des Client Zertifikats gesendet werden Einfach gesagt enth lt die PEM Datei das Zertifikat mit allen Informationen die der Server ben tigt um den Client zu identifiziere
141. n Der private Schl ssel ist f r diese Art der Kommunikation nicht wirklich notwendig Er ist jedoch unentbehrlich damit cURL funktioniert 14 1 1 PHP cURL Erweiterung nutzen Ausgangsbasis ist das im vorangehenden Kapitel begonnene Skript Die f r den Aufbau einer SSL Verbindung mit cURL notwendigen Parameter werden in den folgenden Statements festgelegt lt php telling cURL to verify the server certificate curl setopt ch CURLOPT SSL VERIFYPEER 1 setting the path where cURL can find the certificate to verify the received server certificate against curl_setopt ch CURLOPT CAINFO C certs geotrust pem setting the path where cURL can find the client certificate IPG Integrationsleitfaden API Version 4 89 SCH First Data curl_setopt Sch CURLOPT SSLCERT C NcertsNXWS101 _ l pem setting the path where cURL can find the client certificate s private key curl_setopt Sch CURLOPT SSLKEY C certs WS101 1 key setting the key password curl_setopt Sch CURLOPT SSLKEYPASSWD ckp 1193927132 gt Bitte beachten Sie dass dieses Skript im n chsten Kapitel um die Statements erweitert wird die f r die eigentliche HTTP Anfrage notwendig sind 14 1 2 cURL Befehlszeilentool nutzen Ausgehend von dem im vorangehenden Kapitel begonnenen Skript lauten die Statements zur Initialisierung der SSL Parameter die an das cURL Befehlszeilentoo
142. n Sie dass nicht alle oben gezeigten Unterelemente innerhalb des SOAP ENV Fault Elements auftreten m ssen Welche Elemente f r welchen Fehlertyp existieren ist weiter unten beschrieben 11 2 1 SOAP ENV Server Dieser Fehlertyp weist darauf hin dass der Web Service Ihre Transaktion aufgrund eines internen Systemfehlers nicht verarbeiten konnte Bitte kontaktieren Sie in diesem Fall unser technisches Support Team lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt IPG Integrationsleitfaden API Version 4 78 SCH First Data lt SOAP ENV Header gt lt SOAP ENV Body gt lt SOAP ENV Fault gt lt faultcode gt SOAP ENV Server lt faultcode gt lt faultstring xml lang en US gt unexpected error lt faultstring gt lt SOAP ENV Fault gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Die Unterelemente der SOAP Fehlermitteilung relativ zum Element soar ENV Envelope SOAP ENV Body SOAP ENV Fault werden wie folgt gesetzt Pfad Name XML Schematyp Beschreibung Faultcode xs string Dieses Element wird immer auf SOAP ENV Server geseizt und zeigt an dass ein Gateway seitiger Fehler besteht Faultstring xs string Dieses Element enth lt immer den folgenden Fehlerstring unexpected error 11 2 2 SOAP ENV Client 11 2 2 1 MerchantException Dieser Fehlertyp tritt auf
143. n genutzt IPG Integrationsleitfaden API Version 4 68 SCH First Data 10 SOAP Anfragenachricht erstellen Nach Erstellung der Transaktion in XML muss eine SOAP Anfragenachricht erstellt werden Sie beschreibt den Aufruf der Web Service Operation die Sie durchf hren m chten Das bedeutet die XML kodierte Transaktion die Sie wie im vorangehenden Kapitel beschrieben erstellt haben entspricht dem Argument der Operation Die SOAP Anfragenachricht hingegen kodiert den eigentlichen Operationsaufruf Bitte beachten sie die korrekte UTF 8 Kodierung da ansonsten die Sonderzeichen und Umlaute nicht korrekt verarbeitet werden Die Zusammenstellung einer solchen SOAP Anfragenachricht ist recht einfach Die vollst ndige SOAP Nachricht in die eine XML Sale Transaktion wie in Kapitel 5 1 1 vorgestellt verpackt ist sieht so aus lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt sale lt vl Type gt lt vl CreditCardTxType gt lt vl CreditCardData gt lt vl CardNumber gt 4111111111111111 lt v1 CardNumber gt lt vl ExpMonth gt 12 lt vl ExpMonth gt lt vl ExpYear gt 07 lt vl ExpYear gt
144. nd die bermittelten Zahlungsinformationen liegen bereits unter einer anderen hosteddataid vor wird der Vorgang abgelehnt 7 5 Abruf hinterlegter Datens tze Mit Hilfe des Action Requests display haben Sie die M glichkeit hinterlegte Datens tze unter der Angabe der entsprechenden Hosted Data ID abzurufen lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas al gt lt ns3 Action gt lt ns3 StoreHostedData gt lt ns3 DataStorageItem gt lt ns3 Function gt display lt ns3 Function gt lt ns3 HostedDatalID gt d56feaaf 2d96 4159 8f d6 887e07 c9052 lt ns3 HostedDatalD gt lt ns3 DataStorageltem gt lt ns3 StoreHostedData gt lt ns3 Action gt lt ns4 IPGApiActionRequest gt Die Antwort beinhaltet die hinterlegten Zahlungsinformationen Von Kreditkartennummern werden dabei aus Sicherheitsgr nden nur die ersten 6 und letzten 4 Stellen ausgegeben lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 DataStorageltem gt lt ns2 CreditCardData gt lt ns3 CardNumber gt 403587XXXXXX4977 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt IPG Integrationsleitfaden API
145. ng gt lt vl Shipping gt lt vl Shipping gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt Das Element CreditCardTxType muss f r alle Kreditkarten Transaktionen angegeben werden Die anderen Elemente sind abh ngig vom Transaktionstyp Der Transaktionsinhalt ist jedoch f r jeden Transaktionstyp spezifisch XML Tags die sich auf Card Present Transaktionen mit einem Chipkartenleser und PIN Eingabe beziehen sie an dieser Stelle auf den Bereich XSD im Anhang des Dokuments verwiesen 5 1 1 Sale Verkauf Das folgende XML Dokument entspricht einer Sale Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt sale lt vl Type gt lt v1 CreditCardTxType gt lt vl CreditCardData gt lt v1 CardNumber gt 4111111111111111 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt vl ExpYear gt 07 lt vl ExpYear gt lt v1 CreditCardData gt IPG Integrationsleitfaden API Version 4 13 SCH First Data lt v1 Payment gt lt v1 ChargeTotal gt 19 00 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt v1 Transaction gt lt ipgapi IPGApiOrderReguest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel bersicht de
146. nseMessage gt lt ipgapi ErrorMessage gt SGS 005009 The currency is not allowed for this terminal lt ipgapi ErrorMessage gt lt ipgapi OrderId gt IPGAPI REQUEST a58 f6631 eb71 49c8 bbca 23fff53252fc lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt lt ipgapi TransactionResult gt FAILED lt ipgapi TransactionResult gt lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt detail gt Erkl rung In diesem Beispiel versucht der H ndler eine Transaktion in US Dollar einzureichen ist jedoch f r diese W hrung nicht registriert Sollten Sie dieses Ergebnis f r eine W hrung IPG Integrationsleitfaden API Version 4 152 SCH First Data bekommen die Sie beauftragt haben kontaktieren Sie bitte unser technsiches Support Team IPG Integrationsleitfaden API Version 4 153 SCH First Data lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1235390834046 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS 005999 There was an unknown error in the database
147. ntegrationsleitfaden API Version 4 151 SCH First Data lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1233656752933 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS 005005 Duplicate transaction lt ipgapi ErrorMessage gt lt ipgapi OrderId gt IPGAPI REQUEST 29351d8e 2634 4725 9d93 91b83704e00d lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt lt ipgapi TransactionResult gt FRAUD lt ipgapi TransactionResult gt lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiOrderResponse gt lt detail gt Erkl rung Es wurde merhrmals hintereinander versucht die gleiche Transaktion zu senden Bitte beachten Sie zur Einrichtung der Sperrdauer die Hinweise im Benutzerhandbuch Virtual Terminal lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1233656752308 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorRespo
148. on base xs string gt lt xs enumeration value forceTicket gt lt xs enumeration value BWListCheck gt lt xs enumeration value sale gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name DE DirectDebitTxType gt lt xs complexContent gt lt xs extension base v1 Options gt IPG Integrationsleitfaden API Version 4 104 SCH First Data lt xs sequence gt lt xs element name Type gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value credit gt lt xs enumeration value return gt lt xs enumeration value sale gt lt xs enumeration value void gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt deprecated gt lt xs complexType name UK DebitCardTxType gt lt xs complexContent gt lt xs extension base v1 Options gt lt xs seguence gt lt xs element name Type gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value credit gt lt xs enumeration value return gt lt xs enumeration value sale gt lt xs enumeration value void gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs extension
149. onRequest gt Die delete Funktion kann genutzt werden um den Lagerbestand eines Produktes auf Null zu setzen lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns3 Action gt lt ns3 ManageProducts gt lt ns3 Function gt delete lt ns3 Function gt lt ns3 Product gt lt ns3 ProductID gt product ID xyz lt ns3 ProductID gt lt ns3 Product gt lt ns3 ManageProducts gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt 6 9 3 Den Lagerbestand managen Nach der Einrichtung eines Poduktes k nnen Sie mit der Funktion Add Details zum Lagerbestand erg nzen lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns3 Action gt lt ns3 ManageProductStock gt lt ns3 Function gt add lt ns3 Function gt IPG Integrationsleitfaden API Version 4 48 SCH First Data lt ns3 ProductStock gt lt ns3 ProductID gt product ID xyz lt ns3 ProductID gt lt ns2 Option gt lt ns2 Name gt colour lt ns2 Option gt lt ns2 Choice gt blue lt ns2 Choice gt lt ns2 Option gt lt ns2 Option gt lt ns2 Name gt size
150. ope gt lt SOAP ENV Envelope gt Sresult curl exec ch closing cURL curl close ch gt 15 1 2 cURL Befehlszeilentool nutzen Die Ausf hrung des HTTP Aufrufs mit dem cURL Befehlszeilentool besteht einfach darin das Kommando in der Befehlszeile zu vervollst ndigen und das externe Tool auszuf hren Das Lesen der HTTP Antwort jedoch ist komplizierter da das PHP Kommando exec jede von einem externen Programm zur ckgelieferte Zeile als Element eines Arrays speichert IPG Integrationsleitfaden API Version 4 93 First Data Erst die Verkn pfung aller Elemente des Arrays ergibt die SOAP Antwort oder Fehlermeldung die im Body der HTTP Antwort zur ckgeliefert wurde Die folgenden Statements handhaben den HTTP Aufruf und schlie en das Skript ab lt php saving the whole command in one variable Scurl Spath Sdata contentType Suser serverCert SclientCert SclientKey keyPW SapiUrl preparing the array containing the lines returned by the cURL command line tool SreturnArray array performing the HTTP call by executing the cURL command line tool exec Scurl returnArray preparing a variable taking the complete result Sresult concatenating the different lines returned by the cURL command line tool this result in the variable result carrying the entire SOAP response message as string foreach returnArray
151. ount nutzt w hlen Sie Computer Account und klicken auf Next 6 W hlen Sie Local Computer und klicken Sie auf Finish 7 Klicken Sie auf Close und dann auf OK 8 Entfalten Sie den Zweig Certificates Local Computer Das Client Zertifikat wird im Ordner Personal installiert 9 Klicken Sie mit der rechten Maustaste darum auf den Ordner Certificates w hlen Sie All Tasks und klicken Sie auf Import Damit rufen Sie den Certificate Import Wizard auf IPG Integrationsleitfaden API Version 4 90 SCH First Data 10 Klicken Sie auf Next W hlen Sie die p12 Datei mit Ihrem Client Zertifikat und klicken Sie auf Next Bitte beachten Sie dass dieser Prozess genau so abl uft wie in Kapitel 3 beschrieben 11 Geben Sie das Passwort f r die Installation des Client Zertifikats ein und klicken Sie auf Next 12 W hlen Sie Place all certificates in the following store und suchen Sie den Ordner Personal sofern er noch nicht angezeigt wird Klicken Sie auf Next 13 Pr fen Sie die angezeigten Einstellungen und klicken Sie auf Finish Ihr Client Zertifikat ist damit im Zertifikate Store des lokalen Computers installiert Hier kann IIS und das darin laufende ASP bei der HTTP Kommunikation mit einem anderen Server das Client Zertifikat zur Pr fung finden 14 Als n chstes muss das Server Zertifikat im Store Trusted Root Certification Authorities installiert werden Die Zertifikate in diesem Store werden zur Verifikation genutzt wann immer
152. pe gt lt xs element gt lt xs element name ProductStock gt lt xs complexType gt lt xs seguence gt lt xs element name ProductID type v1 String50max gt lt xs element name Choice type al ProductChoice minOccurs maxOccurs 3 gt lt xs element name Quantity type xs nonNegativeInteger minOccurs 0 gt lt xs sequence gt lt xs complexType gt lt xs element gt lt l nn gt lt RecurringPayment gt KG gt lt xs complexType name RecurringPayment gt lt xs all gt lt xs element name Function type al Function gt lt xs element name OrderId type v1 String1 max minOccurs gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name Comments type v1 String1 24max minOccurs 0 gt lt xs element name InvoiceNumber type v1 String48max minOccurs gt lt xs element name DynamicMerchantName type v1 String1 max minOccurs gt lt xs element name PONumber type v1 String128max minOccurs gt lt xs element name RecurringPaymentInformation type al RecurringPaymentInformation minOccurs gt lt xs element name CreditCardData
153. pi schemas v1 gt lt ns2 Action gt lt ns2 RecurringPayment gt lt ns2 Function gt modify lt ns2 Function gt lt ns2 OrderId gt e368a525 173 4 56 9ae2 beb4023a6993 lt ns2 OrderId gt lt ns2 RecurringPaymentInformation gt lt ns2 InstallmentCount gt 999 lt ns2 InstallmentCount gt lt ns2 RecurringPaymentInformation gt lt ns2 RecurringPayment gt lt ns2 Action gt lt ns4 IPGApiActionRequest gt Hierbei m ssen nur die Angaben bergeben werden die ge ndert werden sollen Bei Anderung der Kreditkartennummer ist es dabei notwendig auch das Verfalldatum zu bergeben Bei Anderung des Betrags ist eine zus tzliche Angabe der W hrung notwendig Die L schung einer wiederkehrenden Zahlung erfolgt ebenfalls unter Angabe der Orderld lt ns4 IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns2 Action gt lt ns2 RecurringPayment gt IPG Integrationsleitfaden API Version 4 41 a FirstData lt ns2 Function gt cancel lt ns2 Function gt lt ns2 OrderId gt e368a525 173f 4f56 9ae2 beb4023a6993 lt ns2 OrderId gt lt ns2 RecurringPayment gt lt ns2 Action gt lt ns4 IPGApiActionRequest gt Die erfolgreiche Einrichtung nderung oder L schung wiederkehrender Zahlungen wird mit true best tigt lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi sche
154. r 6 3 1 Latest orders of a Store Abfrage ber die letzten n Bestellungen eines beliebigen Shops lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas vi xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns3 Action gt lt ns3 GetLastOrders gt lt ns3 Count gt 5 lt ns3 Count gt lt ns3 GetLastOrders gt lt ns3 Action gt lt ns5 IPGApiActionRequest gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt 6 3 2 Latest orders of a Store within a given date range Abfrage ber die letzten n Bestellungen eines beliebigen Shops in einem definierten Zeitraum Beide Felder DateFrom und DateTo sind in dem Befehl xs dateTime zu definieren lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ns5 IPGApiActionRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas v1 xmlns ns3 http ipg online com ipgapi schemas a1 xmlns ns4 http api cLickandbuy com webservices pay 1 0 0 gt lt ns
155. r XML Tags 5 1 2 PreAuth Vorautorisierung Das folgende XML Dokument entspricht einer PreAuth Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vi ipg online com ipgapi schemas vl xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt v1 Type gt preAuth lt v1 Type gt lt v1 CreditCardTxType gt lt vl CreditCardData gt lt v1 CardNumber gt 4111111111111111 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt vl ExpYear gt 07 lt vl ExpYear gt lt vl CreditCardData gt lt v1 Payment gt lt vl ChargeTotal gt 100 00 lt vl ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel Ubersicht der XML Tags 5 1 3 PostAuth Buchung einer Vorautorisierung Das folgende XML Dokument entspricht einer PostAuth Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt v1 Type gt postAuth lt v1 Type gt lt v1 CreditCardTxType gt lt v1 Payment gt lt vl ChargeTotal gt 59 00 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt
156. rderResponse gt lt detail gt Erkl rung Die Kombination der drei Werte VerificationResponse PayerAuthenticationResponse und PayerAuthenticationCode f r 3DSecure sind falsch Zugelassene Kombinationen sind Verification Payer Payer Response Authentication Authentication IPG 3dsecure Response Code response code Kommentar null null null n a Transaktion wird ohne 3D Secure Informationen zur Autorisierung weitergeleitet Kein MC ECI Visa ECI 7 N null null Karteninhaber nicht aktiviert 7 Kein MC ECI Visa ECI 6 N N null Karteninhaber nicht aktiviert 7 Kein MC ECI Visa ECI 6 U null null Authentifizierung nicht m glich DS nicht erreichbar 5 Kein MC ECI Visa ECI 7 Y A null Authentifizierungsversuch Keine Auskunft zum Ergebnis vom ACS 4 MC ECI 1 Visa ECI 6 Y A x Authentifizierungsversuch Keine Auskunft zum Ergebnis vom ACS 4 MC ECI 1 Visa EC 6 IPG Integrationsleitfaden API Version 4 150 SCH First Data Y U null Authentifizierung nicht m glich ACS nicht erreichbar 6 No MC ECI Visa ECI 7 Y Y null Erfolgreiche Authentifizierung kein CAAV UCAF 2 MC ECI 2 Visa ECI 5 Y Y x Erfolgreiche Authentifizierung 1 MC ECI 2 Visa ECI 5 Y N null Authentifizierung negativ Die Transaktion wird abgelehnt N 5101 3D Secure authentication failed 3 No MC or Visa ECI Andere Kombinationen werden
157. riction base xs string gt lt xs pattern value 0 9 0 4 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs choice gt lt xs sequence gt lt xs complexType gt lt xs complexType name CLickandBuyData gt lt xs seguence gt lt xs element minOccurs lt xs annotation gt lt xs documentation gt details of the payment lt xs documentation gt lt xs annotation gt lt xs element gt lt xs sequence gt lt xs complexType gt lt xs group name Card gt lt xs seguence gt lt xs element name CardNumber minOccurs gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 0 9 13 19 gt lt xs restriction gt IPG Integrationsleitfaden API Version 4 name orderDetails type cab OrderDetails gt 110 SCH First Data lt xs simpleType gt lt xs element gt lt xs element name ExpMonth gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 1 9 1 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ExpYear gt lt xs simpleType gt lt xs restriction base xs string gt lt xs pattern value 0 9 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs seguence gt lt xs group gt lt xs simpleType name CardCodeValue gt lt xs restriction base xs string gt lt xs pattern value 0 9 3 4
158. ring96max minOccurs 0 gt name Address2 type v1 String96max minOccurs 0 gt IPG Integrationsleitfaden API Version 4 124 SCH First Data lt XS lt XS lt XS lt XS lt XS lt XS lt XS element element element element element element element name City type v1 String96max minOccurs gt name State type v1 String96max minOccurs gt name Zip type v1 String24max minOccurs gt name Country type v1 String32max minOccurs gt name Phone type v1 String32max minOccurs gt name Fax type v1 String32max minOccurs gt name Email type v1 String64max minOccurs gt lt DEPRECATED this field is not evaluated and will be removed in v2 xsd lt xs element name Addrnum type v1 String96max minOccurs gt lt xs all gt lt xs complexType gt lt xs element gt lt xs element name Shipping gt lt xs complexType gt lt xs all gt lt DEPRECATED this field is not evaluated and will be removed in v2 xsd lt XS lt XS lt XS lt XS lt XS lt XS lt XS lt xs lt xs element element element element element element element element all gt name Type type v1 String2 max minOccurs gt name Name type v1 String96max minOccurs gt name Address1 type v1 String96max minOccurs 0 gt name Address2 type v1 Strin
159. rmation gt lt ns2 RecurringStartDate gt 20111231 lt ns2 RecurringStartDate gt lt ns2 InstallmentCount gt 1 lt ns2 InstallmentCount gt lt ns2 InstallmentFrequency gt 1 lt ns2 InstallmentFrequency gt lt ns2 InstallmentPeriod gt month lt ns2 InstallmentPeriod gt lt ns2 RecurringPaymentInformation gt lt ns2 CreditCardData gt lt ns3 CardNumber gt 4035875676474977 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt lt ns3 ExpYear gt 12 lt ns3 ExpYear gt lt ns3 CardCodeValue gt 977 lt ns3 CardCodeValue gt lt ns2 CreditCardData gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns2 RecurringPayment gt lt ns2 Action gt lt ns4 IPGApiActionRequest gt Wird als Startdatum RecurringStartDate das aktuelle Datum angegeben wird die erste Zahlungstransaktion sofort angesto en Die Angabe eines Datums in der Vergangenheit ist nicht erlaubt Der f r TransactionOrigin verwendete Standardwert ist ECI M chten Sie einen anderen Wert festlegen k nnen Sie diesen als TransactionOrigin im RecurringPayment Tag bergeben Eine nderung einer wiederkehrenden Zahlung kann unter Angabe der dazugeh rigen Orderld vorgenommen werden lt ns4 1IPGApiActionRequest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipga
160. rtificate verify failed Closing connection 0 curl 60 SSL certificate problem verify that the CA cert is OK Details error 14090086 SSL routines SSL3_GET_SERVER_CERTIFICATE certificate verify failed More details here http curl haxx se docs ssicerts htmi curl performs SSL certificate verification by default using a bundle of Certificate Authority CA public keys CA certs The default bundle is named curl ca bundle crt you can specify an alternate file using the cacert option If this HTTPS server uses a certificate signed by a CA represented in the bundle the certificate verification probably failed due to a problem with the certificate it might be expired or the name might not match the domain name in the URL If you d like to turn off curl s verification of the certificate use the k or insecure option Erkl rung Das Truststore Zertifikat ist falsch Bitte berpr fen Sie das Zertifikat auf den Issuer VeriSign IPG Integrationsleitfaden API Version 4 155 r First Data TO x Allgemein Details Zertifizierungspfad Zertifikatsinformationen Dieses Zertifikat ist f r folgende Zwecke beabsichtigt Garantiert die Identit t eines Remotecomputers Ausgestellt VeriSign Trust Network Ausgestellt VeriSign Trust Network G ltig ab 18 05 1998 bis 02 08 2028 Ausstellererkl rung lt html gt lt head gt lt title gt Apache Tomcat 5 5 20 Error report lt title gt lt style gt lt
161. s double Speichert den Betrag der Transaktion Die Nachkommastellen werden durch einen separiert Vergewissern Sie sich dass die Zahl der Nachkommastellen 2 nicht berschreitet z B w re 3 123 ung ltig 3 12 3 1 und 3 sind hingegen korrekt vl Payment vl Currency xs string Speichert die W hrung als dreistelligen ISO 4217 Wert z B 978 f r Euro 9 2 8 TransactionDetails Pfad Name XML Schematyp Beschreibung vl TransactionDetails vl OrderId xs string Speichert die Order ID diese muss f r die Store ID eindeutig sein Falls keine angegeben wird wird von First Data Austria ein Wert generiert und mit dem Ergebnis der Transaktion zur ck geliefert vl TransactionDetails vl Ip xs string Speichert die IP Adresse des Kunden die vom First Data Austria API Web Service zur Betrugsabwehr anhand der IP Adresse genutzt werden kann Vergewissern Sie sich dass die IP Adresse im Format XXX XXX XXX XXX bereitgestellt wird 128 0 10 2 w re beispielsweise eine g ltige IP vl TransactionDetails vl ReferenceNumber xs string Speichert die Referenznummer die bei einer ForceTicket Transaktion bergeben werden muss Der Wert dieses Elements beginnt immer mit den drei Buchstaben NEW gefolgt von der sechsstelligen Autorisierungsnummer die bei der telefonischen Autorsierung erhalten wurde vl TransactionDetails vl TDate xs string Speichert das TDa
162. s wird folgenderma en zur ckgeliefert lt ipgapi successfully gt true lt ipgapi successfully gt e lt ipgapi ResultInfo gt lt al MoreResultsAvailable gt true lt a1 MoreResultsAvailable gt Diese Antwort dr ckt aus dass mehrere Ergebisse verf gbar sind o The service is stateless therefore subsequent queries for pagination have to use either o GetLastOrders storelD count dateFrom dateTo w dateTo set to the last order s order_date of the previous resultset OR IPG Integrationsleitfaden API Version 4 31 SCH First Data o GetLastOrders storelD count orderld wi orderld set to the last order of the previous resultset e List of orders lt ipgapi OrderValues gt consisting of o Orderid the orders unique id o lt al TransactionValues gt transactions o lt v1 Basket gt the basket with basket items lt v1 Item gt and each item with item options lt v1 Option gt lt xml version 1 0 encoding UTF 8 gt lt SOAP ENV Envelope xmlns SOAP ENV http schemas xmlsoap org soap envelope gt lt SOAP ENV Header gt lt SOAP ENV Body gt lt ipgapi IPGApiActionResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi xmlns a1 http ipg online com ipgapi schemas a1 xmlns pay 1 0 O http api clLickandbuy com webservices pay 1 0 0 xmlns v1 http ipg online com ipgapi schemas v1 gt lt ipgapi successfully gt true lt ipgapi successfully gt lt ipgapi ResultInfo gt lt al MoreResultsAvailab
163. s2 TransactionDetails gt lt ns2 OrderId gt 68d4a595 fd58 4859 83cd 1ae13962a3ac lt ns2 OrderId gt lt ns2 TransactionDetails gt lt ns2 Basket gt lt ns2 ProductStock gt check lt ns2 ProductStock gt lt ns2 Item gt lt ns2 ID gt product ID xyz lt ns2 ID gt lt ns2 Description gt description of abc lt ns2 Description gt lt ns2 ChargeTotal gt 11 lt ns2 ChargeTotal gt lt ns2 Currency gt EUR lt ns2 Currency gt lt ns2 Quantity gt 5 lt ns2 Quantity gt lt ns2 Option gt lt ns2 Name gt colour lt ns2 Option gt lt ns2 Choice gt blue lt ns2 Choice gt lt ns2 Option gt lt ns2 Option gt lt ns2 Name gt size lt ns2 Option gt lt ns2 Choice gt large lt ns2 Choice gt lt ns2 Option gt lt ns2 Item gt lt ns2 Basket gt lt ns2 Transaction gt lt ns5 IPGApiOrderRequest gt IPG Integrationsleitfaden API Version 4 50 SCH First Data 7 Erweiterungsfunktion Data Storage Mit der Erweiterungsfunktion Data Storage k nnen Sie Kreditkartendaten und Bankverbindungen Ihrer Kunden bei First Data Austria in einer verschl sselten Datenbank hinterlegen um auf diese f r sp tere Zahlungen zur ckgreifen zu k nnen Wenn Sie diese Funktion beauftragt haben bietet Ihnen First Data Austria API die in den folgenden Abschnitten beschriebenen Funktionen Weitere M glichkeiten der Erweiterungsfunktion Data Storage finden Sie im Integrationsleitfaden First Data Austria Connect 7 1 Speicherung Aktualisierung von Zahl
164. s3 Name gt shipping name lt ns3 Name gt lt ns3 Addressl gt shipping addressl lt ns3 Addressl gt lt ns3 Address2 gt shipping address2 lt ns3 Address2 gt lt ns3 City gt shipping city lt ns3 City gt lt ns3 State gt shipping state lt ns3 State gt lt ns3 Zip gt shipping zip lt ns3 Zip gt lt ns3 Country gt shipping country lt ns3 Country gt lt ns3 Shipping gt lt ns2 TransactionValues gt lt ns3 CreditCardTxType gt lt ns3 Type gt sale lt ns3 Type gt lt ns3 CreditCardTxType gt lt ns3 CreditCardData gt lt ns3 CardNumber gt 5426 4979 lt ns3 CardNumber gt lt ns3 ExpMonth gt 12 lt ns3 ExpMonth gt lt ns3 ExpYear gt 12 lt ns3 ExpYear gt lt ns3 CreditCardData gt lt ns3 Payment gt lt ns3 ChargeTotal gt 1 lt ns3 ChargeTotal gt lt ns3 Currency gt 978 lt ns3 Currency gt lt ns3 Payment gt lt ns3 TransactionDetails gt lt ns3 InvoiceNumber gt invoice number lt ns3 InvoiceNumber gt lt ns3 Orderld gt a058e6e1 fec7 4e63 a092 fab4ec689716 lt ns3 OrderId gt lt ns3 Ip gt 127 0 0 1 lt ns3 Ip gt lt ns3 TDate gt 1273570668 lt ns3 TDate gt lt ns3 TransactionOrigin gt ECI lt ns3 TransactionOrigin gt lt ns3 TransactionDetails gt lt ns3 Billing gt lt ns3 CustomerID gt customerID lt ns3 CustomerID gt lt ns3 Billing gt lt ns4 IPGApiOrderResponse gt lt ns4 ApprovalCode gt Y 356887 0000144820 PPXM 0612789753 lt ns4 ApprovalCode gt lt ns4 AVSResponse gt PPX lt ns
165. scheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs string Speichert die E Mail Adresse des Kunden vl Fmail Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten Wenn Sie die eMail Benachrichtigungsfunktion benutzen wird diese eMail als Ziel eMail genutzt 9 2 10 Shipping Pfad Name XML Beschreibung Schematyp vl Shipping xs string Speichert die Art der Lieferung vl Type vl Shipping xs string Speichert den Namen des Empf ngers sl Name Wenn bereitgestellt erscheint de Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert die erste Zeile der Sender Empf ngersadresse Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert die zweite Zeile der Er Er Empf ngersadresse Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert die Stadt des Empf ngers Wenn vi City bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert das Bundesland des 1s8take Empfangers Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert die Postleitzahl des Empf ngers vi Zip Wenn bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Shipping xs string Speichert das Land des Empf ngers Wenn
166. sponse minOccurs gt lt xs element ref v1 MandateReference minOccurs gt IPG Integrationsleitfaden API Version 4 98 SCH First Data lt xs all gt lt xs complexType gt lt xs element gt lt xs element name EMVCardPresentResponse gt lt xs complexType gt lt xs all gt lt xs element ref ipgapi EMVResponseData gt lt xs element ref v1 TLVData gt lt xstall gt lt xs complexType gt lt xs element gt lt xs element name EMVResponseData gt lt xs complexType gt lt xs all gt lt xs element name IssuerAuthenticationData 91 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 8 gt lt xs maxLength value 16 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name IssuerScriptTemplate1 71 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 9 gt lt xs maxLength value 126 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name IssuerScriptTemplate2 72 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 9 gt lt xs maxLength value 126 gt lt xs restriction gt lt xs simpleType gt IPG Integrationsleitfaden API Version 4 a FirstData lt xs element gt lt xs element name IssuerAuthorizationResponseCode
167. stomer s state If provided it will appear on your transaction reports vl Billing vl Zip xs string Stores the customer s zip code If provided it will appear on your transaction reports vl Billing vl Country xs string Stores the customer s country If provided it will appear on your transaction reports vl Billing vl Phone xs string Stores the customers phone number If provided it will appear on your transaction reports vl Billing vl Fax xs string Stores the customers fax number If provided it will appear on your transaction reports vl Billing vl Email xs string Stores the customer s Email address If provided it will appear on your transaction reports If you are using the email transaction notification feature this email address will be used for notifications to your customer 10 1 11 Shipping Path Name XML Schema type Description vl Shipping vl Type xs string Stores the way of delivery vl Shipping xs string Stores the name of the recipient If provided it will appear on your transaction IPG Integrationsleitfaden API Versio n4 74 SCH First Data vl Name reports v1 Shipping xs string Stores the first line of the shipping address ren If provided it will appear on your transaction reports vl Sh
168. striction gt lt xs simpleType gt lt xs element gt lt xs element name CreationDate type a1 StringDate gt lt xs element name FailureCount type xs int minOccurs gt lt xs element name NextAttemptDate type a1 StringDate gt lt xs element name RunCount type xs int minOccurs gt lt xs element name CreditCardData type v1 CreditCardData minOccurs 0 gt lt xs element name DE DirectDebitData type v1 DE DirectDebitData minOccurs gt IPG Integrationsleitfaden API Version 4 142 SCH First Data lt xs element name HostedDataID type v1 String128max minOccurs gt lt xs element name HostedDataStoreID type v1 String2 max minOccurs 0 gt lt xs group ref v1 Amount minOccurs gt lt xs element ref v1 TransactionOrigin minOccurs gt lt xs element name InvoiceNumber type v1 String48max minOccurs gt lt xs element name PONumber type v1 String128max minOccurs gt lt xs element name Comments type v1 String1024max minOccurs gt lt xs sequence gt lt xs extension gt lt xs complexContent gt lt xs complexType gt lt xs complexType name InquiryRateType gt lt xs seguence gt lt xs element ref v1 InquiryRateld gt lt xs element name ForeignCurrencyCode type v1 CurrencyType minOccurs maxOccurs 1 gt lt xs element name ForeignAmount type v1 AmountValueType minOccurs 0 maxOccurs 1
169. t Eine detaillierte Beschreibung aller Elemente erhalten Sie in dem Kapitel bersicht der XML Tags 5 3 2 Return Das aufgef hrte XML Statement ist ein Beispiel f r eine Return Transaktion mit dem minimalen Set an Befehlen lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns3 http ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 PayPalTxType gt lt ns4 Type gt return lt ns4 Type gt lt ns4 PayPalTxType gt lt ns4 Payment gt lt ns4 ChargeTotal gt 0 4 lt ns4 ChargeTotal gt lt ns4 Currency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4 48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt In case your system is not aware of the payment method that has been used for the original transaction the Return can be performed using any TxType which supports Returns The gateway will then select the correct payment method based on the referenced Order ID IPG Integrationsleitfaden API Version 4 22 SCH First Data 5 3 3 Stornierung Das aufgef hrte XML Statement ist ein Beispiel f r eine Stornierungs Transaktion mit dem minimalen Set an Befehlen lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns
170. t lt xs minLength value 5 gt lt xs maxLength value 16 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationIdentifierTerminal 9F 6 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs minLength value 5 gt lt xs maxLength value 16 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationInterchangeProfile 82 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationPANSequenceNumber 5F34 minOccurs gt lt xs simpleType gt lt xs restriction base xs int gt IPG Integrationsleitfaden API Version 4 115 SCH First Data lt xs minInclusive value 0 gt lt xs maxInclusive value 99 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationTransactionCounter 9F36 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name ApplicationVerstonNumber 9F 9 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 2 gt lt xs restriction gt lt xs simpleType gt lt xs element
171. t ipgapi TerminalID gt lt ipgapi IPGApiOrderResponse gt lt al ReceiptNumber gt 4001 lt al ReceiptNumber gt lt al TraceNumber gt 117399 lt al TraceNumber gt lt al TransactionState gt CAPTURED lt al TransactionState gt lt al SubmissionComponent gt API lt al SubmissionComponent gt lt al TransactionValues gt lt ipgapi IPGApiActionResponse gt 53 PayPal 5 3 1 Wiederkehrende Zahlungen Nachdem eine wiederkehrende Zahlungsautorisierung for PayPal ber die Connect Schnittstelle ausgel st wurde kann f r weitere wiederkehrende Zahlungen die Web Service API Schnittstelle verwendet werden Das folgende XML Statement ist ein Beispiel f r eine PostAuth Transaktion mit dem minimalen Set an Befehlen lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns3 http ipg online com ipgapi schemas al xmlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 PayPalTxType gt lt ns4 Type gt postAuth lt ns4 Type gt lt ns4 PayPalTxType gt lt ns4 Payment gt lt ns4 ChargeTotal gt 1 lt ns4 ChargeTotal gt IPG Integrationsleitfaden API Version 4 21 SCH First Data lt ns4 Currency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 TransactionDetails gt lt ns4 OrderId gt C 32121f4d 852f 4f48 8095 8585b917c079 lt ns4 OrderId gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest g
172. t v1 Currency gt lt v1 Payment gt lt v1 TransactionDetails gt lt v1 ReferenceNumber gt 123456 lt v1 ReferenceNumber gt lt v1 TransactionDetails gt lt v1 Transaction gt lt ipgapi IPGApiOrderReguest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel bersicht der XML Tags 5 1 5 Return R ckzahlung Das folgende XML Dokument entspricht einer Return Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt return lt vl Type gt lt v1 CreditCardTxType gt lt v1 Payment gt lt v1 ChargeTotal gt 19 00 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt v1 TransactionDetails gt lt vl OrderId gt 62e3b5df 2911 4e89 8356 1e49302b1807 lt v1 Orderid gt lt v1 TransactionDetails gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt IPG Integrationsleitfaden API Version 4 15 SCH First Data Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Originaltransaktion genutzt wurde nutzen Sie Return mit einem beliebigen TxType welcher Returns unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderlD Eine Beschreibung der
173. t wird Wenn eine Identifikation auf einem MS Windows Proxy ben tigt wird muss der Parameter domain gesetzt werden Bei Systemen wie Unix muss der Parameter domain leer sein Weiterf hrende Informationen finden Sie unter den folgenden Links http hc apache org httpclient 3 x apidocs org apache commons httpclient UsernamePasswordCredentials html Username PasswordCredentials java lang String 20java lang Strin http hc apache org httpclient 3 x apidocs org apache commons httpclient NTCredentials html4NTCredentials java lang Stri ng 20java lang String 20java lang String 20java lang Strin Nachdem sie Proxy Parameter gesetzt sind muss die IPGApiClient init Methode aufgerufen werden IPG Integrationsleitfaden API Version 4 96 SCH First Data 17 Anhang ipgapi xsd lt xml version 1 encoding UTF 8 gt lt xs schema xmlns xs http www w3 org 2001 XMLSchema xmlns ipgapi http ipg online com ipgapi schemas ipgapi xmlns al http ipg online com ipgapi schemas a1 xmlns v1 http ipg online com ipgapi schemas v1 elementFormDefault qualified targetNamespace http ipg online com ipgapi schemas ipgapi gt lt xs import namespace http ipg online com ipgapi schemas v1 schemaLocation schemas v1 xsd gt lt xs import namespace http ipg online com ipgapi schemas a1 schemalocation schemas a1 xsd gt KG nn e l e e mu n e
174. t xs restriction base xs string gt lt xs enumeration value cancel gt lt xs enumeration value install gt lt xs enumeration value modify gt lt xs enumeration value perform only in test environment gt lt xs restriction gt lt xs simpleType gt lt xs complexType name RecurringPaymentInformation gt lt xs seguence gt lt xs element name RecurringStartDate type al StringDate minOccurs gt lt xs element name InstallmentCount minOccurs gt lt xs simpleType gt lt xs restriction base xs integer gt IPG Integrationsleitfaden API Version 4 139 SCH First Data lt xs maxInclusive value 999 gt lt xs minInclusive value 1 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt for future use gt lt xs element name MaximumFailures minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs integer gt lt xs maxInclusive value 5 gt lt xs minInclusive value 1 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name InstallmentFrequency minOccurs gt lt xs simpleType gt lt xs restriction base xs integer gt lt xs maxInclusive value 1000 gt lt xs minInclusive value 1 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name InstallmentPeriod minOccurs gt lt xs simpleType gt lt xs restriction base xs s
175. ta PostAuth Return und Void Transaktionen tragen Sie diese Nummer in das Element v1 orderld ein um klarzustellen auf welche Transaktion Sie sich beziehen Das Element ipgapi OrderId einer Genehmigung f r eine PostAuth Return oder Void Transaktion liefert einfach die Order ID zur ck auf die sich die Transaktion bezogen hat ipgapi ApprovalCode XS string Speichert den Genehmigungscode den der Transaktionsprozessor f r diese Transaktion generiert hat Diesen Code m ssen Sie in keiner weiteren Transaktion mehr angeben Sie sollten diese Angabe jedoch bereithalten wenn Sie Probleme mit Ihrer Transaktion feststellen und Kontakt mit dem Support aufnehmen m chten ipgapi AVSResponse xs string Enth lt die Antwort des Adressenverifikationssystems AVS ipgapi TDate xs string Speichert das TDate das Sie angeben m ssen um diese Transaktion unwirksam zu machen was nur bei Sale und PostAuth Transaktionen m glich ist In diesem Fall bertragen Sie den Wert in das Element v1 TDate der Void Transaktion die Sie erstellen m chten ipgapi TransactionResult string Speichert das Transaktionsresultat das im Falle einer Genehmigung immer APPROVED lautet ipgapi TerminallD string Die bei der Transaktion verwendete Terminal ID ipgapi PaymentType XS string Der Payment Typ der f r die Transaktion genutzt wird ipgapi
176. te der Sale PostAuth Force Ticket Return oder Credit Transaktion auf die sich diese Void Transaktion bezieht Ein TDate Wert wird innerhalb der Antwort auf eine erfolgreiche Transaktion einer dieser f nf Typen zur ckgeliefert Bei Veranlassung einer Void Transaktion m ssen Sie das TDate zus tzlich zur Order ID bersenden damit die urspr ngliche Transaktion eindeutig identifiziert werden kann vl TransactionDetails vl TransactionOrigin xs string Speichert die Art des Kartendatenerhalts M gliche Werte sind zc ber das Internet Moro per Post oder telefonisch IPG Integrationsleitfaden API Versio n4 65 SCH First Data und RETAIL Karteninhaber war pers nlich anwesend und Karte lag physisch vor vl TransactionDetails xs string Speichert die Rechnungsnummer vl InvoiceNumber vl TransactionDetails xs string Speichert die Bestellnummer v1 PONumber vl TransactionDetails xs string Speichert den H ndlername vil DynamicMerchantName vl TransactionDetails xs string Speichert die Kommentare vl Comments 9 2 9 Billing Pfad Name XML Beschreibung Schematyp vl Billing xs string Speichert Inre Kennung f r den Kunden vl CustomerID vl Billing xs string Speichert den Namen des Kunden Wenn visName bereitgestellt erscheint die Angabe sp ter in Ihren Transaktionsberichten vl Billing xs
177. tens tze 7 5 Abruf hinterlegter Datens tze 7 6 L schen hinterlegter Datens tze 7 7 Pr fen bestehender Datensatze 7 8 L schen bestehender Datensatze 8 Erweiterungsfunktion Pay amp Call 9 bersicht der XML Tags 9 1 9 2 bersicht nach Transaktionstyp Beschreibungen der XML Tags IPG Integrationsleitfaden API Version 4 45 45 45 45 46 48 49 51 51 51 52 53 53 54 54 55 56 57 57 62 SCH First Data 9 2 1 CreditCardTxType 9 2 2 CreditCardData 9 2 3 CreditCard3DSecure 9 2 4 ClickandBuyTxType 9 2 5 ClickandBuyData 9 2 6 PayPalTxType 9 2 7 Payment 9 228 TransactionDetails 9 2 9 Billing 9 2 10 Shipping 9 2 11 TopUpTxType 9 2 12 ClientLocale 10 SOAP Anfragenachricht erstellen 10 1 Beschreibung der XML Tags 10 1 1 CreditCardTxType 10 1 2 CreditCardData 10 1 3 CreditCard3DSecure 10 1 4 ClickandBuyTxType 10 1 5 ClickandBuyData 10 1 6 PayPalTxType 10 1 7 Payment 10 1 8 Oo TransactionDetails 10 1 9 InguiryRateReference 10 1 10 Billing 10 1 11 Shipping 10 1 12 TopUpTxType 10 1 13 ClientLocale 11 SOAP Antwortnachricht lesen 11 1 SOAP Antwortnachricht 11 2 SOAP Fehlernachricht 11 2 1 SOAP ENV Server 11 2 2 SOAP ENV Client 12 Transaktionsergebnis auswerten 12 1 Erfolgreiche Transaktionen 12 2 Fehlerhafte Transaktionen 13 HTTPS POST Anfrage erstellen 13 1 PHP IPG Integrationsleitfaden API Version 4 62 63 63 64 64 64 64 65 66 67 67 68 69 70 70 70 71 71 71 72 72 72 73 74 74
178. tion genutzt werden Das Gateway wird in diesem Fall die passende Zahlart basierend auf der referenzierten OrderlD ausw hlen 6 Zus tzliche Aktionen ber den Web Service 6 1 Manueller Kassenschnitt Entsprechend einer Zahlungstransaktion kann auch ein manueller Kassenschnitt ber den Web Service angesto en werden lt ipgapi IPGApiActionRequest xmlns al http ipg online com ipgapi schemas al xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt al Action gt lt al InitiateClearing gt lt al Action gt lt ipgapi IPGApiActionReguest gt IPG Integrationsleitfaden API Version 4 25 SCH First Data Der Kassenschnitt wird hiermit initiiert und innerhalb der n chsten Minuten durchgef hrt Sollte der Kassenschnitt nicht ausgef hrt werden k nnen sendet das Gateway den Hinweis false lt ipgapi IPGApiActionResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi xmlns al http ipg online com ipgapi schemas al xmlns pay 1 0 0 http api clickandbuy com webservices pay 1 0 0 xmins vl http ipg online com ipgapi schemas v1 gt lt ipgapi successfully gt false lt ipgapi successfully gt lt ipgapi IPGApiActionResponse gt 6 2 Anfragen zu einer Bestellung Inquiry Order Mit Hilfe des Action Requests nquiryOrder k nnen Sie Details zu erfolgten Transaktionen einer Bestellung abrufen Ubergeben Sie dazu die entsprechende Bestellnummer Order ID lt ns4 IPGApiActionReq
179. tion gt Description lt v1 Description gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Quantity gt 13 lt v1 Quantity gt lt v1 Option gt lt v1 Name gt Name 2 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Option gt lt v1 Name gt Name 1 lt v1 Name gt lt v1 Choice gt Choice lt v1 Choice gt lt v1 Option gt lt v1 Item gt lt v1 Item gt lt v1 ID gt ID 3 lt v1 ID gt lt v1 Description gt Description 3 lt v1 Description gt lt v1 ChargeTotal gt 3 lt v1 ChargeTotal gt lt v1 Quantity gt 33 lt v1 Quantity gt lt v1 Item gt lt v1 Basket gt lt v1 Billing gt lt v1 Shipping gt lt al TransactionValues gt lt v1 CreditCardTxType gt lt v1 Type gt sale lt v1 Type gt lt v1 CreditCardTxType gt lt v1 CreditCardData gt lt v1 CardNumber gt 403587 4977 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt v1 ExpYear gt 14 lt v1 ExpYear gt lt v1 Brand gt VISA lt v1 Brand gt lt v1 CreditCardData gt lt v1 Payment gt lt v1 ChargeTotal gt 1 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt IPG Integrationsleitfaden API Version 4 35 a FirstData lt v1 Payment gt lt v1 TransactionDetails gt lt v1 OrderId gt API Test 7c59f1cf 24e3 48ae b3fa e7daed007564 InquiryOrderTest testBasket 305 lt v1 OrderId gt lt v1 TDate gt 1382020526 lt v1 TDate gt lt v1 TransactionOrigin gt ECI lt v1 TransactionOrigin gt
180. tring gt lt xs enumeration value day gt lt xs enumeration value week gt lt xs enumeration value month gt lt xs enumeration value year gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs sequence gt lt xs complexType gt IPG Integrationsleitfaden API Version 4 140 SCH First Data lt xs element name Error gt lt xs complexType gt lt xs all gt lt xs element name ErrorMessage type xs string gt lt xs all gt lt xs attribute name Code type xs string gt lt xs complexType gt lt xs element gt lt xs complexType name ResultInfoType gt lt xs sequence gt lt xs element name MoreResultsAvailable type xs boolean gt lt xs sequence gt lt xs complexType gt lt xs complexType name OrderVaLueType gt lt xs sequence gt lt xs element name OrderId type xs string gt lt xs element name OrderDate type xs dateTime gt lt xs element ref v1 Basket minOccurs 0 gt lt xs element ref v1 Billing minOccurs gt lt xs element ref v1 MandateReference minOccurs gt lt xs element ref v1 Shipping minOccurs gt lt xs element ref a1 TransactionValues minOccurs maxOccurs unbounded gt lt further extension deferred to later versions lt xs element name RecurringPaymentInformation type al RecurringPaymentValues minOccurs gt gt lt xs s
181. tring gt lt xs maxLength value 64 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String5 max gt lt xs restriction base xs string gt lt xs maxLength value 50 gt lt xs restriction gt IPG Integrationsleitfaden API Version 4 127 SCH First Data lt xs simpleType gt lt xs simpleType name String48max gt lt xs restriction base xs string gt lt xs maxLength value 48 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String32max gt lt xs restriction base xs string gt lt xs maxLength value 32 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String3 max gt lt xs restriction base xs string gt lt xs maxLength value 30 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String24max gt lt xs restriction base xs string gt lt xs maxLength value 24 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String2 max gt lt xs restriction base xs string gt lt xs maxLength value 20 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String1 max gt lt xs restriction base xs string gt lt xs maxLength value 10 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String6max gt IPG Integrationsleitfaden API Version 4 128 SCH First Data lt xs restriction
182. tring Stores the Authentication Value vl AuthenticationValue MasterCard AAV or VISA CAAV of your Merchant Plug in vl CreditCard3DSecure yl XID xs string Stores the XID of your Merchant Plug in Bitte beachten Sie dass die im Connect integrierte 3D Secure Funktionalit t nicht f r API Transaktionen verwendet werden k nnen 10 1 4 ClickandBuyTxType Path Name XML Description Schema type vl ClickandBuyTxType xs string Stores the transaction type Possible values are postAuth return credit and void vl Type 10 1 5 ClickandBuyData Path Name XML Schematype Description vl ClickandBuyData cab OrderDetails xs complexType Stores detailed order information See http integration clickandbuy community com or the ClickandBuy xsd which is part of the IPG API wsdl PayTypes 1 0 0 xsd SOAPTypes 1 0 0 xsd IPG Integrationsleitfaden API Version 4 71 SCH First Data 10 1 6 PayPalTxType Path Name XML Description Schema type vl PayPalTxType xs string Stores the transaction type Possible values are postAuth return credit and void vl Type 10 1 7 Payment Path Name XML Schema Description type vl Payment xs string Stores the Hosted Data ID for the vl HostedDatalD Data Vault product vl Payment xs string Stores the Hosted Data ID for the vi
183. type v1 String1 max gt lt xs element name Function gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value delete gt lt xs enumeration value display gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs choice gt lt xs element name HostedDataID type v1 String128max gt lt xs element name DeclineHostedDataDuplicates type xs boolean minOccurs default false gt lt xs sequence gt lt xs complexType gt lt l gt lt Product Inventory gt lt l gt lt xs element name ManageProducts gt lt xs complexType gt lt xs sequence gt lt xs element name StoreId type v1 String2 max minOccurs gt lt xs element name Function gt lt xs simpleType gt lt xs restriction base xs string gt lt xs enumeration value delete gt lt xs enumeration value display gt lt xs enumeration value store gt lt xs restriction gt lt xs simpleType gt IPG Integrationsleitfaden API Version 4 136 SCH First Data lt xs element gt lt xs element ref a1 Product maxOccurs unbounded gt lt xs sequence gt lt xs complexType gt lt xs e
184. uest xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1 gt lt ns2 Action gt lt ns2 InquiryOrder gt lt ns2 OrderId gt b5b7fb49 3310 4212 9103 5da8bd026600 lt ns2 OrderId gt lt ns2 InquiryOrder gt lt ns2 Action gt lt ns4 IPGApiActionRequest gt Die Antwort enth lt Informationen zu allen Transaktionen die zu der Ubermittelten Order ID geh ren lt ns4 IPGApiActionResponse xmlns ns4 http ipg online com ipgapi schemas ipgapi xmlns ns2 http ipg online com ipgapi schemas al xmlns ns3 http ipg online com ipgapi schemas v1l gt lt ns4 successfully gt true lt ns4 successfully gt lt ns4 OrderId gt a058e6el fec7 4e63 a092 fab4ec689716 lt ns4 OrderId gt lt ns3 Billing gt lt ns3 CustomerID gt customerID lt ns3 CustomerID gt lt ns3 Name gt aA60UuUB lt ns3 Name gt lt ns3 Company gt company lt ns3 Company gt lt ns3 Addressl gt addressl lt ns3 Addressl gt lt ns3 Address2 gt address2 lt ns3 Address2 gt lt ns3 City gt city lt ns3 City gt lt ns3 State gt state lt ns3 State gt lt ns3 Zip gt zip lt ns3 Zip gt lt ns3 Country gt country lt ns3 Country gt lt ns3 Phone gt phone lt ns3 Phone gt lt ns3 Fax gt fax lt ns3 Fax gt IPG Integrationsleitfaden API Version 4 26 SCH First Data lt ns3 Email gt email lt ns3 Email gt lt ns3 Billing gt lt ns3 Shipping gt lt n
185. ungsinformationen bei einer Transaktion bermitteln Sie bei einer Zahlungstransaktion zus tzlich den Parameter HostedDatalD mit einer eindeutigen Kennung f r die zu hinterlegenden Zahlungsinformationen Je nach Zahlart werden unter dieser Kennung Kartennummer und Verfalldatum bzw Kontonummer und Bankleitzahl hinterlegt Ist die HostedDatalD bereits vorhanden werden die gespeicherten Informationen berschrieben lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt sale lt vl Type gt lt vl CreditCardTxType gt lt vl CreditCardData gt lt v1 CardNumber gt 4111111111111111 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt vl ExpYear gt 07 lt vl ExpYear gt lt v1 CreditCardData gt lt vl Payment gt lt v1 HostedDatalID gt HDID customer 1234567 lt v1 HostedDatalID gt lt vl ChargeTotal gt 19 00 lt vl ChargeTotal gt lt vl Currency gt 978 lt vl Currency gt lt v1 Payment gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt Die Speicherung des Datensatzes erfolgt nur im Falle einer erfolgreich autorisierten Zahlungstransaktion und wenn Ihr Shop f r die Nutzung dieser Funktion freigeschaltet wurde 7 2 Zahlungstransaktionen mit hinterlegten Daten Wurden zu einem Kunden Zahlungsinformationen hinterlegt k nnen Sie unter Angaben d
186. urrency gt lt v1 Payment gt lt v1 TransactionDetails gt lt vi1 OrderId gt A bcbb36ad 9 ad 4ff7 ad96 b5d73dd9c5e9 lt v1 OrderId gt lt v1 TDate gt 1487373218 lt v1 TDate gt lt v1 TransactionDetails gt lt ipgapi IPGApiOrderResponse gt lt ipgapi ApprovalCode gt Y 272450 0014750514 PPXM 0433836659 lt ipgapi ApprovalCode gt IPG Integrationsleitfaden API Version 4 38 SCH First Data lt ipgapi AVSResponse gt PPX lt ipgapi AVSResponse gt lt ipgapi Brand gt VISA lt ipgapi Brand gt lt ipgapi OrderId gt A bcbb36ad 90ad 4ff7 ad96 b5d73dd9c5e9 lt ipgapi OrderId gt lt ipgapi PaymentType gt CREDITCARD lt ipgapi PaymentType gt lt ipgapi ProcessorApprovalCode gt 272450 lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt 6659 lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorCCVResponse gt M lt ipgapi ProcessorCCVResponse gt lt ipgapi ProcessorTraceNumber gt 043383 lt ipgapi ProcessorTraceNumber gt lt ipgapi ReferencedTDate gt 1407373210 lt ipgapi ReferencedTDate gt lt ipgapi TDate gt 1407373210 lt ipgapi TDate gt lt ipgapi TDateFormatted gt 2014 08 07 03 00 10 CEST lt ipgapi TDateFormatted gt lt ipgapi TerminalID gt 54000667 lt ipgapi TerminalID gt lt ipgapi IPGApiOrderResponse gt lt al TransactionState gt CAPTURED lt a1 TransactionState gt lt al UserID gt 1 lt a1 UserID gt lt al SubmissionComponent gt BUS lt a1 SubmissionComponent gt
187. uy com webservices pay 1 0 0 xmlns ns3 htp ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 ClickandBuyTxType gt lt ns4 Type gt return lt ns4 Type gt lt ns4 ClickandBuyTxType gt lt ns4 Payment gt lt ns4 ChargeTotal gt 0 4 lt ns4 ChargeTotal gt lt ns4 Currency gt EUR lt ns4 Currency gt lt ns4 Payment gt lt ns4 TransactionDetails gt lt ns4 OrderId gt c 32121f4d 852f 4f48 8095 8585b917c079 IPG Integrationsleitfaden API Version 4 18 r First Data lt ns4 OrderId gt lt ns4 TransactionDetails gt lt ns4 Transaction gt lt ns5 IPGApiOrderRequest gt Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Originaltransaktion genutzt wurde nutzen Sie Return mit einem beliebigen TxType welcher Returns unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderlD 5 2 3 Void Storno Das folgende XML Dokument entspricht einem Beispiel f r eine Void Transaktion mit den minimal notwendigen Elementen lt ns5 IPGApiOrderRequest xmlns ns5 http ipg online com ipgapi schemas ipgapi xmlns ns2 http api clickandbuy com webservices pay 1 0 0 xmlns ns3 htp ipg online com ipgapi schemas al mlns ns4 http ipg online com ipgapi schemas v1 gt lt ns4 Transaction gt lt ns4 ClickandBuyTxType gt lt ns4 Type gt void lt ns4 Type gt lt ns
188. v1 Payment gt lt vl TransactionDetails gt lt vl OrderId gt 703d2723 99b6 4559 8c6d 797488e8977 lt vl1 OrderId gt lt v1 TransactionDetails gt lt v1 Transaction gt lt ipgapi IPGApiOrderReguest gt IPG Integrationsleitfaden API Version 4 14 SCH First Data Im Falle dass Ihr System nicht wei welche Paymentmethode f r die Original Vorautorisierung genutzt wurde nutzen Sie PostAuth mit einem beliebigen TxType welcher Post Autorisierungen unterst tzt Das First Data Austria Internet Payment Gateway w hlt die korrkte Paymentmethode an Hand der referenzierten OrderlD Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel bersicht der XML Tags 5 1 4 ForcedTicket Buchung telefonisch erfolgter Vorautorisierungen Das folgende XML Dokument entspricht einer ForceTicket Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt forceTicket lt vl Type gt lt v1 CreditCardTxType gt lt vl CreditCardData gt lt v1 CardNumber gt 4111111111111111 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt vl ExpYear gt 07 lt vl ExpYear gt lt v1 CreditCardData gt lt v1 Payment gt lt v1 ChargeTotal gt 59 00 lt v1 ChargeTotal gt lt v1 Currency gt 978 l
189. vc complex type 2 4 a lt detail gt IPG Integrationsleitfaden API Version 4 148 SCH First Data cvc complex type 2 4 a Invalid content was found starting with element ns2 ExpYear One of http ipg online com ipgapi schemas v1 ExpMonth is expected lt detail gt M gliche Erkl rung Die Reihenfolge der Tags entspricht nicht der Deklaration in der xsd Im Beispiel wird der Monat des Ablaufdatums anstatt des Jahres erwartet IPG Integrationsleitfaden API Version 4 149 SCH First Data Fehleranalyse Processing Exceptions lt detail gt lt ipgapi IPGApiOrderResponse xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt ipgapi CommercialServiceProvider gt lt ipgapi TransactionTime gt 1233656751183 lt ipgapi TransactionTime gt lt ipgapi ProcessorReferenceNumber gt lt ipgapi ProcessorResponseMessage gt lt ipgapi ErrorMessage gt SGS C 000003 illegal combination of values for the 3DSecure VerificationResponse PayerAuthenticationResponse PayerAuthenticationCode N Y null lt ipgapi ErrorMessage gt lt ipgapi OrderId gt lt ipgapi ApprovalCode gt lt ipgapi AVSResponse gt lt ipgapi TDate gt lt ipgapi TransactionResult gt FAILED lt ipgapi TransactionResult gt lt ipgapi TerminalID gt lt ipgapi ProcessorResponseCode gt lt ipgapi ProcessorApprovalCode gt lt ipgapi ProcessorReceiptNumber gt lt ipgapi ProcessorTraceNumber gt lt ipgapi IPGApiO
190. verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel bersicht der XML Tags 5 1 6 Credit Gutschrift Bitte beachten Sie dass f r diese Funktion eine gesonderte Beauftragung und Freischaltung notwendig ist Kontaktieren Sie hierzu bei Bedarf Ihren Ansprechpartner in unserem Vertriebsteam Das folgende XML Dokument entspricht einer Credit Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt lt vl Transaction gt lt vl CreditCardTxType gt lt vl Type gt credit lt vl Type gt lt v1 CreditCardTxType gt lt vl CreditCardData gt lt v1 CardNumber gt 4111111111111111 lt v1 CardNumber gt lt v1 ExpMonth gt 12 lt v1 ExpMonth gt lt v1 ExpYear gt 07 lt v1 ExpYear gt lt v1 CreditCardData gt lt v1 Payment gt lt vl ChargeTotal gt 50 00 lt v1 ChargeTotal gt lt v1 Currency gt 978 lt v1 Currency gt lt v1 Payment gt lt vl Transaction gt lt ipgapi IPGApiOrderRequest gt Eine Beschreibung der verwendeten Elemente sowie weiterer optionaler Elemente finden Sie im Kapitel Ubersicht der XML Tags 5 1 7 Void Storno Das folgende XML Dokument entspricht einer Void Transaktion mit dem Mindestbestand an Elementen lt ipgapi IPGApiOrderRequest xmlns vl http ipg online com ipgapi schemas v1 xmlns ipgapi http ipg online com ipgapi schemas ipgapi gt
191. xOccurs 1 gt lt xs element name DccApplied type xs boolean minOccurs maxOccurs 1 gt lt xs sequence gt lt xs complexType gt lt l nn gt lt simple types gt l ee gt lt xs simpleType name String4 max gt IPG Integrationsleitfaden API Version 4 126 SCH First Data lt xs restriction base xs string gt lt xs maxLength value 4000 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String1 24max gt lt xs restriction base xs string gt lt xs maxLength value 1024 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String128max gt lt xs restriction base xs string gt lt xs maxLength value 128 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String1 max gt lt xs restriction base xs string gt lt xs maxLength value 100 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String96max gt lt xs restriction base xs string gt lt xs maxLength value 96 gt lt xs restriction gt lt xs simpleType gt lt xs simpleType name String64max gt lt xs restriction base xs s
192. xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name PointOfServiceEntryMode 9F39 minOccurs gt lt xs simpleType gt lt xs restriction base xs int gt lt xs minInclusive value 0 gt lt xs maxInclusive value 99 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TerminalApplicationVersionNumber 9F 9 minOccurs gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 2 gt lt xs restriction gt lt xs simpleType gt lt xs element gt IPG Integrationsleitfaden API Version 4 SCH First Data lt xs element name TerminalCapabilities 9F33 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs hexBinary gt lt xs length value 3 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TerminalCountry 9F1A minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs int gt lt xs minInclusive value 0 gt lt xs maxInclusive value 999 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TerminalType 9F35 minOccurs 0 gt lt xs simpleType gt lt xs restriction base xs int gt lt xs minInclusive value 0 gt lt xs maxInclusive value 99 gt lt xs restriction gt lt xs simpleType gt lt xs element gt lt xs element name TerminalVerificationResults 95 minOccurs gt
193. zu nutzen kann die Identit t des API Web Service zu berpr fen ehe sie Daten dorthin sendet Schlie lich muss Ihre Applikation noch eine Basisautorisierung mittels Benutzername Passwort vornehmen ehe ihr die Kommunikation mit dem Web Service erlaubt wird Sie stellt die Identit t der Anwender sicher die eine Autorisierung f r die Kommunikation mit First Data Austria API besitzen Diese beiden Sicherheitsmechanismen gew hrleisten dass die an First Data Austria API gesendeten Transaktionsdaten erstens vertraulich bleiben und zweites tats chlich von Ihrer Applikation und von nirgendwo anders herstammen Dies ist nur eine kurze Zusammenfassung der von First Data Austria API gebotenen Leistungsmerkmale Der Schwerpunkt dieses Leitfades liegt bei der Integration der First Data Austria API Funktionalit t in Ihre Applikation Wie Sie diese Integration erreichen wird hier Schritt f r Schritt erkl rt IPG Integrationsleitfaden API Version 4 7 SCH First Data 2 Notwendige Elemente Die Aufrechterhaltung eines hohen Sicherheitsniveaus erfordert einige Elemente die Sie f r die sichere Kommunikation mit First Data Austria API ben tigen Da auf diese Elemente im weiteren Verlauf des Leitfadens immer wieder Bezug genommen wird soll die folgende Checkliste Ihnen einen berblick bieten Anhand dieser Liste k nnen Sie feststellen ob Sie bereits alle ben tigten Informationen erhalten haben o Store ID Die Store ID Ihres Onlineshops

IPG Integrationsleitfaden API

Contents

Download Pdf Manuals

Related Search

Related Contents