PDF Export

performPreAuthorisation

Diese Methode formuliert aus den Eingabedaten eine Autorisierungsanfrage in der XML-Struktur des Kreditkarten-Zahlungsdienstleisters und sendet diese an das Payment Gateway dieses Dienstleisters. Im Allgemeinen wird diese Form der Autorisierung verwendet, um die Kreditkartendaten beim Zahlungsdienstleister zu prüfen und zu hinterlegen, so dass für die spätere Auftragsabwicklung (authorisation + capture oder purchase) lediglich mit einer GUID gearbeitet werden kann. Preauthorisation wird nicht von allen Dienstleistern unterstützt. Falls es nicht unterstützt ist, wird Authorization benutzt. Diese Methode wird nur bei Wirecard unterstüzt.

  • Objekt: /net/dsb/commons/CardTransactionProcessing
  • Methode: performPreAuthorisation
  • Version: 1.0.0

Parameter

Name Typ / Länge Kann / Muss Beschreibung
preauthorisation-request XML M XML-Fragment zur Autorisierung ohneReservierung.

Request

<?xml version="1.0" encoding="ISO-8859-1"?> 
<message version="1.0" system="vhs/3" >
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <card-transaction>
      <preauthorisation-request>
       ..
      </preauthorisation-request>
    </card-transaction>
  </body>
</message>

Detail

Der Aufbau für Start-Transaktionen ist hier am Beispiel „authorisation-request“ dargestellt. Für die anderen Transaktions-Typen ist jeweils der Name des Request-Elements anzupassen. 

<card-transaction>
   <authorisation-request>  
     <request-id>ABCDEFGHIJK</request-id>
     <!-- Allg. steuernde Daten zur Transaktion -->
     <cc-service-provider></cc-service-provider>
     <cc-process-type></cc-process-type>
     <cc-process-mode></cc-process-mode>
     <cc-commerce-type></cc-commerce-type>
     <cc-return-request></cc-return-request>
     <cc-return-original-interaction></cc-return-original-interaction>
 
     <!-- Referenzen bei process-type = Repeating -->
     <cc-repeating-transaction>
        <cc-repeating-transaction-id></cc-repeating-transaction-id>
     </cc-repeating-transaction>
 
     <!-- Identifizierung des Händlers=Merchants  -->
     <cc-merchant-id></cc-merchant-id>
     <cc-merchant-description></cc-merchant-description>
 
     <!-- Identifizierung der Anfrage             -->
     <cc-request-source></cc-request-source>
     <cc-merchant-transaction-id></cc-merchant-transaction-id>
     <!-- Daten zu Geschäftspartner                          -->
     <!-- s. Beschreibung business-partner im Dokument       -->     
     <!-- WSI-CoreAVS3-XML-Description_de.pdf oder           -->     
     <!-- WSI-CoreVHS3-XML-Description_de.pdf                -->     
     <cc-business-partner>
          ...     
     </cc-business-partner>
 
     <!-- Daten zur Transaktion                   -->     
     <cc-transaction-amount>
         <!-- Entweder Gesamtbetrag oder Einzelpreise der Bestellpositionen -->
         <amount></<amount>
         <item>
             <item-sku></item-sku>
             <item-quantity></item-quantity>
             <item-price></item-price>
         </item>
     </cc-transaction-amount>
     <cc-transaction-currency-code></cc-transaction-currency-code>
     <cc-transaction-country-code></cc-transaction-country-code>
     <cc-transaction-usage>
         <cc-usage-string></cc-usage-string>
     </cc-transaction-usage>
     <cc-data>
         <cc-number></cc-number>
         <cc-cv2></cc-cv2> 
         <cc-number-masked></cc-number-masked>
         <cc-cardholder-name></cc-cardholder-name>
         <cc-start-year></cc-start-year>
         <cc-start-month></cc-start-month>
         <cc-expiration-year></cc-expiration-year>
         <cc-expiration-month></cc-expiration-month>
         <cc-issue-number></cc-issue-number>
         <cc-company-code></cc-company-code>
     </cc-data>
  </authorisation-request>  
</card-transaction>

Feldbeschreibung

