EPayment.notifyTrxSofortUeberweisung

Mit dieser Methode wird eine über Sofortüberweisung abgewickelte 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 Zahlungsdienstleister Sofortüberweisung bei Ihnen möglich ist.

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

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
notify-request-sofort-ueberweisung	XML	m	XML-Fragment welches die vom Backend zur Weiterarbeitung der Transaction benötigten Daten enthält. Dieses Element kann mehrfach vorkommen.

Request Struktur

Aufbau

<?xml version="1.0" encoding="ISO-8859-1"?>
<message system="vhs/3" version="1.0">
  <header>
    <client>9999</client>
    <service-provider>999</service-provider>
    <service-object>/net/dsb/commons/EPayment</service-object>
    <service-method>notifyTrxSofortUeberweisung</service-method>
    <service-version>1.0.0</service-version>
  </header>
  <body>
    <epayment-transaction>
      <notify-request-sofort-ueberweisung>
        <notify-type>NOTIFY-PURCHASE</notify-type>
        <external-transaction-id>1234xxx</external-transaction-id>
        <external-payment-date>2010-10-03</external-payment-date>
        <external-payment-time>10:34:00</external-payment-time>
        <amount>1235</amount>
        <currency-code>EUR</currency-code>
        <sue-transaction>?</sue-transaction>
        <sue-user_id>?</sue-user_id>
        <sue-project_id>?</sue-project_id>
        <sue-sender_holder>?</sue-sender_holder>
        <sue-sender_account_number>?</sue-sender_account_number>
        <sue-sender_bank_code>?</sue-sender_bank_code>
        <sue-sender_bank_name>?</sue-sender_bank_name>
        <sue-sender_bank_bic>?</sue-sender_bank_bic>
        <sue-sender_iban>?</sue-sender_iban>
        <sue-sender_country_id>?</sue-sender_country_id>
        <sue-recipient_holder>?</sue-recipient_holder>
        <sue-recipient_account_number>?</sue-recipient_account_number>
        <sue-recipient_bank_code>?</sue-recipient_bank_code>
        <sue-recipient_bank_name>?</sue-recipient_bank_name>
        <sue-recipient_bank_bic>?</sue-recipient_bank_bic>
        <sue-recipient_iban>?</sue-recipient_iban>
        <sue-recipient_country_id>?</sue-recipient_country_id>
        <sue-international_transaction>?</sue-international_transaction>
        <sue-amount>?</sue-amount>
        <sue-currency_id>?</sue-currency_id>
        <sue-reason_1>?</sue-reason_1>
        <sue-reason_2>?</sue-reason_2>
        <sue-security_criteria>?</sue-security_criteria>
        <sue-user_variable_0>?</sue-user_variable_0>
        <sue-user_variable_1>?</sue-user_variable_1>
        <sue-user_variable_2>?</sue-user_variable_2>
        <sue-user_variable_3>?</sue-user_variable_3>
        <sue-user_variable_4>?</sue-user_variable_4>
        <sue-user_variable_5>?</sue-user_variable_5>
        <sue-email_sender>?</sue-email_sender>
        <sue-email_recipient>?</sue-email_recipient>
      </notify-request-sofort-ueberweisung>
    </epayment-transaction>
  </body>
</message>

Elementdefinition

Feld	Mandatory	Länge	Art	Beschreibung
epayment-transaction	X	-	XML	XML Element
notify-request-sofort-ueberweisung	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			AN	Art der übermittelten Transaktionsdaten: NOTIFY-PREAUTHORIZE NOTIFY-PURCHASE (Default)
external-transaction-id	X	36	AN	Externe ID der Transaktion (d.h. ID des Zahlungsdienstleisters)
external-payment-date	X	10	D	Datum der Transaktion im Format „yyyy-MM-dd“
external-payment-time	X	8	T	Zeitpunkt der Transaktion im Format „HH:mm:ss“
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.
sue-transaction		27	AN	Transaktions-ID (eindeutig)
sue-user_id		32	AN	Kundennummer
sue-project_id		32	AN	Projektnummer
sue-sender_holder		27	AN	Absender Kontoinhaber
sue-sender_account_number		30	AN	Absender Kontonummer
sue-sender_bank_code		30	AN	Absender Bankleitzahl
sue-sender_bank_name		255	AN	Absender Bankname
sue-sender_bank_bic		50	AN	Absender BIC
sue-sender_iban		50	AN	Absender IBAN
sue-sender_country_id		2	AN	Absender Land
sue-recipient_holder		27	AN	Empfänger Kontoinhaber
sue-recipient_account_number		30	AN	Empfänger Kontonummer
sue-recipient_bank_code		30	AN	Empfänger Bankleitzahl
sue-recipient_bank_name		255	AN	Empfänger Bankname
sue-recipient_bank_bic		50	AN	Empfänger BIC
sue-recipient_iban		50	AN	Empfänger IBAN
sue-recipient_country_id		2	AN	Empfänger Land
sue-international_transaction		2	AN	Auslandsüberweisung
sue-amount		11	AN	Betrag
sue-currency_id		3	AN	Währung
sue-reason_1		255	AN	Verwendungszweck 1
sue-reason_2		155	AN	Verwendungszweck 2
sue-security_criteria		2	AN	Sicherheitskriterium erfüllt
sue-user_variable_0		255	AN	Kundenvariable 0
sue-user_variable_1		255	AN	Kundenvariable 1
sue-user_variable_2		255	AN	Kundenvariable 2
sue-user_variable_3		255	AN	Kundenvariable 3
sue-user_variable_4		255	AN	Kundenvariable 4
sue-user_variable_5		255	AN	Kundenvariable 5
sue-email_sender		255	AN	Für eine zusätzliche Benachrichtigung an den Absender; Parameter muss beim Aufruf an uns übergeben werden!
sue-email_recipient		255	AN	Für eine zusätzliche Benachrichtigung an den Absender; Parameter muss beim Aufruf an uns übergeben werden!