• DeutschEnglish

Riverty (AfterPay)

Über Riverty

Allgemeines zu Riverty

Logo

COO 6505 1000 17 1692668

Info

Riverty bietet Rechnungskauf nach der Lieferung an. Käufer können die Artikel in vier einfachen Raten bezahlen, ohne dass beim Bestellvorgang zusätzliche Angaben erforderlich sind. Für den Händler gibt es gibt kein Risiko für Betrug oder Zahlungsausfall. Nach einem Risikocheck übernimmt Riverty das gesamte Ausfallrisiko des Endkunden für jede einzelne Transaktion.

Type

Zahlungen per Rechnungs- und Ratenkauf

Weitere Informationen finden Sie auch auf der Webseite von Riverty (https://www.riverty.com/en/).

Diagramm zum Prozessablauf

Paygate-Schnittstelle

Definitionen

Datenformate

Format

Beschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzungen

Abkürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

Abfrage verfügbarer Zahlungsarten (Zwei-Schritt-Autorisierung)

Riverty unterscheidet zwischen der Ein-Schritt- und Zwei-Schritt-Autorisierung. Die Ein-Schritt-Autorisierung dient Händlern, die nur die normale Zahlung per Rechnung in ihrem Checkout nutzen. Die Zwei-Schritt-Autorisierung ermöglicht es, für einen bestimmten Warenkorb die hierfür verfügbaren Zahlungsarten und weitere Informationen dazu abzufragen.

Um eine Zwei-Schritt-Autorisierung mit Riverty über eine Server-zu-Server-Verbindung abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/afterpay.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

"transactionId": "..."

ans..18

C

TransaktionsID, die für jede Zahlung eindeutig sein muss.

Der Parameter wird für EventToken="Return" nicht benötigt.

RefNr

"referenceNumber": "..."

ns..30

C

Eindeutige Referenznummer.

Der Parameter wird für EventToken="Return" nicht benötigt.

PayID

"paymentId": "..."

an32

C

VomPaygate vergebene ID für die Zahlung, in deren Rahmen Waren zurückgegeben wurden.

Der Parameter wird nur für EventToken="Return" benötigt.

InvoiceNr

"order": {"number": "..."}

ans..30

C

Rechnungsnummer, die im Riverty-Portal angezeigt wird. Eine Bestellung kann mehrere Rechnungen enthalten.

Der Parameter wird nur für EventToken="Return" benötigt.

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

EventToken

"payment": {"riverty": {"eventToken": "..." }}

a..19

M

Der zweistufige Prozess wird durch die Übermittlung von "PAYMENTMETHODS" ausgelöst.

Der Wert „Return“ löst eine Rücksendebenachrichtigung aus (Händler teilt Riverty mit, dass ein Kunde Waren zurückgesendet hat das eine Zahlung des Kunden von Riverty nicht erwartet werden sollte).

AddrCountryCode

"billing": {"addressInfo": { "country": {"A2"= "..." }}}

a2

M

Ländercode

„NO“, „SE“, „FI“, „DK“, „DE“, „AT“, “CH”, “NL”, “BE”

Order

"order": JSON

ans..1024

M

Bestellinformationen als JSON-String im Format Base64.

Siehe JSON-Objekt: Order

Für EventToken="Return", siehe JSON-Objekt RefundOrder

Parameter für Zahlungen mit Riverty

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Status

"status": "OK"

"status": "AUTHORIZED"

"status": "FAILED"

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

CodeExt

"payment": {"riverty": {"errorCode": ... }}

n..10

O

Fehlercode von Riverty, wenn mitComputop Helpdesk abgesprochen

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

AllowedPayMethods

"payment": {"paymentMethods": "..."}

ans..1024

O

Erlaubte Zahlungsarten als JSON-String im Format Base64.

(siehe JSON-Objekte: AllowedPayMethods)

Ergebnis-Parameter für Riverty

Im zweiten Schritt werden die Kunden- und Bestelldaten sowie die zu verwendende Zahlungsart und evtl. weitere zur Zahlungsart gehörende Informationen übergeben.

Um den zweiten Schritt durchzuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/afterpay.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

PayType

"payment": {"riverty": {"paymentType": "..." }}

a..19

M

Zahlungsmethode:

„Invoice“ für Rechnung

„Account“ für flexibler Zahlungsplan

„Installment“ für Ratenzahlungen

„ConsolidatedInvoice“ für konsolidierte Rechnung

Für Lastschrift muss der Parameter PayType auf "Invoice" gesetzt und Parameter IBAN angegeben werden.

bdCompanyOrPerson

a..7

M

Kundenkategorie:

„Company“ für Unternehmen

„Person“ für Personen (Standardwert)

SocialSecurityNumber

"billing": {"consumer": {"socialSecurityNumber": "..." }}

"billing": {"business": {"registrationNumber": "..." }}

ans..16

C

Pflicht: FI, NO, SE. Optional: AT, BE, CH, DE, DK, NL.

Sozialversicherungsnummer bei einer Person in Schweden. Registrierungsnummer im Falle eines Unternehmens.

Für AT, BE, CH, DE und NL gilt zusätzlich: Die Nummer muss mit „HRB“ für Handelsgesellschaften und Kapitalgesellschaften oder mit „HRA“ für Einzelkaufleute und Personengesellschaften beginnen.

Dieser Parameter ist mit dem Parameter bdCompanyOrPerson verknüpft.

LegalForm

"billing": {"business": {"companyLegalForm": "..." }}

ans..50

O

Rechtsform des Unternehmens. Dieser Parameter ist mit dem Parameter bdCompanyOrPerson verknüpft.

Mögliche Werte:

Für Deutschland: AG, AG & Co. KG, eG, EK,  e.V., GbR, GmbH, GmbH & Co. KG, KG, OHG, UG

Für Österreich: AG, AG & Co. KG, eG, EK,  e.V., GesbR, GmbH, GmbH & Co. KG, KG, OHG, UG

Für die Schweiz: AG, eG, e.V.

AddrCountryCode

"billing": {"addressInfo": { "country": { "A2": "..." } }}

a2

O

Ländercode:

„NO“, „SE“, „FI“, „DK“, „DE“, „AT“, “CH”, “NL”, “BE”

AddrZip

"billing": {"addressInfo": {"postalCode": "..." }}

ans..10

M

Postleitzahl

AddrStreet

"billing": {"addressInfo": {"addressLine1": { "street": "..." } }}

ans..80

M

Straße oder Packstation

AddrStreetNr

"billing": {"addressInfo": {"addressLine1": { "streetNumber": "..." } }

a..50

O

Haus- oder Packstationsnummer

AddrStreetNr2

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..10

O

Hausnummernzusatz

AddrCity

"billing": {"addressInfo": { "city": "..." }}

ans..100

M

Ort

careOf

"payment": {"riverty": {"billingCareO": "..." }}

ans..50

O

per Adresse.

Vermittler, der für die Beförderung einer Postsendung vom Postsystem zum endgültigen Empfänger verantwortlich ist. Zum Beispiel Jane c/o John (“Jane an der Adresse von John”). Dieses Feld muss auch für Firmen-, Behörden- und Organisationsnamen verwendet werden – z. B. "Sportverein Blau-Weiß e.V."

FirstName

"billing": {"consumer": {"firstName": "..." }}

ans..50

M

Vorname

LastName

"billing": {"consumer": {"lastName": "..." }}

ans..50

M

Nachname

CustomerID

"billing": {"consumer": {"customerId": "..." }}

ans..20

O

Eindeutige Kundennummer

Salutation

"billing": {"consumer": {"salutation": "..." }}

a..4

O

Anrede:

„Mr“ für Herr

„Mrs“ für Frau

„Miss“ für Fräulein

bdEmail

"billing": {"contactInfo": {"email": "..." }}

ans..100

M

E-Mail-Adresse

bdPhone

"billing": {"contactInfo": {"phone": ... }}

ns..20

O

Telefonnummer

bdMobileNo

"billing": {"contactInfo": {"mobilePhone": ... }}

ns..20

O

Handynummer

DateOfBirth

"billing": {"contactInfo": {"birthdate": "..." }}

an10

M

Geburtsdatum im Format JJJJ-MM-TT. Für Firmen nicht zutreffend.

bdCompany

"billing": {"business": {"companyLegalName": "..." }}

ans..255

C

Name des kaufenden Unternehmens.

Erforderlich, wenn bdCompanyOrPerson gleich 'Company' ist.

VatID

"payment": {"riverty": {"vatId": "..." }}

ans..50

C

Umsatzsteuer-Identifikationsnummer, die eindeutige Nummer, die ein Unternehmen identifiziert.

Das Feld ist für die Abwicklung von B2B-Transaktionen für Deutschland obligatorisch.

CustomerRisk

"payment": {"riverty": {"customerRisk": "..." }}

ans..1024

M

Risikorelevante Daten als JSON-String im Base64-Format (siehe JSON-Objekte: CustomerRisk)

Händler können externe Risikoprüfungen durchführen und Riverty diese Informationen zusenden.

Language

"language": "..."

a2

O

Sprache: „NO“, „SE“, „FI“, „DK”, “EN”, “DE”, “NL”, “FR” zulässig

CompanyOrPerson

"companyOrPerson": "Company"

"companyOrPerson": ""

a..7

C

Kundenkategorie der Lieferadresse:

„Company“ für Unternehmen

„Person“ für Personen (Standardwert)

Erforderlich, falls eines der sd-Felder (siehe unten) angegeben wird.

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." } }}

a2

O

Ländercode der Lieferadresse: „NO“, „SE“, „FI“, „DK“, „DE“, „AT“, “CH”, “NL”, “BE”

sdZip

"shipping": {"addressInfo": {"postalCode": "..." }}

ans..10

O

Postleitzahl der Lieferadresse

sdStreet

"shipping": {"addressInfo": {"addressLine1": { "street": "..." } }}

ans..80

O

Straße oder Packstation der Lieferadresse

sdStreetNr

"shipping": {"addressInfo": {"addressLine1": { "streetNumber": "..." }

a..50

O

Haus- oder Packstationsnummer der Lieferadresse

sdStreetNr2

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..10

O

Straßennummernzusatz der Lieferadresse

sdCity

"shipping": {"addressInfo": { "city": "..." }}

ans..100

O

Ort der Lieferadresse

sdcareOf

"payment": {"riverty": {"shippingCareO": "..." }}

ans..50

O

per Adresse.

Vermittler, der für die Beförderung einer Postsendung vom Postsystem zum endgültigen Empfänger verantwortlich ist. Zum Beispiel Jane c/o John (“Jane an der Adresse von John”). Dieses Feld muss auch für Firmen-, Behörden- und Organisationsnamen verwendet werden – z. B. "Sportverein Blau-Weiß e.V."

ShippingMethod

"payment": {"riverty": {"shippingMethod": "..." }}

ans..50

O

Adressentyp.

Mögliche Werte: "Standard" (Standardwert), "PickUpPoint", "InStore"

sdFirstName

"shipping": {"consumer": {"firstName": "..." }}

ans..50

O

Vorname der Lieferadresse

sdLastName

"shipping": {"consumer": {"lastName": "..." }}

ans..50

O

Nachname der Lieferadresse

sdSalutation

"shipping": {"consumer": {"salutation": "..." }}

a..4

O

Anrede der Lieferadresse

„Mr“ für Herr

„Mrs“ für Frau

„Miss“ für Fräulein

Gültig bei AddrCountryCode = „DE“, „DK“,“NL“, „BE“, „AT“ oder „CH“

Email

"shipping": {"contactInfo": {"email": "..." }}

ans..100

O

E-Mail-Adresse der Lieferadresse

Phone

"shipping": {"contactInfo": {"phone": "..." }}

ns..50

O

Telefonnummer der Lieferadresse

MobileNo

"shipping": {"contactInfo": {"mobilePhone": "..." }}

ns..50

O

Handynummer der Lieferadresse

sdCompany

"shipping": {"business": {"companyLegalName": "..." }}

ans..50

C

Name des kaufenden Unternehmens.

Erforderlich, wenn CompanyOrPerson gleich 'Company' ist. Alles ab 50 Zeichen wird abgeschnitten.

BIC

"payment": {"riverty": { "account": { "code": "..." } }}

ans..11

O

Bank Identifier Code (gültig bei AddrCountryCode = “DE”)

IBAN

"payment": {"riverty": { "account": { "number": "..." } }}

ans..34

C

International Bank Account Number (gültig bei AddrCountryCode = “DE”).

Bitte beachten Sie, dass IBAN obligatorisch ist, wenn PayType=invoice oder PayType=installment.

ProductNr

"payment": {"riverty": {"profileNumber": ... }}

n..8

C

Profilnummer

Pflicht bei PayType = "Account" oder "Installment"

InvoiceDate

"order": {"creationDate": "..."}

an10

O

Rechnungsdatum im Format JJJJ-MM-TT.

Nur bei PayType = "ConsolidatedInvoice"

Parameter für Riverty

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Status

"status": "AUTHORIZE_REQUEST"

"status": "FAILED"

a..50

M

AUTHORIZE_REQUEST oder FAILED

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PARAMETER CodeExt_REST AS ABOVE

KeyRESTFormatCNDDescription

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

BillingAddress

"payment": {"billing": JSON }

ans..1024

O

Gegebenenfalls korrigierte Rechnungsadresse als JSON-String im Base64-Format.

(siehe JSON-Objekte: Address)

ShippingAddress

"payment": {"shipping": JSON }

ans..1024

O

Gegebenenfalls korrigierte Lieferadresse als JSON-String im Base64-Format.

(siehe JSON-Objekte: Address)

Ergebnis-Parameter für Riverty

Aufruf der Schnittstelle für Ein-Schritt-Autorisierung

Um eine Ein-Schritt-Autorisierung mit Riverty abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/afterpay.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

PayType

"payment": {"riverty": {"paymentType": "..." }}

a..19

M

Zahlungsmethode:

„Invoice“ für Rechnung

Für Lastschrift muss der Parameter PayType auf "Invoice" gesetzt und Parameter IBAN angegeben werden.

BIC

"payment": {"riverty": { "account": { "code": "..." } }}

ans..11

O

Bank Identifier Code (gültig bei AddrCountryCode = “DE”)

IBAN

"payment": {"riverty": { "account": { "number": "..." } }}

ans..34

C

International Bank Account Number (gültig bei AddrCountryCode = “DE”).

Bitte beachten Sie, dass IBAN obligatorisch ist, wenn PayType=invoice oder PayType=installment.

bdCompanyOrPerson

a..7

O

Kundenkategorie:

„Company“ für Unternehmen

„Person“ für Personen (Standardwert)

SocialSecurityNumber

"billing": {"consumer": {"socialSecurityNumber": "..." }}

"billing": {"business": {"registrationNumber": "..." }}

ans..16

C

Pflicht: FI, NO, SE. Optional: AT, BE, CH, DE, DK, NL.

Sozialversicherungsnummer bei einer Person in Schweden. Registrierungsnummer im Falle eines Unternehmens.

Für AT, BE, CH, DE und NL gilt zusätzlich: Die Nummer muss mit „HRB“ für Handelsgesellschaften und Kapitalgesellschaften oder mit „HRA“ für Einzelkaufleute und Personengesellschaften beginnen.

Dieser Parameter ist mit dem Parameter bdCompanyOrPerson verknüpft.

LegalForm

"billing": {"business": {"companyLegalForm": "..." }}

ans..50

O

Rechtsform des Unternehmens. Dieser Parameter ist mit dem Parameter bdCompanyOrPerson verknüpft.

Mögliche Werte:

Für Deutschland: AG, AG & Co. KG, eG, EK,  e.V., GbR, GmbH, GmbH & Co. KG, KG, OHG, UG

Für Österreich: AG, AG & Co. KG, eG, EK,  e.V., GesbR, GmbH, GmbH & Co. KG, KG, OHG, UG

Für die Schweiz: AG, eG, e.V.

PARAMETER AddrCountryCode_REST AS ABOVE

KeyRESTFormatCNDDescription

AddrZip

"billing": {"addressInfo": {"postalCode": "..." }}

ans..10

M

Postleitzahl

AddrStreet

"billing": {"addressInfo": {"addressLine1": { "street": "..." } }}

ans..80

M

Straße oder Packstation

AddrStreetNr

"billing": {"addressInfo": {"addressLine1": { "streetNumber": "..." } }

a..50

O

Haus- oder Packstationsnummer

AddrStreetNr2

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..10

O

Hausnummernzusatz

AddrCity

"billing": {"addressInfo": { "city": "..." }}

ans..100

M

Ort

careOf

"payment": {"riverty": {"billingCareO": "..." }}

ans..50

O

per Adresse.

Vermittler, der für die Beförderung einer Postsendung vom Postsystem zum endgültigen Empfänger verantwortlich ist. Zum Beispiel Jane c/o John (“Jane an der Adresse von John”). Dieses Feld muss auch für Firmen-, Behörden- und Organisationsnamen verwendet werden – z. B. "Sportverein Blau-Weiß e.V."

FirstName

"billing": {"consumer": {"firstName": "..." }}

ans..50

M

Vorname

LastName

"billing": {"consumer": {"lastName": "..." }}

ans..50

M

Nachname

CustomerID

"billing": {"consumer": {"customerId": "..." }}

ans..20

O

Eindeutige Kundennummer

Salutation

"billing": {"consumer": {"salutation": "..." }}

a..4

O

Anrede:

„Mr“ für Herr

„Mrs“ für Frau

„Miss“ für Fräulein

bdEmail

"billing": {"contactInfo": {"email": "..." }}

ans..100

M

E-Mail-Adresse

bdPhone

"billing": {"contactInfo": {"phone": ... }}

ns..20

O

Telefonnummer

bdMobileNo

"billing": {"contactInfo": {"mobilePhone": ... }}

ns..20

O

Handynummer

DateOfBirth

"billing": {"contactInfo": {"birthdate": "..." }}

an10

M

Geburtsdatum im Format JJJJ-MM-TT. Für Firmen nicht zutreffend.

bdCompany

"billing": {"business": {"companyLegalName": "..." }}

ans..50

C

Name des kaufenden Unternehmens.

Erforderlich, wenn bdCompanyOrPerson gleich 'Company' ist. Alles ab 50 Zeichen wird abgeschnitten.

VatID

"payment": {"riverty": {"vatId": "..." }}

ans..50

C

Umsatzsteuer-Identifikationsnummer, die eindeutige Nummer, die ein Unternehmen identifiziert.

Das Feld ist für die Abwicklung von B2B-Transaktionen für Deutschland obligatorisch.

CustomerRisk

"payment": {"riverty": {"customerRisk": "..." }}

ans..1024

M

Risikorelevante Daten als JSON-String im Base64-Format (siehe JSON-Objekte: CustomerRisk)

Händler können externe Risikoprüfungen durchführen und Riverty diese Informationen zusenden.

Language

"language": "..."

a2

O

Sprache: „NO“, „SE“, „FI“, „DK”, “EN”, “DE”, “NL”, “FR” zulässig

CompanyOrPerson

"companyOrPerson": "Company"

"companyOrPerson": ""

a..7

C

Kundenkategorie der Lieferadresse:

„Company“ für Unternehmen

„Person“ für Personen (Standardwert)

Erforderlich, falls eines der sd-Felder (siehe unten) angegeben wird.

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." } }}

a2

O

Ländercode der Lieferadresse: „NO“, „SE“, „FI“, „DK“, „DE“, „AT“, “CH”, “NL”, “BE”

sdZip

"shipping": {"addressInfo": {"postalCode": "..." }}

ans..10

O

Postleitzahl der Lieferadresse

sdStreet

"shipping": {"addressInfo": {"addressLine1": { "street": "..." } }}

ans..80

O

Straße oder Packstation der Lieferadresse

sdStreetNr

"shipping": {"addressInfo": {"addressLine1": { "streetNumber": "..." }

a..50

O

Haus- oder Packstationsnummer der Lieferadresse

sdStreetNr2

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..10

O

Straßennummernzusatz der Lieferadresse

sdCity

"shipping": {"addressInfo": { "city": "..." }}

ans..100

O

Ort der Lieferadresse

sdcareOf

"payment": {"riverty": {"shippingCareO": "..." }}

ans..50

O

per Adresse.

Vermittler, der für die Beförderung einer Postsendung vom Postsystem zum endgültigen Empfänger verantwortlich ist. Zum Beispiel Jane c/o John (“Jane an der Adresse von John”). Dieses Feld muss auch für Firmen-, Behörden- und Organisationsnamen verwendet werden – z. B. "Sportverein Blau-Weiß e.V."

ShippingMethod

"payment": {"riverty": {"shippingMethod": "..." }}

ans..50

O

Adressentyp.

Mögliche Werte: "Standard" (Standardwert), "PickUpPoint", "InStore"

sdFirstName

"shipping": {"consumer": {"firstName": "..." }}

ans..50

O

Vorname der Lieferadresse

sdLastName

"shipping": {"consumer": {"lastName": "..." }}

ans..50

O

Nachname der Lieferadresse

sdSalutation

"shipping": {"consumer": {"salutation": "..." }}

a..4

O

Anrede der Lieferadresse

„Mr“ für Herr

„Mrs“ für Frau

„Miss“ für Fräulein

Gültig bei AddrCountryCode = „DE“, „DK“,“NL“, „BE“, „AT“ oder „CH“

Email

"shipping": {"contactInfo": {"email": "..." }}

ans..100

O

E-Mail-Adresse der Lieferadresse

Phone

"shipping": {"contactInfo": {"phone": "..." }}

ns..50

O

Telefonnummer der Lieferadresse

MobileNo

"shipping": {"contactInfo": {"mobilePhone": "..." }}

ns..50

O

Handynummer der Lieferadresse

sdCompany

"shipping": {"business": {"companyLegalName": "..." }}

ans..50

C

Name des kaufenden Unternehmens.

Erforderlich, wenn CompanyOrPerson gleich 'Company' ist. Alles ab 50 Zeichen wird abgeschnitten.

Order

"order": JSON

ans..1024

M

Bestellinformationen als JSON-String im Format Base64.

Siehe JSON-Objekt: Order

Parameter für Zahlungen mit Riverty

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PARAMETER CodeExt_REST AS ABOVE

KeyRESTFormatCNDDescription

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

BillingAddress

"payment": {"billing": JSON }

ans..1024

O

Gegebenenfalls korrigierte Rechnungsadresse als JSON-String im Base64-Format.

(siehe JSON-Objekte: Address)

ShippingAddress

"payment": {"shipping": JSON }

ans..1024

O

Gegebenenfalls korrigierte Lieferadresse als JSON-String im Base64-Format.

(siehe JSON-Objekte: Address)

Ergebnis-Parameter für Riverty

Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) für Riverty über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/capture.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die zu buchende Zahlung

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

OrderDesc

"order": {"description[0]": "..."}

ans..768

O

Beschreibung der gekauften Waren, Einzelpreise, Händlerkommentar etc.

ReqId

"requestId": "..."

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Order

"order": JSON

ans..1024

C

Pflicht bei Teilbuchung oder wenn sich die Bestellinformationen bei gleichem Gesamtbetrag geändert haben.

Bestellinformationen als JSON-String im Format Base64.

Siehe JSON-Objekt: Order

InvoiceNr

"order": {"creationDate": "..."}

ans..30

O

Wird nur berücksichtigt, wenn Order ebenfalls gesendet wird.

Rechnungsnummer, die im Riverty-Portal angezeigt wird. Eine Bestellung kann mehrere Rechnungen enthalten.

ShippingData

"shipping": JSON

ans..1024

O

Wird nur berücksichtigt, wenn Order ebenfalls gesendet wird.

Versandinformationen als JSON-String im Base64-Format.

(siehe JSON-Objekte: ShippingData)

Parameter für Riverty-Buchungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

"referenceNumber": "..."

ns..30

O

Eindeutige Referenznummer

Status

"status": "OK"

"status": "CAPTURE_REQUEST"

"status": "FAILED"

a..50

M

OK, CAPTURE_REQUEST oder FAILED

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

InvoiceNumber

"order": {"number": "..."}

ans..30

O

Buchungsnummer: wird vom Händler erzeugt oder falls nicht verfügbar von Riverty. Sie ist für Teilgutschriften erforderlich.

CodeExt

"payment": {"riverty": {"errorCode": ... }}

n..10

O

Fehlercode von Riverty, wenn mitComputop Helpdesk abgesprochen

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Riverty-Buchungen

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Bei einer Gutschrift mit Bezug auf eine Buchung ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt. Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/credit.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

PARAMETER RefNr_REST AS ABOVE

KeyRESTFormatCNDDescription

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

OrderDesc

"order": {"description[0]": "..."}

ans..768

O

Beschreibung der gekauften Waren, Einzelpreise, Händlerkommentar etc.

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

ReqId

"requestId": "..."

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Order

"order": JSON

ans..1024

C

Pflicht bei Teilgutschriften

Bestellinformationen als JSON-String im Format Base64.

Siehe JSON-Objekt: RefundOrder

InvoiceNr

"order": {"creationDate": "..."

ans..30

C

Wird nur berücksichtigt, wenn Order ebenfalls gesendet wird, ist dann allerdings Pflicht.

Rechnungsnummer, die im Riverty-Portal angezeigt wird. Eine Bestellung kann mehrere Rechnungen enthalten.

RefundType

"order": {"items[i]": {"type": "Refund" }}

"order": {"items[i]": {"type": "Return" }}

enum

O

Art der Gutschrift: Mögliche Werte sind „Refund“ und „Return“

Wird nur bei einer kompletten Gutschrift benötigt.

Parameter für Gutschrift von Riverty-Zahlungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

PARAMETER RefNr_REST AS ABOVE

KeyRESTFormatCNDDescription

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PARAMETER CodeExt_REST AS ABOVE

KeyFormatCNDDescription

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Gutschrift von Riverty-Zahlungen

Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Transaktion bei Riverty zu stornieren, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.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:

KeyRESTFormatCNDDescription

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die zu stornierende Zahlung

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

ReqId

"requestId": "..."

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Order

"order": JSON

ans..1024

C

Pflicht bei Teilstornierungen

Bestellinformationen als JSON-String im Format Base64.

Siehe JSON-Objekt: Order

Parameter für Storno von Riverty-Zahlungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyRESTFormatCNDDescription

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"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

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PARAMETER CodeExt_REST AS ABOVE

KeyFormatCNDDescription

ErrorText

"payment": {"rivertyErrorText": "..."}

ans..1024

O

Fehlertext von Riverty, wenn mit Computop Helpdesk abgesprochen

Parameter für Storno von Riverty-Zahlungen

Batch-Nutzung der Schnittstelle

Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Riverty-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Hinweis: Beachten Sie bitte, dass keine Teil-Stornierungen, -Buchungen oder -Gutschriften über Batch für Riverty möglich sind.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Action

Version

Beschreibung

Capture

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Credit

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Reverse

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Riverty-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

1
HEAD,<MerchantID>,<Date>,<Version>
2
AFTERPAY,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
3
AFTERPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
4
AFTERPAY,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
5
FOOT,<CountRecords>,<SumAmount>

Beispiel für Master-MID-Funktion:

1
HEAD,[Master]MerchantID,Date,2.x
2
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
3
FOOT,CountRecords,SumAmount

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

KeyFormatCNDDescription

Type

a..11

M

HEAD für Header, FOOT für Footer, AFTERPAY für Riverty

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

TransID

ans..18

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ns..30

O

Eindeutige Referenznummer des Händlers

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

1
HEAD,<MerchantID>,<Date>,<Version>
2
AFTERPAY,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
3
AFTERPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
4
AFTERPAY,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
5
FOOT,<CountRecords>,<SumAmount>

Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):

KeyFormatCNDDescription

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

JSON-Objekte

Die JavaScript Object Notation, kurz JSON, ist ein kompaktes Datenformat in einer einfach lesbaren Textform zum Zweck des Datenaustauschs zwischen Anwendungen. JSON ist unabhängig von der Programmiersprache. Parser existieren in praktisch allen verbreiteten Sprachen. Einige Informationen über JSON sind unter diesem Link zu finden:

https://wiki.selfhtml.org/wiki/JavaScript/JSON

Im Folgenden werden die JSON-Objekte beschrieben, die für Requests benötigt oder aber in der Response zurückgeliefert werden.

Notice: Da der JSON-String Sonderzeichen enthalten kann, muss er zusätzlich Base64-codiert werden. Anderenfalls kann es zu Problemen bei der Übertragung kommen.

CustomerRisk

Risikorelevante Daten zum Kunden. Händler können externe Risikoprüfungen durchführen und Riverty diese Informationen zusenden.

KeyFormatCNDDescription

existingCustomer

bool

O

Gibt an, ob der Kunde ein für den Händler bereits existierender Kunde ist

verifiedCustomerIdentification

bool

O

Gibt an, ob der Kunde verifiziert wurde

marketingOptIn

bool

O

Gibt an, ob Marketing-Material erwünscht ist

customerSince

dttm

O

Datum, seit dem der Kunde existiert im Format JJJJ-MM-TT

customerClassification

ans..32

O

Kundenklassifizierung

acquisitionChannel

enum

O

Gibt den genutzten Kanal an, um auf die Händlerseite zu gelangen. Mögliche Werte: „NotSet“, „Advertisment“, „SocialNetwork“, „Direct“, „SearchEngine“, “Other”

hasCustomerCard

bool

O

Gibt an, ob der Kunde eine Kundenkarte besitzt

customerCardSince

dttm

O

Datum, seit dem eine Kundenkarte existiert im Format JJJJ-MM-TT

customerCardClassification

ans..32

O

Gibt den Level der Kundenkarte an, z.B. „Gold Member“

profileTrackingId

ans..64

O

Eindeutige TrackingID

ipAddress

ans..15

M

IP-Adresse des Kunden

numberOfTransactions

n..5

O

Anzahl der erfolgreichen Transaktionen, die der Kunden bereits getätigt hat

customerIndividualScore

n..5

O

Vom Händler zur Verfügung gestellter individueller Score für den Kunden

userAgent

ans..32

O

UserAgent dieses bestimmten Kunden

amountOfTransactions

n..5

O

Betrag der bezahlten Bestellungen in den letzten 12 Monaten

otherPaymentMethods

bool

O

Andere Zahlungsmethode außer MI im Wallet

Beispiel CustomerRisk als JSON-String

1
{
2
"existingCustomer" : true,
3
"verifiedCustomerIdentification" : "true",
4
"marketingOptIn" : "false",
5
"customerSince" : "2015-11-20",
6
"customerClassification" : "Classification",
7
"acquisitionChannel" : “SearchEngine”,
8
"hasCustomerCard" : true,
9
"customerCardSince" : "2016-01-23",
10
"customerCardClassification" : "Gold Member",
11
"profileTrackingId" : "TrackingID123456",
12
"ipAddress" : "201.18.14.2",
13
"numberOfTransactions" : 27,
14
"customerIndividualScore" : 98,
15
"userAgent" : "",
16
"amountOfTransactions" : 1,
17
"otherPaymentMethods" : true
18
}

Order

Hier werden die Informationen zu einer Bestellung definiert.

KeyFormatCNDDescription

totalGrossAmount

ans..16

M

Bruttobetrag der Bestellung. Muss gleich dem Wert aller Artikel aus items (grossUnitPrice * quantity) sein.

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

currency

enum

O

Währung: Mögliche Werte sind „EUR“, „NOK“, „SEK“, „DKK“, „CHF“

risk

ans..1024

O

Risikorelevante Daten der Bestellung als JSON-String im Base64 (siehe JSON-Objekt: OrderRisk)

items

array

M

Array von OrderItems (siehe JSON-Objekt: OrderItem)

totalNetAmount

ans..16

M

Nettobetrag der Bestellung

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

imageUrl

ans..256

O

URL für ein Bild zur Bestellung. Dieses Bild kann auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal gesehen werden. Beschränkt auf 100-1280px.

OrderRisk

Hier werden die Informationen zum Risiko der Bestellung definiert.

KeyFormatCNDDescription

channelType

ans..64

O

Kanal der Bestellung. Mögliche Werte:

"Internet", "Catalog", "CallCenter", "Stationary", "Other".

deliveryType

ans..64

O

Typ der Lieferung. Mögliche Werte:

"Normal", "Express".

ticketDeliveryMethod

ans..64

O

Name der Ticket-Methode. Mögliche Werte:

"NotSet", "PickUp", "Email", "Post", "Phone".

OrderItem

Hier werden die Informationen zu einem Artikel definiert.

KeyFormatCNDDescription

productId

ans..64

M

Artikelnummer

description

ans..128

M

Artikelbeschreibung

type

ans..64

O

Typ des Artikels. Mögliche Werte:

"PhysicalArticle", "DigitalArticle", "GiftCard", "Discount", "ShippingFee", "Surcharge", "Info"

quantity

n..8

M

Artikelanzahl.

Dezimalwerte, wenn mit Computop und Riverty abgesprochen.

grossUnitPrice

ans..16

M

Bruttopreis pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

groupId

ans..64

O

GruppenID

netUnitPrice

ans..16

M

Nettopreis pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

unitCode

ans..16

O

Einheit (z.B. Stück, Liter, Kilogramm, etc.)

vatCategory

enum

O

Umsatzsteuerkategorie

Mögliche Werte: "HighCategory", "LowCategory", "NullCategory", "NoCategory", "MiddleCategory", "OtherCategory"

vatPercent

n..2

M

Umsatzsteuer in Prozent

vatAmount

ans..16

M

Umsatzsteuer als Betrag pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

imageUrl

ans..256

O

URL für ein Bild zur Bestellung. Dieses Bild kann auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal gesehen werden. Beschränkt auf 100-1280px.

googleProductCategoryId

n..16

O

Google Product Category ID

googleProductCategory

ans..64

O

Google Product Category

merchantProductType

ans..64

O

Kategorisierung des Händlers ergänzend zur Google-Klassifizierung

lineNumber

n..3

O

Der Händler kann eine Zeilennummer für jeden Artikel angeben, um die Artikel zu sortieren

discountAmount

ans..16

O

Rabattbetrag (nur für statistische Zwecke)

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

productUrl

ans..256

O

URL zum Artikel

marketPlaceSellerId

ans..64

O

ID eines bestimmten Marktplatzes

Beispiel Order als JSON-String

1
{
2
"totalGrossAmount" : 12.40,
3
"totalNetAmount" : 10.43,
4
"currency" : "EUR",
5
"risk" : {
6
"channelType" : "Catalog",
7
"deliveryType" : "Normal",
8
"ticketDeliveryMethod" : "NotSet"
9
},
10
"items" : [{
11
"productId" : "1",
12
"description" : "Tablet Black",
13
"type" : "PhysicalArticle",
14
"grossUnitPrice" : 4.10,
15
"netUnitPrice" : 3.45,
16
"quantity" : 2.0,
17
"vatAmount" : 0.65,
18
"vatPercent" : 19.0
19
}, {
20
"productId" : "2",
21
"description" : "MusicPlayer Black",
22
"type" : "PhysicalArticle",
23
"grossUnitPrice" : 4.20,
24
"netUnitPrice" : 3.53,
25
"quantity" : 1.0,
26
"vatAmount" : 0.67,
27
"vatPercent" : 19.0
28
}
29
]
30
}

AllowedPayMethods

Hier werden die Informationen zu den erlaubten Zahlungsarten in einem Array definiert.

PaymentMethod

Hier werden die Informationen zu einem Artikel definiert.

KeyFormatCNDDescription

type

ans..32

O

Verfügbare Zahlungsart

Mögliche Werte: "Invoice", "Account", "Installment", "Consolidatedinvoice"

account

AccountProduct

O

Account-Informationen (siehe JSON-Objekt: AccountProduct)

directDebit

DirectDebitInfo

O

Direct-Debit-Informationen (siehe JSON-Objekt: DirectDebitInfo)

campaigns

Array

O

Array von Kampagnen-Informationen (siehe JSON-Objekt: CampaignInfo)

Installment

InstallmentInfo

O

Ratenkauf-Informationen (siehe JSON-Objekt: InstallmentInfo)

legalInfo

legalInfo

O

Legal info containing Terms and Conditions, Privacy statement, etc. (see JSON object: LegalInfo)

AccountProduct

Hier werden die Informationen zu einem AccountProduct definiert.

KeyFormatCNDDescription

profileNo

n..32

M

Account-Profilnummer

DirectDebitInfo

Hier werden die Informationen zu DirectDebitInfo definiert.

KeyFormatCNDDescription

Available

bool

O

Gibt an, ob DirectDebit verfügbar ist

CampaignInfo

Hier werden die Informationen zu CampaignInfo definiert.

KeyFormatCNDDescription

campaignNo

n..32

O

Kampagnennummer

description

ans..128

O

Kampagnenbeschreibung

InstallmentInfo

Hier werden die Informationen zu InstallmentInfo definiert.

KeyFormatCNDDescription

basketAmount

enum

O

Verfügbare Zahlungsart

Mögliche Werte: "Invoice", "Account", "Installment", "Consolidatedinvoice"

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

numberOfInstallments

n..2

O

Anzahl der Raten

installmentAmount

ans..16

O

Ratenbetrag für jeden Monat

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

firstInstallmentAmount

ans..16

O

Erster Ratenbetrag

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

lastInstallmentAmount

ans..16

O

Letzter Ratenbetrag

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

interestRate

ans..16

O

Zinssatz

effectiveInterestRate

ans..16

O

Effektiver Zinssatz

effectiveAnnualPercentageRate

ans..16

O

Effektiver jährlicher Prozentsatz

totalInterestAmount

ans..16

O

Gesamtzinssatz

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

startupFee

ans..16

O

Anfangsgebühr

monthlyFee

ans..16

O

Monatliche Gebühr

totalAmount

ans..16

O

Gesamtbetrag

installmentProfileNumber

ans..16

O

Raten Profilnummer

readMore

ans..128

O

Weitere Informationen zum Ratenprozess

LegalInfo (nicht auf DE Seite vorhanden)

The LegalInfo information is defined here.

KeyFormatCNDDescription

requiresCustomerConsent

bool

O

"true", if customer consent is required

termsAndConditionsUrl

ans..250

O

URL to Terms and Conditions

privacyStatementUrl

ans..250

O

URL to Privacy Statement

bgb507Url

ans..250

O

URL to § 507 BGB

text

ans..2500

O

Legal text

Beispiel AllowedPaymentMethods als JSON-String

1
"paymentMethods": [{
2
"type": "string",
3
"title": "string",
4
"tag": "string",
5
"consumerFeeAmount": 1.00,
6
"logo": "string",
7
"account": { ... } ,
8
"directDebit": {"available": true},
9
"campaigns": { ... },
10
"installment": {
11
"basketAmount": 1.00,
12
"numberOfInstallments": 1,
13
"installmentAmount": 1.00,
14
"firstInstallmentAmount": 1.00,
15
"lastInstallmentAmount": 1.00,
16
"interestRate": 1.00,
17
"effectiveInterestRate": 1.00,
18
"effectiveAnnualPercentageRate": 1.00,
19
"totalInterestAmount": 1.00,
20
"startupFee": 1.00,
21
"monthlyFee": 1.00,
22
"totalAmount": 1.00,
23
"installmentProfileNumber": 1,
24
"readMore": "string"
25
},
26
"legalInfo": {
27
"requiresCustomerConsent": true,
28
"termsAndConditionsUrl": "string",
29
"privacyStatementUrl": "string",
30
"bgb507Url": "string",
31
"text": "string"
32
},
33
}]

Address

Hier werden die Informationen zu ggfls. korrigierten Rechnungsdaten in einem Array definiert.

KeyFormatCNDDescription

countryCode

enum

M

Ländercode

Mögliche Werte: "NO“, „SE“, „FI“, „DK“, „DE“, „AT“, „CH“, „NL“, „BE“

postalCode

ans..10

M

Postleitzahl

postalPlace

ans..100

M

Ort

Street

ans..100

M

Straße oder Packstation

streetNumber

ans..10

M

Haus- oder Packstationsnummer

streetNumberAdditional

ans..10

O

Hausnummernzusatz

careOf

ans..50

O

Verantwortlicher für den Versand der Sendung

Beispiel Address als JSON-String

1
{
2
[{
3
"countryCode" : "DE",
4
"postalCode" : "10405",
5
"street" : "Prenzlauer Allee",
6
"streetNumber" : 20
7
"streetNumberAdditional" : "3. Stock",
8
"postalPlace" : "Berlin",
9
"addressType" : null,
10
"careOf" : null
11
}
12
]
13
}

OrderSummary

Hier werden die Informationen zu einer OrderSummary definiert.

KeyFormatCNDDescription

totalGrossAmount

ans..16

O

Bruttobetrag der Bestellung. Muss gleich dem Wert aller Artikel aus items (grossUnitPrice * quantity) sein.

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

currency

enum

O

Währung. Mögliche Werte sind „EUR“, „NOK“, „SEK“, „DKK“, „CHF“

items

Array

O

Array von OrderItems (siehe JSON-Objekt: OrderItem)

totalNetAmount

ans..16

O

Nettobetrag der Bestellung

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

imageUrl

ans..256

O

URL für ein Bild zur Bestellung. Dieses Bild kann auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal gesehen werden. Beschränkt auf 100-1280px.

googleAnalyticsUserId

ans..64

O

Google Analytics UserID

googleAnalyticsClientId

ans..64

O

Google Analytics ClientID

discountAmount

ans..16

O

Rabattbetrag (nur für statistische Zwecke)

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

Beispiel OrderSummary als JSON-String

1
{
2
"totalGrossAmount" : 8.30,
3
"currency" : "EUR",
4
"items" : [{
5
"productId" : "1",
6
"description" : "Tablet Black",
7
"grossUnitPrice" : 4.10,
8
"quantity" : 1.0
9
}, {
10
"productId" : "2",
11
"description" : "MusicPlayer Black",
12
"grossUnitPrice" : 4.20,
13
"quantity" : 1.0
14
}
15
]
16
}

ShippingData

Hier werden die Informationen zum Versand in einem Array definiert.

KeyFormatCNDDescription

shippingDetails

Array

M

Array von Versandinformationen (siehe JSON-Objekt: ShippingDetails)

ShippingDetails

Hier werden die Informationen zu ShippingDetails definiert.

KeyFormatCNDDescription

type

enum

M

Versandtyp: Mögliche Werte sind „Shipment“, „Return“

shippingCompany

ans..64

M

Versandunternehmen

trackingId

ans..64

M

Eindeutige TrackingID

Beispiel ShippingData als JSON-String

1
{
2
"shippingDetails" : [{
3
"type" : "Shipment",
4
"shippingCompany" : "DHL",
5
"trackingId" : "234324234"
6
}, {
7
"type" : "Shipment",
8
"shippingCompany" : "Hermes",
9
"trackingId" : "687654"
10
}
11
]
12
}

RefundOrder

Hier werden die Informationen zu den Artikeln definiert, die gutzuschreiben sind.

KeyFormatCNDDescription

orderItems

Array

M

Array von Artikeln zum Gutschreiben (siehe JSON-Objekt: RefundOrderItem)

RefundOrderItem

Hier werden die Informationen zu einem RefundOrderItem definiert.

KeyFormatCNDDescription

refundType

ans..32

C

Gutschriftstyp: Mögliche Werte sind „Refund“, „Return“

productId

ans..64

M

Artikelnummer

description

ans..128

M

Artikelbeschreibung

quantity

n..8

M

Artikelanzahl.

Dezimalwerte, wenn mit Computop und Riverty abgesprochen.

grossUnitPrice

ans..16

M

Bruttopreis pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

groupId

ans..64

O

GruppenID

netUnitPrice

ans..16

M

Nettopreis pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

unitCode

ans..16

O

Einheit (z.B. Stück, Liter, Kilogramm, etc.)

vatCategory

ans..32

O

Umsatzsteuerkategorie

Mögliche Werte: "HighCategory", "LowCategory", "NullCategory", "NoCategory", "MiddleCategory", "OtherCategory"

vatPercent

n..2

M

Umsatzsteuer in Prozent

vatAmount

ans..16

M

Umsatzsteuer als Betrag pro Artikel

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

imageUrl

ans..256

O

URL für ein Bild zur Bestellung. Dieses Bild kann auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal gesehen werden. Beschränkt auf 100-1280px.

googleProductCategoryId

n..16

O

Google Product Category ID

googleProductCategory

ans..64

O

Google Product Category

merchantProductType

ans..64

O

Kategorisierung des Händlers ergänzend zur Google-Klassifizierung

lineNumber

n..3

O

Der Händler kann eine Zeilennummer für jeden Artikel angeben, um die Artikel zu sortieren

discountAmount

ans..16

O

Rabattbetrag (nur für statistische Zwecke)

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen anzugeben sind.

productUrl

ans..256

O

URL zum Artikel

marketPlaceSellerId

ans..64

O

ID eines bestimmten Marktplatzes

Beispiel RefundOrder als JSON-String

1
[
2
{
3
refundType: 'Return',
4
productId: '1',
5
description: 'Tablet Black',
6
quantity: 1.0,
7
grossUnitPrice: 4.1,
8
netUnitPrice: 3.45,
9
vatPercent: 19.0,
10
vatAmount: 0.65,
11
},
12
{
13
refundType: 'Return',
14
productId: '2',
15
description: 'MusicPlayer Black',
16
quantity: 1.0,
17
grossUnitPrice: 4.2,
18
netUnitPrice: 3.53,
19
vatPercent: 19.0,
20
vatAmount: 0.67,
21
},
22
];

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status