PDF Export

EPayment.performPurchase

Mit dieser Methode wird eine Zahlung des Kunden über einen Dienstleister an den Händler abgewickelt. Dies ist nur möglich, wenn ein Billing Agreement existiert, in dem der Kunde diesem Verfahren zugestimmt hat.

  • Objekt: /net/dsb/commons/EPayment
  • Methode: performPurchase
  • Version: 1.0.0

Parameter

Name Typ / LängeKann / MussBeschreibung
purchase-request XML m XML-Fragment welches die vom Backend zur Weiterarbeitung der Transaction benötigten Daten enthält.
Request Struktur
Aufbau
<?xml version="1.0" encoding="ISO-8859-1"?>
<message system="AVS/3" version="1.0">
  <header>
    <client>355</client>
    <avs3-service-provider>999</avs3-service-provider>
    <service-object>/net/dsb/commons/EPayment</service-object>
    <service-method>performPurchase</service-method>
    <service-version>1.0.0</service-version>
  </header>
  <body>
    <epayment-transaction>
      <purchase-request>
        <payment-provider>AMWS</payment-provider>
        <merchant-transaction-id>myInvoiceID</merchant-transaction-id>
        <billing-agreement-id>C02-5198887-64554320</billing-agreement-id>
        <amount>10.00</amount>
        <curreny-code>EUR</curreny-code>
        <invoice-id>DSB-I0815</invoice-id>
        <memo>thank you</memo>
        <payment-item>
          <name>Abo</name>
          <amount>7.50</amount>
          <item-number>42</item-number>
          <item-description>next year’s subscription</item-description>
        </payment-item>
        <merchant-request-id>lalala</merchant-request-id>
        <store-name>MySuperStore</store-name>
      </purchase-request>
    </epayment-transaction>
  </body>
</message>
Elementdefinition
Feld MandatoryLängeArtBeschreibung
payment-provider M 6 AN
merchant-id B 36 AN ID des Händlers; Mandatory falls bei diesem Mandant mehrere Händler IDs definiert sind.
merchant-transaction-idM AN ID dieser Transaktion im System des Händlers
billing-agreement-id M AN Billing Agreement ID
amount M N Betrag der Transaktion. Betrag mit zwei Nachkommastellen
currency-code M 3 AN Transaktionswährung nach ISO 4217.
invoice-id M AN Rechnungsnummer
memo O AN Beliebiger Text, der auf der Abrechnung des Kunden erscheint.
payment-item O XMLbeliebige Anzahl Auftragspositionen
name O AN Bezeichnung, z.B. Aboname oder Abonummer
amount M N Betrag dieser Auftragsposition. Die Summe der Auftragspositionen muss dem Gesamtbetrag entsprechen.
item-number M N Nummer der Auftragsposition, z.B. Abonummer oder fortlaufende Nummer
item-description O AN Beschreibung
merchant-request-id O AN Eindeutige ID für diesen Request im Kundensystem
store-name O AN Bezeichnung des Händler-Shops. Bei Amazon erscheint dies auf der Kundenabrechnung.
Response Struktur
Aufbau
<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="VHS/3">
  <header>
    <client>9999</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <purchase-response>
      <payment-result>Success</payment-result>
      <transaction-id>786769</transaction-id>
      <fee-amount>1.00</fee-amount>
      <gross-amount>10.00</gross-amount>
      <payment-date></payment-date>
      <error>
        <error-code>543644</error-code>
        <error-message>too much money</error-message>
      </error>
      <dsb-transaction-id>F486B9BB-F15D-6FBE-D43E-BEC165003A4D</dsb-transaction-id>
    </purchase-response>
  </body>
</message>
Elementdefinition
Feld ArtBeschreibung
purchase-response XMLXML Element
transaction-id AN TransactionID der Zahlung. Fehlt im Fehlerfall.
fee-amount N Gebühr Wert mit zwei Nachkommastellen. Format: 1,234.00 Fehlt im Fehlerfall.
gross-amount N Gesamtsummer Wert mit zwei Nachkommastellen. Format: 1,234.00 Fehlt im Fehlerfall.
payment-date D Zeitpunkt der Zahlung
error XML Im Fehlerfall
error-code N Fehlercode
error-message AN Fehlertext
dsb-transaction-id AN DSB ID dieser Zahlung
Cookies helfen bei der Bereitstellung von Inhalten. Durch die Nutzung dieser Seiten erklären Sie sich damit einverstanden, dass Cookies auf Ihrem Rechner gespeichert werden. Weitere Information