PDF Export

performBookback

Die Methode führt zu einer Rückbuchung eines Geldbetrags, der mit einer Vorgängertransaktion (Capture oder Purchase) eingezogen wurde

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

Parameter

Name Typ / Länge Kann / Muss Beschreibung
bookback-request XML M XML-Fragement zur Ausführung einer Rückbuchung.

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>
      <bookback-request>
        <cc-service-provider>ABCD</cc-service-provider>
        <cc-external-transaction-id>ABC000123456789</cc-external-transaction-id>
      </bookback-request>
    </card-transaction>
  </body>
</message>

Detail

Der Aufbau für Folge-Transaktionen ist hier am Beispiel „capture-request“ dargestellt. Für die anderen Transaktionstypen ist jeweils der Name des Request-Elements anzupassen. 

<card-transaction>
   <capture-request>  
     <request-id>ABCDEFGHIJK</request-id>
     <!-- Allg. steuernde Daten zur Transaktion -->
     <cc-service-provider></cc-service-provider>
     <cc-external-transaction-id></cc-external-transaction-id>
     <cc-external-transaction-token></cc-external-transaction-token> 
 
     <cc-process-mode></cc-process-mode>
     <cc-return-request></cc-return-request>
     <cc-return-original-interaction></cc-return-original-interaction>
 
     <!-- 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 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>
  </capture-request>  
</card-transaction>

Feldbeschreibung

Feld Mandatory Länge Art Beschreibung Cybersource Wirecard Global Collect
card-transaction M - C Elementgruppe (Collection) für eine Kartentransaktion
capture-request
cancel-request
bookback-request 		M - C Elementgruppe (Collection) für RequestDaten (die aktuelle oder zur abgefragten Transaktion gehörige Anfrage)
request-id K 50 AN eindeutige ID dieses Requests.
cc-service-provider M 4 AN ID des Kreditkartenzahlungs-Dienstleisters.
cc-external-transaction-id M AN Externe ID der Transaktion (eindeutig im System des Kreditkartenzahlungsdienstleisters), auf die sich der Request bezieht. X X X
cc-external-transactiontoken B AN Externes Token der Transaktion (eindeutig im System des KreditkartenZahlungsdienstleisters). Dieses Feld muss bestückt werden, wenn es im Response einer Start-Transaktion gefüllt war. X - X
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. 		- X -
cc-return-request O - B Steuert ob im Response auch der Request zurückgeliefert werden soll. true / false (default) X X X
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) X X X
cc-merchant-id M 32 AN Merchant-ID im System des KreditkartenZahlungsdienstleister, für welche die Transaktion getätigt werden soll X X X
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… - X
cc-merchant-transaction-id M 32 AN Eindeutige ID für die Transaktion im System des Händlers. X X X
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. Dort wird ein Defaultbetrag genutzt. 		X X X
amount B 16 N Ganzzahliger Wert, in der kleinsten Einheit der in der Anfrage angegebenen Währung (z.B. EUR 10,00 ⇒ 1000). X X X
list→item-sku B 13 AN Vertriebsartikel-Nr. X - -
list→item-quantity B 5 N Menge dieser Position X - -
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). X - -
cc-transaction-currency-code M 3 AN Transaktionswährung nach ISO 4217. X X X
cc-transaction-country-code M 2 AN Ländercode nach ISO 3166-1 für das Land, in dem die Transaktion stattfindet. - X -
cc-transaction-usage M - C Angaben für den Verwendungszweck, der auf der Kreditkartenabrechnung des Geschäftspartners für die Transaktion erscheinen soll. - X -
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. - X -

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>
         <bookback-request>  
         </bookback-request>
         <response>  
         </response>
         <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