PDF Export

This method is used to notify the DSB system about a transaction when a card transaction is done directly with Cybersource. This is necessary so that the back-end systems (AVS/3 , VHS/3 … ) can do the necessary processing to finalise the payment. This method returns a DSB transaction id that must be included within the relevant Order so that the payment can be captured by the DSB back office.

Please check with your consultant, if Cybersource is available for you.

  • Object: /net/dsb/commons/CardTransactionProcessing
  • Method: notifyCardTransactionWithCybersource
  • Version: 1.0.0

Parameter

NameType / max. lengthmandatory?Description
notify-request-cybersource XML M XML element with all the needed data

Response Element

The ”response” XML document structure however only includes the element “cc-dsb-transaction-id”.

Example 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>
         <notify-request-cybersource>
            <request-id>227b0210-6d74-449c-88cd-cdc49b09e1fb</request-id>
            <cc-notify-type>REGISTER-PAYMENT</cc-notify-type>
            <cc-merchant-id>dsb_user</cc-merchant-id>
            <cy-orderPage_transactionType>sale,subscription</cy-orderPage_transactionType>
            <cy-paymentOption>card</cy-paymentOption>
            <cy-orderNumber>1266227872934</cy-orderNumber>
            <cy-orderAmount>744.00</cy-orderAmount>
            <cy-orderCurrency>gbp</cy-orderCurrency>
            <cy-billTo_firstName>Bart</cy-billTo_firstName>
            <cy-billTo_lastName>Simpson</cy-billTo_lastName>
            <cy-billTo_street1>45 Mainstreet</cy-billTo_street1>
            <cy-billTo_city>Springfield</cy-billTo_city>
            <cy-billTo_postalCode>RG67BC</cy-billTo_postalCode>
            <cy-billTo_country>UK</cy-billTo_country>
            <cy-billTo_company>Springfield Nuclear Power Plant</cy-billTo_company>
            <cy-billTo_email>bart@simpson.com</cy-billTo_email>
            <cy-card_accountNumber>############1111</cy-card_accountNumber>
            <cy-card_expirationMonth>02</cy-card_expirationMonth>
            <cy-card_expirationYear>2020</cy-card_expirationYear>
            <cy-card_cardType>001</cy-card_cardType>
            <cy-recurringSubscriptionInfo_frequency>on-demand</cy-recurringSubscriptionInfo_frequency>
            <cy-requestID>2662278729360176056203</cy-requestID>
            <cy-decision>ACCEPT</cy-decision>
            <cy-reasonCode>100</cy-reasonCode>
            <cy-orderPage_requestToken>Ahj77wSRA8WAAAA/guU</cy-orderPage_requestToken>
            <cy-ccAuthReply_reasonCode>100</cy-ccAuthReply_reasonCode>
            <cy-ccAuthReply_amount>744.00</cy-ccAuthReply_amount>
            <cy-ccAuthReply_authorizationCode>100</cy-ccAuthReply_authorizationCode>
            <cy-ccAuthReply_avsCodeRaw>00</cy-ccAuthReply_avsCodeRaw>
            <cy-ccAuthReply_authorizedDateTime>2010-02-15T095753Z</cy-ccAuthReply_authorizedDateTime> 
            <cy-ccAuthReply_processorResponse>0</cy-ccAuthReply_processorResponse> 
            <cy-paySubscriptionCreateReply_subscriptionID>26654326543456</cy-paySubscriptionCreateReply_subscriptionID>
            <dsb-extensions>
               <bank-clearing-account>100001</bank-clearing-account>
               <payment-part>
                  <part-transaction-id>1</part-transaction-id>
                  <part-amount>18600</part-amount>
               </payment-part>
            </dsb-extensions>
         </notify-request-cybersource> 
      </card-transaction>
   </body>
</message> 

Element definition (Cybersource)