Feld Mandatory Länge Art Beschreibung
card-transaction M - C Elementgruppe (Collection) für eine Kartentransaktion
authorisation-request
preauthorisation-request
purchase-request
refund-request 		M - C Elementgruppe (Collection) für RequestDaten (die aktuelle oder zur abgefragten Transaktion gehörige Anfrage)
request-id K 50 AN eindeutige ID für diesen Request
cc-service-provider B 4 AN ID des Kreditkartenzahlungs-Dienstleisters, an den die Transaktion gesendet werden soll.
cc-process-mode O 4 AN Gibt an, ob es sich um eine Echt- oder Testtransaktion handelt.
Gültige Werte:
live (Standard) : Echttransaktion
demo : Testtransaktion
Achtung: Dieser Wert sagt nicht aus ob der Request an das Test oder das Produktionssystem gesendet wird. Er gibt lediglich die Art der Handhabung vor. Diese Funktionalität wird nicht von allen Zahlungsdienstleistern unterstützt.
cc-process-type M 10 AN Gibt den Typ der Verarbeitung an.
Gültige Werte sind:
Single (Standard): Einzelne Transaktion, lässt keine Referenzierung in WiederholungsTransaktionen zu
Initial: Ersttransaktion, lässt Referenzierung in Wiederholungs-Transaktionen zu
Repeating (bezieht sich auf eine vorangegangene Transaktion vom Typ Initial)
cc-commerce-type O 23 AN Gibt an, auf welche Art die Auftrags- u. insb. die Kreditkartendaten eingehen.
Gültige Werte:
eCommerce : via Internet
MOTO : via Mail, Telefon
CustomerPresent : via Kreditkartenterminal (nicht relevant)
cc-return-request O - B Steuert ob im Response auch der Request zurückgeliefert werden soll. true / false (default)
cc-return-originalinteraction O - B Steuert ob im Response auch die original Request/Response-Nachrichten die mit dem Zahlungsdienstleister ausgetauscht wurden zurückgeliefert werden soll. true / false (default)
cc-repeating-transaction B - C Elementgruppe (Collection) für Angaben zu wiederkehrenden Transaktionen (repeating bzw. recurring transactions). Wenn diese Felder gefüllt sind, wird von der Verarbeitungsart „Repeating“ ausgegangen.
cc-repeating-transaction-id M 50 AN Eindeutige externe Transaktions-ID des Zahlungsdienstleisters, welche zur Wiederholung von Transaktionen von einer vorangegangen Initial-Transaktion zurückgegeben wurde.
cc-merchant-id M 32 AN Merchant-ID im System des KreditkartenZahlungsdienstleister, für welche die Transaktion getätigt werden soll
cc-merchant-description O 50 AN Bezeichnung des Merchants
cc-request-source M 32 AN Angaben zur Herkunft des Requests – z.B. aufrufendes System, Systemumgebung, Mandant, Batch oder Online-Betrieb, Test- oder Produktivumgebung, User, Datum, Zeit…
cc-merchant-transaction-id M 32 AN Eindeutige ID für die Transaktion im System des Händlers.
cc-business-partner B - XML XML-Fragment business-partner. Hier werden die Angaben zum Geschäftspartner erwartet. Für weitere Info siehe die WSI-Core Dokumenationen von AVS/3 und VHS/3. Nur bei Verarbeitungsart „Initial“ und „Single“ notwendig.
cc-transaction-amount B Angabe über den zur verarbeitenden Betrag entweder als Summe (amount) oder als Liste von Positionen (item).
Nicht zu verwenden bei Preauthorization. Ein Defaultbetrag wird hingesendet.
amount B 16 N Ganzzahliger Wert, in der kleinsten Einheit der in der Anfrage angegebenen Währung (z.B. EUR 10,00 ⇒ 1000).
list→item-sku B 13 AN Vertriebsartikel-Nr.
list→item-quantity B 5 N Menge dieser Position
list→item-price B 16 N Preis einer Einheit als ganzzahliger Wert, in der kleinsten Einheit der in der Anfrage angegebenen Währung (z.B. EUR 10,00 ⇒ 1000).
cc-transaction-currencycode M 3 AN Transaktionswährung nach ISO 4217.
cc-transaction-countrycode M 2 AN Ländercode nach ISO 3166-1 für das Land, in dem die Transaktion stattfindet. Dieses Element ist bei allen 'Single' oder 'Initial' – Transaktionen zu liefern.
cc-transaction-usage M - C Angaben für den Verwendungszweck, der auf der Kreditkartenabrechnung des Geschäftspartners für die Transaktion erscheinen soll.
cc-usage-string O 256 AN Vom aufrufenden System übergebener Verwendungszweck-String. Dies wird nicht von allen Acquirern unterstützt, auch die Länge, in welcher die Informationen übermittelt werden, ist vom Acquirer abhängig.
cc-data B - C Elementgruppe (Collection) für eine Kreditkartentransaktion. Nur bei Verarbeitungsart „Initial“ und „Single“ notwendig.
cc-number M 256 A Kreditkartennummer
cc-number-masked M 20 A Maskierte Kreditkartennummer, unverschlüsselt, zB 444433**1111 - dient zur Kommunikation mit Kunden bei Zahlungsproblemen
cc-cv2 B 4 N 3- oder 4-stellige Kreditkartenprüfnummer auf der Rückseite der Kreditkarte hinter der eigentl. Kreditkartennummer (4-stellig für American Express-Karten, sonst 3-stellig). Muss-Feld, falls es sich nicht um eine 'Recurring Transaction' vom Typ 'Repeating' handelt, d.h. eine vorangegangene erfolgreich autorisierte Transaktion referenziert wird.
Nicht zu verwenden bei Refund.
cc-cardholder-name M 50 AN Name des Karteninhabers
cc-start-year O 4 N Jahr, seit dem die Karte gültig ist im Format YYYY (nur bestimmte Kartentypen).
cc-start-month O 2 N Monat, seit dem die Karte gültig ist im Format MM (nur bestimmte Kartentypen)
cc-expiration-year M 4 N Jahr des Ablaufdatums der Karte im Format YYYY
cc-expiration-month M 2 N Monat des Ablaufdatums der Karte im Format MM
cc-issue-number O 2 N Kreditkarten-Ausgabenummer (nur bestimmte Kartentypen)
cc-company-code M 4 AN Kreditkarteninstitut

