EPayment.notifyTrx

Objekt: /net/dsb/commons/EPayment
Methode: notifyTrx
Version: 1.0.0

Mit dieser Methode wird eine Zahlungstransaktion bei DSB bekannt gegeben. Dies ist notwendig, da die Backend Systeme (AVS/3, VHS/3, …) diese Informationen für die weitere Verarbeitung der Zahlung benötigen. Die Methode gibt eine DSB-Transaktions ID zurück, die dann mit dem jeweiligen Auftrag übergeben werden muss.

Klären Sie vor der Verwendung dieser Methode, ob der gewünschte Zahlungsdienstleister bei Ihnen möglich ist.

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
notify-request	XML	m	XML-Fragment mit den vom Backend zur Weiterarbeitung der Transaction benötigten Daten. Dieses Element kann mehrfach vorkommen.

Request Struktur

Aufbau

<?xml version="1.0" encoding="ISO-8859-1"?>
<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>

Elementdefinition

Feld	Mandatory	Länge	Art	Beschreibung
epayment-transaction	X	-	XML	XML Element
notify-request	X	-	XML	XML Element
request-id		36	AN	Eine eindeutige ID, die diesen Request identifiziert. Bei mehrteiligen Zahlungen muss diese ID vorhanden und bei allen Teilen gleich sein.
notify-type	X		AN	Art der übermittelten Transaktionsdaten
external-transaction-id	X	36	AN	Externe ID der Transaktion (d.h. ID des Zahlungsdienstleisters)
external-payment-timestamp	X		D	Zeitpunkt der Transaktion im Format `xs:dateTime`
amount	X	7	N	Betrag der Transaktion. Achtung: Ganzzahliger Wert in der kleinsten Einheit der in der Anfrage angegebenen Währung (z.B. EUR 10,00 ⇒ 1000).
currency-code	X	3	AN	Transaktionswährung nach ISO 4217.
merchant-id	X		AN	ID des Händlers beim Zahlungsdienstleister
payment-provider	X	6	AN	Art des Zahlungsdienstleisters: siehe Liste der E Payment Provider
recurring-payment-id			AN	ID des Dienstleisters für wiederkehrende Zahlungen. Bei Paypal ist dies die billing agreement id.
details				XML Element mit beliebigen weiteren Werten. Diese werden gespeichert und beim getTrxDetails zurückgeliefert, aber sonst nicht verwendet.
dsb-extensions			XML	dsb-extensions

details enthält üblicherweis in Abhängigkeit vom Dienstleister:

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: keine Details.

ALTA:

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

Der Inhalt ist mit dem verarbeitenden Backend (AVS oder VHS) abzustimmen.