Table of Contents |
---|
Über Real Debitorenmanagement
Allgemeines zum Real Debitorenmanagement
Das Computop Paygate Das
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Page properties | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Weitere Informationen finden Sie auch auf der Webseite vom Real Debitorenmanagement (https://www.real-solution.de/).
Diagramm zum Prozessablauf
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Real Debitorenmanagement Prozessablauf
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
-Schnittstelle
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Bonitätsprüfung durchführen
Um eine Bonitätsprüfung für Real Solution über eine Server-zu-Server-Verbindung durchzuführen, rufen Sie bitte folgende URL auf:
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Die folgende Tabelle beschreibt die zu verschlüsselnden Übergabeparameter:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Bonitätsprüfung mit RealDebtor
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter
Format
CND
Beschreibung
MerchantID
ans..30
M
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID
ans..64
M
TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währung, drei Zeichen DIN / ISO 4217
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
RefNr
ns..30
M
Eindeutige Referenznummer zur Anfrage, zum Beispiel Bestellnummer
OrderDesc
ans..768
O
Beschreibung der gekauften Waren
EventToken
a2
M
Abkürzung der auszuführenden Aktion:
<BC> für BonitätsCheck
<DC> für DirectChange (muss mit Computop Support angestimmt werden). Hier erfolgt kein Bonitäts-check, die Daten werden nur im Paygate gespeichert. Erst bei einem Update (UP+RG) werden die Daten an Real Solution übermittelt; <OC> ist nicht notwendig.
RequestReason
a2
M
Anfrageart:
<ZG> für Zahlungsgarantie
<ZL> für Zahlungsgarantie Lastschrift
<VK> für Vorkasse
<VL> für Vorkasse per Lastschrift
<RL> für Ratenzahlung
IPAddr
ans..15
O
IP-Adresse der angefragten Person
CustomerID
ans..20
M
Kunden-, Debitoren- oder Kontonummer der angefragten Person
ShopID
ans..20
O
ID des Shops
Channel
ans..64
O
Falls verschiedene Bestellsysteme parallel genutzt werden, kann hier das Bestellsystem identifiziert werden
Salutation
ans..10
O
Anrede „Herr“, „Frau“, „Firma“ oder „Unbekannt“. Wenn nicht angegeben oder falsch, gilt „Unbekannt“.
FirstName
ans..24
M
Vorname des Kunden
LastName
ans..30
M
Nachname oder Firmenname
DateOfBirth
ans..10
O
Geburtsdatum im Format YYYY-MM-DD
PlaceOfBirth
ans..30
O
Geburtsort
AddrStreet
ans..30
M
Straßenname und Hausnummer
AddrDistrict
ans..30
O
Adresszusatz wie z.B. Ortsteil
AddrAddition
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
AddrZIP
ans..5
O
Postleitzahl
AddrCity
ans..30
O
Ort
AddrCountryCode
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Phone
ans..20
O
Telefonnummer des Kunden
ans..100
O
E-Mail-Adresse des Kunden
MobileNo
ans..20
O
Mobiltelefonnummer des Kunden
AccOwner
ans..30
O
Kontoinhaber. Aufbau: Anrede;Vorname;Nachname.
AccBank
ans..40
O
Name der Bank
IBAN
ans..34
O
Die IBAN ist Pflicht im Fall von:
<ZL> für Zahlungsgarantie Lastschrift
<RL> für Ratenzahlung
BIC
ans..11
O
BIC
Voranschrift (Optional: Alte Anschrift der Person)
AddrStreet2
ans..30
O
Straßenname und Hausnummer
AddrDistrict2
ans..30
O
Adresszusatz wie z.B. Ortsteil
AddrZip2
ans..5
O
Postleitzahl
AddrCity2
ans..30
O
Ort
AddressAddition2
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
AddrCountryCode2
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Lieferanschrift (Optional)
sdSalutation
ans..10
O
Anrede „Herr“, „Frau“, „Firma“ oder „Unbekannt“. Wenn nicht angegeben oder falsch, gilt „Unbekannt“.
sdFirstName
ans..24
O
Vorname des Kunden
sdLastName
ans..30
O
Nachname oder Firmenname
sdAddrStreet
ans..30
O
Straßenname und Hausnummer
sdAddrDistrict
ans..30
O
Adresszusatz wie z.B. Ortsteil
sdAddrZip
ans..5
O
Postleitzahl
sdAddrCity
ans..30
O
Ort
sdAddressAddition
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
sdAddrCountryCode
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Parameter für Ratenzahlung (optional)
Sollzinssatz, z.B. 650 für 6,5%
Pflicht im Fall von <RL> für Ratenzahlung
Anzahl der Raten
Pflicht im Fall von <RL> für Ratenzahlung
Anzahl der Ratenzahlungen pro Jahr. Derzeit unterstützte Werte:
12 = monatliche Ratenzahlung
4 = quartalsweise Ratenzahlung
2 = halbjährliche Ratenzahlung
1 = jährliche Ratenzahlung
Pflicht im Fall von <RL> für Ratenzahlung
Zulässige Werte:
0 : Die Rückzahlung beginnt am Ende des ersten Ratenzeitraums
1 : Die Rückzahlung beginnt zu Beginn des ersten Ratenzeitraums (eine genaue Angabe ist über das Feld DueDay möglich)
Standardwert ist (0)
Pflicht wenn InstallmentInitialPayment=1
Anzahl der Tage bis zur Fälligkeit der ersten Rate (ein Monat wird als 30 Tage gezählt):
0 – die erste Rate ist am Fälligkeitstag der Rechnung fällig (Vorauszahlung der Rate)
10 – die erste Rate ist 10 Tage nach dem Fälligkeitstag der Rechnung fällig
30 – die erste Rate ist 30 Tage (ein Monat) nach dem Fälligkeitstag der Rechnung fällig (aufgeschobene Ratenzahlung bei monatlicher Rate)
90 – die erste Rate ist 90 Tage (drei Monate) nach dem Fälligkeitstag der Rechnung fällig
Standardwert ist (0)
Parameter für Bonitätsprüfung mit RealDebtor
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihr System zurückgibt:
Parameter
Format
CND
Beschreibung
MID
ans..30
M
HändlerID, die von Computop vergeben wird
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID
an32
M
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID
ans..64
M
Transaktionsnummer des Händlers, die eindeutig sein muss
Status
a..50
M
OK oder FAILED
Description
ans..1024
M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
ns..30
O
Wenn zuvor übergeben, wird die Referenznummer zurückgegeben
Antwort-Parameter für Anlage von Debitoren
Bestellung anlegen
Um eine Bestellung für Real-Solution über eine Server-zu-Server-Verbindung anzulegen, verwenden Sie bitte folgende URL:
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter
Format
CND
Beschreibung
MerchantID
ans..30
M
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID
an32
M
Vom Paygate vergebene ID für die Bonitätsprüfung
TransID
ans..64
M
TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr
ns..30
M
Eindeutige Referenznummer, z.B. Bestellnummer
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währung, drei Zeichen DIN / ISO 4217
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
EventToken
a2
M
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Bestellungen über RealDebtor
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Parameter
Format
CND
Beschreibung
MID
ans..30
M
HändlerID, die von Computop vergeben wird
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID
an32
M
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID
ans..64
M
Transaktionsnummer des Händlers, die eindeutig sein muss
Status
a..50
M
OK oder FAILED
Description
ans..1024
M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
ns..30
O
Wenn zuvor übergeben, wird die Referenznummer zurückgegeben
Antwort-Parameter für Bestellungen über RealDebtor
Rechnungen anlegen, buchen, gutschreiben
Mit Bezug auf eine zuvor eingerichtete Bestellung können Sie Rechnungen anlegen, diese anschließend buchen, gutschreiben etc. Hierzu rufen Sie bitte folgende URL auf:
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter
Format
CND
Beschreibung
MerchantID
ans..30
M
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID
ans..64
M
TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währung, drei Zeichen DIN / ISO 4217
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
RefNr
ns..30
M
Eindeutige Referenznummer, zum Beispiel Bestellnummer
EventToken
a2
M
Abkürzung der auszuführenden Aktion: <UP> für Update Datensatz
RequestReason
a2
M
Anfrageart:
<RG> für Rechnung
<GU> für Gutschrift
<ZA> für Zahlung
<TR> für Teilrechnung (mit vorheriger Vereinbarung zu verwenden)
<MA> für Mahnung
<RM> für Mahnstatus zurücksetzen
<DF> für Ausfall
Capture
ans..6
O
Bestimmt Art und Zeitpunkt der Buchung.
AUTO: Die Rechnung ist bereits mit der Bestellung bezahlt (z.B. Zahlarten PayPal, Kreditkarte)
ACHTUNG: Es darf kein separater Request mit RequestReason=ZA zur Übermittlung der Zahlung geliefert werden.
PayID
an32
M
Vom Paygate vergebene ID für die betreffende Zahlung
PayType
a..3
Zahlungsart:
<EDD> Lastschrift (ELV)
<SO> Sofort
<PP> PayPal
<RG> Rechnung
<KL> Klarna
<CC> Kreditkarte allgemein ohne Markenaufteilung
<VI> Visa
<MC> MasterCard
<AE> American Express
<DC> Diners
<JCB> JCB
<MD> Maestro
<DI> Discover
Adressdaten (nur bei RequestReason RG)
DebitorID
ans..10
M
Kunden-, Debitoren- oder Kontonummer der angefragten Person
Salutation
ans..10
O
Anrede „Herr“, „Frau“, „Firma“ oder „Unbekannt“. Wenn nicht angegeben oder falsch, gilt „Unbekannt“.
FirstName
ans..24
M
Vorname
LastName
ans..30
M
Nachname oder Firmenname
DateOfBirth
ans..10
O
Geburtsdatum im Format YYYY-MM-DD
PlaceOfBirth
ans..30
O
Geburtsort
AddrStreet
ans..30
M
Straßenname und Hausnummer
AddrDistrict
ans..30
M
Adresszusatz wie z.B. Ortsteil
AddrAddition
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
AddrZIP
ans..5
O
Postleitzahl
AddrCity
ans..30
O
Ort
AddrCountryCode
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Phone
ans..20
O
Telefonnummer des Kunden
ans..100
O
E-Mail-Adresse des Kunden
MobileNo
ans..20
O
Mobiltelefonnummer des Kunden
AccOwner
ans..30
O
Kontoinhaber. Aufbau: Anrede;Vorname;Nachname.
AccBank
ans..40
O
Name der Bank
IBAN
ans..34
O
IBAN
BIC
ans..11
O
BIC
Voranschrift (Optional: Alte Anschrift der Person)
AddrStreet2
ans..30
O
Straßenname und Hausnummer
AddrDistrict2
ans..30
O
Adresszusatz wie z.B. Ortsteil
AddrZip2
ans..5
O
Postleitzahl
AddrCity2
ans..30
O
Ort
AddressAddition2
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
AddrCountryCode2
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Lieferanschrift (Optional)
sdSalutation
ans..10
O
Anrede „Herr“, „Frau“, „Firma“ oder „Unbekannt“. Wenn nicht angegeben oder falsch, gilt „Unbekannt“.
sdFirstName
ans..24
O
Vorname des Kunden
sdLastName
ans..30
O
Nachname oder Firmenname
sdAddrStreet
ans..30
O
Straßenname und Hausnummer
sdAddrDistrict
ans..30
O
Adresszusatz wie z.B. Ortsteil
sdAddrZip
ans..5
O
Postleitzahl
sdAddrCity
ans..30
O
Ort
sdAddressAddition
ans..50
O
Adresszusatz wie z.B. z.Hd. Frau xy
sdAddrCountryCode
a2
O
Ländercode zweistellig gemäß ISO 3166, DE=Deutschland
Zusatzdaten für Rechnung und Gutschrift
InvoiceNr
ans..20
O
Belegnummer der Rechnung oder Gutschrift, wenn mit Computop Support abgesprochen und entsprechend konfiguriert
InvoiceDate
ans..10
M
Belegdatum der Rechnung oder Gutschrift im Format YYYY-MM-DD
InvoiceText
ans..100
M
Belegtext der Rechnung oder Gutschrift.
Bei Rechnung optional, wenn OrderDesc angegeben ist.
DueDate
ans..10
C
Nur bei Rechnung: Fälligkeitsdatum (YYYY-MM-DD)
ArticleList
ans..1024
C
Nur bei Rechnung, optional: Artikelliste mit Beschreibung der Waren und Preise
<Nummer>;<Name>;<Zusatz>;<Bruttopreis>; <Nettopreis>;<Umsatzsteuersatz>;<Warengruppe>
<;> trennt Felder innerhalb eines Artikeldatensatzes
<+> trennt mehrere Artikeldatensätze
Datentyp (Größe)
Nummer (ans..40)
Name (ans..100)
Zusatz (ans..10)
Bruttopreis (n..10) in Cent
Nettopreis (n..10) in Cent
Umsatzsteuersatz (n..4), z.B. 1900 für 19%
Warengruppe (ans..15)
NetAmount
n..10
M
Nettobetrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
TaxCode
n..4
C
Nur bei Rechnung, optional; Pflicht, wenn ArticleList angegeben ist: Umsatzsteuersatz z.B. 1900 für 19%
Parameter für Rechnungen mit RealDebtor
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Parameter
Format
CND
Beschreibung
MID
ans..30
M
HändlerID, die von Computop vergeben wird
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID
an32
M
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID
ans..64
M
Transaktionsnummer des Händlers, die eindeutig sein muss
Status
a..50
M
OK oder FAILED
Description
ans..1024
M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
ns..30
O
Wenn zuvor übergeben, wird die Referenznummer zurückgegeben
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Rechnungen mit RealDebtor
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für Rechnungen mit RealDebtor
Bestellung stornieren
Um eine eingerichtete Bestellung zu stornieren, rufen Sie bitte folgende URL auf:
debtor.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter
Format
CND
Beschreibung
MerchantID
ans..30
M
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
TransID
ans..64
M
TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währung, drei Zeichen DIN / ISO 4217
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
EventToken
a2
M
Abkürzung der auszuführenden Aktion: <OS> für Open Position Storno
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
RefNr
ns..30
M
Parameter für Stornierung bei RealDebtor
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Parameter
Format
CND
Beschreibung
MID
ans..30
M
HändlerID, die von Computop vergeben wird
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID
an32
M
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID
ans..64
M
Transaktionsnummer des Händlers, die eindeutig sein muss
Status
a..50
M
OK oder FAILED
Description
ans..1024
M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
ns..30
O
Wenn zuvor übergeben, wird die Referenznummer zurückgegeben
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für Stornierung bei RealDebtor