Field M = Mandatory
O =Optional
C = Conditional
LengthTypeDescription
card-transaction M - C The element group for a card transaction
notify-request-Cybersource M - C The element group for transaction request data.
request-id O 36 AN A unique id that uniquely identifies the request
cc-notify-type M AN Type of transaction
Allowed values:
* AUTHORIZE
* REGISTER-AUTHORIZE
* REGISTER-PAYMENT
cc-merchant-id M 32 AN The merchant id where this request belongs to.
cy-orderPage_transactionType O AN Not all of these are supported. There also needs tobe a corresponding cc-notify-type defined, otherwise there will be an error thrown. e.g. if authorization is here and REGISTER-AUTHORIZE is set.
Allowed values:
authorization
authorization,subscription
sale
sale,subscription
subscription
subscription_credit
subscription_modify
cy-paymentOption O Allowed values:
card
check
Description:
Method of payment.
cy-orderNumber O 50 AN Cybersource orderNumber (cy_orderNumber or cy-merchantReferenceCode must be filled)
cy-merchantReferenceCode O 50 AN Cybersource merchantReferenceCode (cy_orderNumber or cy-merchantReferenceCode must be filled)
cy-orderAmount O 15 AN Cybersource orderAmount
cy-orderCurrency O 5 AN Cybersource orderCurrency
cy-billTo_firstName C 60 AN Cybersource firstName
cy-billTo_lastName C 60 AN Cybersource lastName
cy-billTo_street1 C 60 AN Cybersource billTo_street1
cy-billTo-street2 C 60 AN Cybersource billTo-street2
cy-billTo_city C 50 AN Cybersource billTo_city
cy-billTo_state C 2 AN Cybersource billTo_state
cy-billTo_postalCode C 10 AN Cybersource billTo_postalCode
cy-billTo_country C 2 AN Cybersource billTo_country
cy-billTo_company C 40 AN Cybersource billTo_company
cy-billTo_phoneNumber C 15 AN Cybersource billTo_phoneNumber
cy-billTo_email C 255 AN Cybersource billTo_email
cy-card_accountNumber C 20 AN Cybersource card_accountNumber
cy-card_expirationMonth C 2 N Cybersource card_expirationMonth
cy-card_expirationYear C 4 N Cybersource card_expirationYear
cy-card_cardType C 3 AN Cybersource card_cardType
cy-recurringSubscriptionInfo_frequency C AN Cybersource recurringSubscriptionInfo_frequency
Possible values:
on-demand
cy-requestID M 32 AN Cybersource requestID
cy-decision M AN Cybersource decision
Possible values:
ACCEPT
cy-reasonCode O 5 AN Cybersource reasonCode
cy-orderPage_requestToken M 256 AN Cybersource orderPage_requestToken
cy-ccAuthReply_reasonCode C 5 AN Cybersource ccAuthReply_reasonCode
cy-ccAuthReply_amount C 15 AN Cybersource ccAuthReply_amount
cy-ccAuthReply_authorizationCode C 7 AN Cybersource ccAuthReply_authorizationCode
cy-ccAuthReply_avsCode C 1 AN Cybersource ccAuthReply_avsCode
cy-ccAuthReply_avsCodeRaw C 10 AN Cybersource ccAuthReply_avsCodeRaw
cy-ccAuthReply_authorizedDateTime C 20 AN Cybersource ccAuthReply_authorizedDateTime
cy-ccAuthReply_processorResponse C 10 AN Cybersource ccAuthReply_processorResponse
cy-reconciliationID C 60 AN Cybersource reconciliationID
cy-paySubscriptionCreateReply_subscriptionIDC 26 AN Cybersource paySubscriptionCreateReply_subscriptionID
dsb-extensions C n.a. XML dsb-extensions

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>
         <notify-request-cybersource>
              ...
         </notify-request-cybersource>
         <response>
            <cc-dsb-transaction-id>B6AF01E3-712D-CE62-8E7E-38B0A3D0E2FF</cc-dsb-transaction-id>
         </response>
      </card-transaction>
   </body>
</message>
This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information