getCardTransactionByDsbId [ccb by dsb®

Die Methode liefert alle Daten zu einer Transaktions-UUID zurück.

Objekt: /net/dsb/commons/CardTransactionProcessing
Methode: getCardTransactionByDsbId
Version: 1.0.0

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
cc-dsb-transaction-id	AN / 36	M	DSB Transaktions-UUID einer bereits durchgeführten reditkartentransaktion.

Request Struktur

Aufbau

<?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>
      <cc-dsb-transaction-id>4AF41CAC-B5B4-B77B-3B76-183E70E2F2E7</cc-dsb-transaction-id>
   </body>
</message>

Response Struktur

Aufbau

<?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>  
        <!-- Ursprünglicher Request, der zu dieser Response geführt hat, -->   
        <!-- wenn dies bei der Anfrage angefordert wurde                 -->   
        <!-- (siehe Feld: cc-return-request)                             -->   
        <!-- Aufbau ...-Request: siehe jeweiliger Abschnitt              -->   
        <...-request>   
        </...-request>  
 
        <!-- Response zum o. a. Request -->   
        <response>
            <cc-merchant-id></cc-merchant-id>
            <cc-payment-operation></cc-payment-operation>
            <cc-service-provider></cc-service-provider>
            <!-- Ergebnis des Requests -->
            <cc-result-status></cc-result-status>
            <cc-result-code></cc-result-code>
            <cc-result-message></cc-result-message>
            <cc-result-advice></cc-result-advice>
            <cc-result-timestamp></cc-result-timestamp>
            <cc-result-amount></cc-result-amount>
            <cc-result-currency></cc-result-currency>
 
            <!-- Referenz IDs -->
            <cc-dsb-transaction-id></cc-dsb-transaction-id>
            <cc-external-transaction-id></cc-external-transaction-id>
            <cc-external-transaction-token></cc-external-transaction-token>
            <cc-reconciliation-transaction-id></ cc-reconciliation-transaction-id>
 
            <!-- Wiederkehrende Transaktionen -->
            <cc-repeating-transaction-id></cc-repeating-transaction-id>
 
            <!-- Autorisierungs Code -->
            <cc-authorisation-code></cc-authorisation-code>
            <cc-authorisation-timestamp></cc-authorisation-timestamp>
 
            <cc-data>
                <cc-number></cc-number>
                <cc-cardholder-name></cc-cardholder-name>
                <cc-expiration-year></cc-expiration-year>
                <cc-expiration-month></cc-expiration-month>
                <cc-company-code></cc-company-code>
            </cc-data>  
 
            <dsb-extensions>...</dsb-extensions>  
        </response>   
 
        <!-- Request an den Zahlungsdienstleisters (nur bei Retrieval-Methoden) -->   
        <cc-original-request></cc-original-request>  
        <!-- Response des Zahlungsdienstleisters (nur bei Retrieval-Methoden) -->   
        <cc-original-response></cc-original-response>  
      </card-transaction> 
   </body>
</message>

Elementdefinition

Feld	Mandatory	Länge	Art	Beschreibung
card-transaction	M	-	XML	Elementgruppe (Collection) für eine Kartentransaktion
…-request	M	-	XML	Elementgruppe (Collection) für RequestDaten (die aktuelle oder zur abgefragten Transaktion gehörige Anfrage) – Beschreibung s. jeweiliger Abschnitt
response	M	-	XML	Elementgruppe (Collection) für RequestDaten (die aktuelle oder zur abgefragten Transaktion gehörige Antwort)
cc-merchant-id	M	4	AN	Die merchant-id des Nutzers.
cc-payment-operation	O	-	AN	Die Methode die aufgerufen wurde.
cc-service-provider	M	4	AN	DSB ID des KreditkartenzahlungsDienstleisters, an den die Transaktion gesendet werden soll. Muss, wenn nicht ccdsb-transaction-id angegeben ist.
cc-result-status	M	10	AN	Dieses Element zeigt das Ergebnis der ausgeführten Transaktion. Gültige Werte: OK Transaktion fachlich ok und verarbeitet NOT OK Transaktion fachlich fehlerhaft, nicht verarbeitet
cc-result-code	M	10	AN	Returncode des dsb-Webservices (ggf. Mappen von Systemfehlern/techn.Fehlern des Dienstleisters)
cc-result-message	O	1024	AN	Fehlermeldung bzw. Infomeldung
cc-result-advice	O	1024	AN	Empfehlung zur Behebung/Vermeidung d. Fehlers
cc-result-timestamp	M	19	DT	Zeitstempel des techn. Ergebnisses im Format YYYY-MM-DDTHH:MM:SS
cc-result-amount	M	16	N	Betrag welcher in der Transaktion verwendet wurde.
cc-result-currency	M	3	AN	Transaktionswährung nach ISO 4217.
cc-dsb-transaction-id	M	36	AN	DSB Transaktions-UUID. Diese ID MUSS bei Online-Autorisierungen mit in die Aufträge (z. B. Versandhandelsaufträge oder Abonnements) gepackt werden, damit die Fakturen die Ergebnisse berücksichtigen können.
cc-external-transaction-id	M	-	AN	Eindeutige ID der Transaktion im System des Kreditkarten-Zahlungsdienstleisters.
cc-external-transaction-token	B	-	AN	Externes Token der Transaktion im System des Kreditkarten-Zahlungsdienstleisters. Diese Feld muss bei Folgetransaktionen im Request bestückt wieder mitgeliefert werden, wenn es im Response einer StartTransaktion gefüllt war. Derzeitige Verwendung: Wirecard: nein Cybersource: ja GlobalCollect: ja
cc-reconciliation-transaction-id	B	-	AN	Wird zurückgeliefert wenn Capture, Refund, Book ausgeführt wird.
cc-repeating-transaction-id	B	-	AN	Eindeutige ID der Transaktion im System des Kreditkarten-Zahlungsdienstleisters zur Ausführung wiederkehrender Zahlungsvorgänge per Kreditkarte ohne Übertragung von Kartendetails (siehe auch PCI)
cc-authorisation-code	B	-	AN	Autorisierungscode: Numerischer oder alphanumerischer Code, der vom Kartenausgeber gesandt wird und nachweist, dass die Transaktion autorisiert wurde. Im Fehlerfall enthält dieses Element keinen Wert.
cc-authorisation-timestamp	C	-	AN	Zeitstempel desAutorisierungs Ergebnisses im Format YYYY-MM-DDTHH:MM:SS
cc-data	B	-	C	Elementgruppe (Collection) für eine Kreditkartentransaktion. Nur bei Verarbeitungsart „Initial“ und „Single“ notwendig.
cc-number	M	256	A	Maskierte Kreditkartennummer, unverschlüsselt, zB 444433**1111 - dient zur Kommunikation mit Kunden bei Zahlungsproblemen
cc-number-masked	M	20	A	cc-cardholder-name M 50 AN Name des Karteninhabers
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-company-code	M	4	AN	Kreditkarteninstitut (AMEX,VISA,MC,DC )
cc-original-request	B	n. a.	XML	#CDATA-Element, welches denn original Request, der an den Zahlungsdienstleister gesendet wurde enthält. Diese Feld ist für interne Prüfzwecke bestimmt und wird nur bei Retrieval-Methoden zurückgeliefert
cc-original-response	B	n. a.	XML	#CDATA-Element, welches denn original Response, der vom Zahlungdienstleister zurückgesendet wurde, enthält. Diese Feld ist für interne Prüfzwecke bestimmt und wird nur bei Retrieval-Methoden zurückgeliefert.
dsb-extensions	B	n. a.	AN	Siehe dsb-extensions