getCardTransactionByDsbId [ccb by dsb®

This method retrieves all data associated with a DSB Transaction UUID which was returned from a previous request and response interaction.

Object: /net/dsb/commons/CardTransactionProcessing
Method: getCardTransactionByDsbId
Version: 1.0.0

Parameter

Name	Type / max. length	mandatory?	Description
cc-dsb-transaction-id	AN / 36	M	DSB Transaction ID (a UUID) from a previously executed transaction.

Response Element

XML-Fragment ‚subscription‘

Example Request

Structure

<?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 Structure

Structure <card-transaction> response

<card-transaction>
	<!-- The original request that led to this response. This is -->
	<!-- returned only when cc-return-request is set to ”true” -->
	<...-request>
	</...-request>
	<!-- Response to the request -->
	<response>
		<cc-merchant-id></cc-merchant-id>
		<cc-payment-operation></cc-payment-operation>
		<cc-service-provider></cc-service-provider>
		<!-- Result of the request 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>
 
		<!-- Reference 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>
		<!-- Repeating transactions -->
		<cc-repeating-transaction-id></cc-repeating-transaction-id>
		<!-- Authorisation payment 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>
	<!-- Original request sent to the payment gateway -->
	<cc-original-request></cc-original-request>
	<!-- Original response received from the payment gateway -->
	<cc-original-response></cc-original-response>
</card-transaction>

Element Definitions

Field	M = Mandatory O =Optional C = Conditional	Length	Type	Description
card-transaction	M	-	C	Element group for a card transaction
…-request	C	-	C	The request that was sent to DSB is echoed back if cc-return-request was set to true.
response	M	-	C	The response to the request sent.
cc-merchant-id	M	4	AN	The merchant-id where the request was sent.
cc-payment-operation	M	4	AN	The payment operation made. Possible values: AUTHORIZE PREAUTHORIZE PURCHASE REFUND CAPTURE BOOKBACK CANCEL
cc-service-provider	M	4	AN	The ID of the Payment Gateway where the request should be sent
cc-result-status	M	10	AN	This element shows the result code of the transaction. Possible values are: OK Transaction was functionally ok and has been processed NOTOK Transaction had a problem and was not processed.
cc-result-code	M	10	AN	The return code of the DSB Web-Services.
cc-result-message	O	1024	AN	Failure message or info message.
cc-result-advice	O	1024	AN	Advice on what the problem is to correct the failure.
cc-result-timestamp	M	19	DT	Timestamp of the result in the format of YYYY-MM-DDTHH:MI:SS
cc-result-amount	M	16	N	The amount that was processed in the request
cc-result-currency	M	3	AN	The currency that the amount is represents.

cc-dsb-transaction-id	M	36	AN	This element must used by the sender and included within a subscription order or a mail-order order so that it can be accounted for within the invoice.
cc-external-transaction-id	M	n. a.	AN	Unique id within the system that identifies the processed transaction.
cc-external-transaction-token	C	n. a.	AN	An external token sent by the payment gateway. It is a payment gateway specific value that identifies the sent transaction so that follow on transaction (e.g. capture) can be made upon it. Required by: Cybersource GlobalCollect
cc-reconciliation-transaction-id	C	n.a	AN	Is returned when a Capture, Refund or Bookback is executed

cc-repeating-transaction-id	C	n. a.	AN	A unique id that reference credit card details that were sent in the request (which had the transaction type of ‘Initial’). This ID can then be used in place of the credit card details so they only need to be sent once.
cc-authorisation-code	C	n. a.	AN	An authorisation code: A numeric or alphanumeric code that is sent to prove that the transaction was authorised. When a failure occurs this tag has no value.
cc-authorisation-timestamp	C	n.a	AN	The time that authorisation was said to have occurred at the payment provider.
cc-data	C		XML	The credit card details
cc-number				The return masked credit card number.
cc-cardholder-name				The credit card holder
cc-expiration-year				The expiry year of the card
cc-expiration-month				The expiry month of the card
cc-company-code				The company code of the card. E.g. VISA, AMEX
cc-original-request	C	n. a.	XML	A #CDATA element which contains the original request that was sent to the payment gateway. Only to be used for internal testing and returned by retrieval methods.
cc-original-response	C	n. a.	XML	A #CDATA element which contains the original response that was retrieved from the payment gateway. Only to be used for internal testing and returned by retrieval methods.
dsb-extensions	C	n. a.	XML	This tag is used to communicate information that has no direct relation to a payment transaction but needed for the back-end system to finish processing the payment.