Response

<?xml version="1.0" encoding="ISO-8859-1"?> 
<message version="1.0" system="vhs/3">
   <header>
      <client>4711</client>
      <service-provider>999</service-provider>
   </header>
   <body>
      <card-transaction>
         <preauthorisation-request>  
         </preauthorisation-request>
         <cc-original-request></cc-original-request>
         <cc-original-response></cc-original-response>
      </card-transaction>
   </body>
</message>

Feldbeschreibung

Feld Art Beschreibung Cybersource Wirecard Global Collect
response XML
cc-merchant-id C Merchant ID (die gleiche wie im Request Element)
cc-payment-operation C
cc-service-provider C Zahlungsdienstleister (der gleiche wie im Request Element)
cc-result-status C OK / NOTOK X X X
cc-result-code C Ergebniscode X X X
cc-result-message C Text zum Ergebniscode X X X
cc-result-advice C nähere Details zur Response - X -
cc-result-timestamp C Zeitpunkt des Requests - - -
cc-result-amount C Betrag des Requests
cc-result-currency C Währung des Requests
cc-dsb-transaction-id C eindeutige ID der Transaktion in WSI
cc-external-transaction-id C ID der Transaktion beim Dienstleister X X X
cc-external-transaction-token C nähere Details zur Identifikation des Requests beim Dienstleister X - X
cc-reconciliation-transaction-id C ID für Reconciliation X - - (merchant-refernce-id)
cc-repeating-transaction-id C ID für wiederkehrende Zahlungen X - -
cc-authorisation-code C Ergebnis der Autorisierung X X -
cc-authorisation-timestamp C Zeitpunkt der Autorisierung (nur bei Authorize Request)
cc-data C
Cookies helfen bei der Bereitstellung von Inhalten. Durch die Nutzung dieser Seiten erklären Sie sich damit einverstanden, dass Cookies auf Ihrem Rechner gespeichert werden. Weitere Information