EPayment.notifyTrx

This service provides the details of a payment transaction to dsb. This is needed to give this information to the dsb backend systems. They need them to further process the payment. This method returns a transaction id you can use to reference the payment in an order..

Please check with your consultant, if the specified provider is available for you.

Object: /net/dsb/commons/EPayment
Method: notifyTrx
Version: 1.0.0

Parameter

Name	Type / Length	Mandatory / Optional	Description
notify-request	XML	m	XML element with the data. This can occur multiple times

Request

Structure

<message version="1.0" system="VHS/3">
  <header>
    <client>9999</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <epayment-transaction>
      <notiy-request>
        <request-id>cab67816-9b57-4cb0-a1c6-5621436bf222</request-id>
        <notify-type>NOTIFY-PURCHASE</notify-type>
        <external-transaction-id>934af2cf-ca5e-4b11-bec9-2d20ea06dee9</external-transaction-id>
        <external-payment-timestamp>2015-04-29T14:17:01+02:00</external-payment-timestamp>
        <amount>4000</amount>
        <currency-code>GBP</currency-code>
        <merchant-id>holla</merchant-id>
        <payment-provider>AMWS</payment-provider>
        <details>
          <customer-id>xy</customer-id>
          <customer-name>Olga</customer-name>
        </details>
      </notify-request>
    </epayment-transaction>
  </body>
</message>

Definition

Element	Mandatory	Length	Type	Description
epayment-transaction	X	-	XML	XML Element
notify-request	X	-	XML	XML Element
request-id		36	AN	A unique id of this notify request. If there are multiple notifies in this request the id must be provided and must be unique in all parts.
notify-type	X		AN	Type of the transaction
external-transaction-id	X	36	AN	payment provider's id of the transaction
external-payment-timestamp	X		D	Timestamp of the transaction ( Format: “yyyy-MM-dd'T'HH:mm:ss” )
amount	X	7	N	Amount of the transaction. This is in the minimal unit of this currency (i.e. EUR 10,00 ⇒ 1000).
currency-code	X	3	AN	Currency according to ISO 4217.
merchant-id			AN	ID of the merchant or the shop in the system of the payment provider. Mandatory, if the client has multiple merchant ids.
payment-provider	X	6	AN	Payment Provider; see List of payment providers
details				XML element with provider or shop specific data. This is saved and returned in a getTrxDetails request but not further used by the web service

The content of 'details' depends on the payment provider.

PAYPAL:

  <details>
    <customer-id>xy</customer-id>
    <customer-name>Olga</customer-name>
  </details>

EPAY:

  <details>
    <epay_tid>47713739</epay_tid>
    <epay_sessionident>47713739_190220181758331D532E40EDBA188E61254CBCDAC5648D41B3FA1C</epay_sessionident>
    <epay_comment>PAYBACK-565879155</epay_comment>
    <epay_description>PAYBACK-565879155</epay_description>
    <epay_transid>565879155</epay_transid>
    <epay_transid2>19656273</epay_transid2>
    <epay_transid3>551015144</epay_transid3>
    <epay-kartentyp>0</epay-kartentyp>
    <epay-date>2018-02-19</epay-date>
    <epay-time>17:58:33</epay-time>
    <epay-aid>40181039WN5313504</epay-aid>
    <epay-traceno>538426</epay-traceno>
    <epay-receiptno>0</epay-receiptno>
    <epay-transmode>PP</epay-transmode>
  </details>

AMWS: no Details.

ALTA:

  <details>
    <ap_paymentmethodid>10</ap_paymentmethodid>
    <ap_paymentproductid>1</ap_paymentproductid>
  </details>

The content must be coordinated with the backend system.