Mobile Referenz zu den Parametern | Novalnet-Dokumentation

Integrationsoptionen Mobile Zahlungen / APP Referenz zu den Parametern

Referenz zu den Parametern

Die Novalnet-API ist um JSON-RPC herum organisiert. Unsere API hat vorhersagbare, ressourcen-orientierte URLs, akzeptiert Anfragen mit application/json als Inhalt, gibt in JSON codierte Rückmeldungen zurück und verwendet Standard-HTTP-Rückmeldungscodes und -authentifizierung.

Authentifizierung über den Header

Um sich bei Ihren Zahlungsaufrufen zu authentifizieren, verwenden Sie die Authentifizierung im nutzerdefinierten Header von Novalnet. Das nutzerdefinierte Header-Feld ist wie folgt aufgebaut:

Jeder Header eines Aufrufs wird unter Verwendung des Paymentzugriffsschlüssels erstellt. Um Ihren Paymentzugriffsschlüssel zu erhalten, loggen Sie sich in Ihr Novalnet Admin-Portal und folgen Sie dem Pfad Projekte -> [Gewünschtes Projekt auswählen] -> API-Anmeldeinformationen -> Paymentzugriffsschlüssel.
Der Paymentzugriffsschlüssel sollte mit einer Variante von Base64 codiert werden.
Der sich ergebenen mit Base64 codierte Wert sollte im benutzerdefinierten Schlüssel X-NN-Access-Key des Novalnet-Headers übergeben werden.

Das benutzerdefinierte Header-Feld wird im Format
X-NN-Access-Key:base64_encoded_value angegeben.

Alle Zahlungsaufrufe müssen über eine HTTPS-Verbindung mit den entsprechenden Werten im Header ausgeführt werden, andernfalls schlägt der Aufruf mit einer Fehlermeldung zur Autorisierung fehl.

Ihr Paymentzugriffsschlüssel beinhaltet viele Privilegien, also stellen Sie sicher, dass Sie diesen sicher aufbewahren! Teilen Sie Ihren geheimen Paymentzugriffsschlüssel nicht in öffentlich zugänglichen Bereichen wie GitHub, auf Kundenseite installiertem Code und so weiter.

Header des HTTP-Aufrufs

X-NN-Access-Key	`base64_encode({PAYMENT_ACCESS_KEY})`
Content-Type	application/json
Accept	application/json
Charset	utf-8

Endpunkt URL(s)

Verwenden Sie bitte die URLs unten je nach Ihrem Geschäftsprozess und Ihren Anforderungen:

Zahlung

Dieser Aufruf bucht sofort den gewünschten Betrag. Der Zahlungsaufruf an die API entspricht einer sofortigen Autorisierung mit Einzug.

URL des Endpunkts:

https://payport.novalnet.de/v2/seamless/payment

Autorisierung

Wie der Name andeutet, wird bei diesem Aufruf nur die grundlegende Autorisierung ausgeführt und nicht sofort der Betrag gebucht. Ein Zahlungsaufruf zum Einzug ist notwendig, um den autorisierten Betrag später einzuziehen.

URL des Endpunkts:

https://payport.novalnet.de/v2/seamless/authorize

<?php
// Need to enter your payment access key value here
$payment_access_key = '###YOUR_PAYMENT_ACCESS_KEY###';

// Now, have to encode the $payment_access_key value with the base64 encode
$encoded_data       = base64_encode($payment_access_key);

// Build the Headers array
$headers = [

// The Content-Type should be "application/json"
'Content-Type:application/json', 

// The charset should be "utf-8"
'Charset:utf-8', 

// Optional
'Accept:application/json', 

// The formed authenticate value (case-sensitive)
'X-NN-Access-Key:' . $encoded_data, 
];
?>

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

CURL

-H 'Content-Type: application/json'
-H 'Charset:utf-8'
-H 'Accept: application/json'
-H 'X-NN-Access-Key:###YOUR_ENCODED_PAYMENT_ACCESS_KEY###'

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

NODEJS

headers: {
		'Content-Type': 'application/json',
		'Content-Length': Buffer.byteLength(###POSTDATA###),
		'Charset': 'utf-8',
		'Accept': 'application/json',
		'X-NN-Access-Key': '###YOUR_ENCODED_PAYMENT_ACCESS_KEY###'
		},

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

PYTHON

HEADERS = {
'Content-Type': 'application/json',
'Charset': 'utf-8',
'Accept': 'application/json',
'X-NN-Access-Key': '###YOUR_ENCODED_PAYMENT_ACCESS_KEY###'
}

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

RUBY

request["Content-Type"] = "application/json"
request["Charset"] = "utf-8"
request["Accept"] = "application/json"
request["X-NN-Access-Key"] = "###YOUR_ENCODED_PAYMENT_ACCESS_KEY###"

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

req.Header.Add("Content-Type", "application/json")
req.Header.Add("Charset", "utf-8")
req.Header.Add("Accept", "application/json")
req.Header.Add("X-NN-Access-Key", "###YOUR_ENCODED_PAYMENT_ACCESS_KEY###")

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

JAVA

.header("Content-Type", "application/json")
.header("Charset", "utf-8")
.header("Accept", "application/json")
.header("X-NN-Access-Key", "###YOUR_ENCODED_PAYMENT_ACCESS_KEY###")

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

CSHARP

request.Headers.Add("Charset", "utf-8");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-NN-Access-Key", "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\"");

ERGEBNIS

HEADERS
[
    "Content-Type:application/json",
    "Charset:utf-8",
    "Accept:application/json",
    "X-NN-Access-Key:MTljYTE0ZTdlYTYzMjhhNDJlMGViMTNkNTg1ZTRjMjI="
]

Liste der Parameter

Jeder Zahlungsaufruf ist in sogenannte Objekte aufgeteilt, welche eine Einheit wie Informationen zum Händler, Endkunden, der Transaktion selbst etc. beinhalten. Verwenden Sie die Objekte, welche für Ihr Geschäftsmodell / Ihre Zahlungsart relevant sind.

Jeder Parameter ist mit Attributen versehen Pflichtfeld, Bedingungsabhängig, Freiwillig. Auf der Grundlage Ihrer Anforderungen können Sie diese Parameter entsprechend einsetzen.

- Das Icon gibt an, dass der Parameter auf der Grundlage einer Bedingung für das Attribut eingesetzt wird und wenn Sie den Mauszeiger über diesem Icon lassen, werden Ihnen Einzelheiten zu dieser Bedingung angezeigt.

- Das Icon zeigt die Zahlungsarten an, welche von dem definierten Parameter unterstützt werden oder für diesen relevant sind, und wenn Sie den Mauszeiger über diesem Icon lassen, werden Ihnen Einzelheiten zu der Liste der unterstützten Zahlungsarten angezeigt.

merchant
Objekt

Parameter	Beschreibung
signature String Pflichtfeld 7ibc7ob5\|tuJEH3gNbeWJfIHah\|\|nbobljbnmdli0poys\|doU3HJVoym7MQ44qf7cpn7pc	Die Signatur des Händlerprojekts ist notwendig, um eine Transaktion zu verarbeiten. Sie dient als privater Schlüssel, den Sie finden, wenn Sie sich in das Novalnet Admin-Portal einloggen und dann folgenden Pfad einschlagen: Projekte -> [Wählen Sie Ihr gewünschtes Projekt aus] -> API-Anmeldeinformationen -> API Signature (Aktivierungsschlüssel des Produkts)
tariff String Freiwillig 10004	Die ID des Tarifs kann gesetzt werden, um die Art der Währung und das Zahlungsmodell zu bestimmen, auf der Grundlage der Natur des Geschäfts. Sie können die Tarif-ID im Novalnet Admin-Portal finden, indem Sie den folgenden Weg nehmen: Projekte -> [Wählen Sie Ihr gewünschtes Projekt aus] -> API-Anmeldeinformationen -> Tarif-IDs (wählen Sie diejenige, welche Sie übergeben müssen)

customer
Objekt

Parameter

Beschreibung

gender
String
Freiwillig
u|m|f

Geschlecht des Kunden.

Folgende Werte sind erlaubt:

m für "männlich"
f für "weiblich"
u für "unbekannt"

first_name
String
Bedingungsabhängig
Max

Vorname des Kunden

last_name
String
Bedingungsabhängig
Mustermann

Nachname des Kunden

email
String
Bedingungsabhängig
test@novanet.de

E-Mail-Adresse auf der Rechnung des Kunden

billing
Objekt

In diesem Objekt müssen Sie die Rechnungsinformationen des Kunden angeben.
Unterobjekt verstecken

Parameter	Beschreibung
company String Freiwillig ABC GmbH	Name der Organisation
house_no String Bedingungsabhängig 2	Hausnummer des Endkunden
street String Bedingungsabhängig Musterstr	Straßenname des Endkunden Anmerkung: Der oben erwähnte Parameter house_no kann auch zusammen mit dem Parameter street übergeben werden, indem Sie eines der folgenden Trennzeichen verwenden: "/", "-", ".", "," bzw. ein Leerzeichen verwenden.
city String Bedingungsabhängig Musterhausen	Stadt des Endkunden
zip String Bedingungsabhängig 12345	Postleitzahl des Endkunden Anmerkung: Falls es keine Postleitzahl gibt, verwenden Sie bitte ‘-’ als statischen Wert.
country_code String Bedingungsabhängig DE	Ländercode des Endkunden mit 2 Buchstaben, s. auch: ISO-3166-1 alpha-2.
state String Bedingungsabhängig Berlin	Das Bundesland in der Rechnungsadresse des Kunden bezieht sich auf eine bestimmte Region innerhalb eines Landes. Novalnet unterstützt diesen Parameter momentan in 3 Formaten: ISO 3166-2 State Codes (Codes für Bundesländer) : Sie geben das Bundesland an, indem Sie den Code für das Bundesland gemäß dem ISO 3166-2-Standard verwenden, um eine reibungslose Übertragung während der Verarbeitung der Zahlung durchzuführen. So sind Codes für Bundesländer, wie z.B. “BE” für Berlin, üblicherweise 2 Zeichen lang. Format des Ländercodes: Das Format für den Code des Bundeslandes innerhalb des Ländercodes ist für Deutschland “DE-“ gefolgt von dem Code für das Bundesland mit 2 Zeichen, z.B. „DE-BE“ für Berlin, „DE-HH“ für Hamburg. Vollständige Namen der Bundesländer : Die vollständigen Namen der Bundesländer können angegeben werden, indem eine Zeichenkette mit einer maximalen Länge von 50 Zeichen verwendet wird, z.B. „Berlin“, „Hamburg“. Anmerkung: Zulässige Zeichen sind alphanumerische ASCII-Zeichen, Leerzeichen, Bindestriche, Apostrophe und weitere Zeichen wie Umlaute innerhalb eines Latin-Zeichensatzes.
district String Bedingungsabhängig Pankow	Der Landkreis des Kunden aus der Rechnungsadresse bezieht sich auf einen bestimmten Verwaltungsbereich innerhalb eines Bundeslandes oder einer Provinz. Anmerkung: Zulässige Zeichen sind alphanumerische ASCII-Zeichen, Leerzeichen, Bindestriche, Apostrophe und weitere Zeichen wie Umlaute innerhalb eines Latin-Zeichensatzes.

customer_ip
String
Bedingungsabhängig
127.0.0.1

IP-Adresse des Kunden. Wir empfehlen Ihnen, dieses Detail zu übermitteln, da es in Betrugsprüfungen verwendet wird (zum Beispiel: IP BIN-Check, IP-Blockade etc.)

customer_no
String
Freiwillig
12345

Der eindeutige Identifikator des Kunden aus dem Shop. Die maximale Länge dieses Parameters beträgt 20 Zeichen. Wenn Sie mehr als 20 Zeichen für die Bearbeitung oder Übermittlung von Kundennummern benötigen, verwenden Sie bitte die unten aufgeführten benutzerdefinierten Objekte über die Parameter input1..7 und inputval1..7. Die Verwendung des benutzerdefinierten Objekts transmission dient ausschließlich der Erleichterung des Austauschs von Kundennummern. Bitte beachten Sie, dass diese Option Novalnet nicht erlaubt, die Kundennummer intern zuzuordnen.

Anmerkung: Wenn Sie bereits eine erfolgreiche Transaktion mit derselben Kundennummer durchgeführt haben, brauchen Sie die obligatorischen Felder für die Rechnungsstellung nicht zu senden, die Übergabe der Kundennummer reicht aus. Weitere Einzelheiten finden Sie in diesem Übersetzt mit DeepL.com (kostenlose Version) Rubrik.

birth_date
String
Freiwillig
1992-06-10

Geburtsdatum des Endkunden. Das Format, das verwendet werden soll, ist "JJJJ-MM-TT"

Anmerkung: Nur Pflicht für B2C (Privatkunden) um Zahlungen mit Zahlungsgarantie und Ratenzahlungen zu verarbeiten, wie z.B. GUARANTEED_DIRECT_DEBIT_SEPA, GUARANTEED_INVOICE, INSTALMENT_DIRECT_DEBIT_SEPA, INSTALMENT_INVOICE

tel
String
Freiwillig
+49 089 123456

Telefonnummer des Kunden

mobile
String
Freiwillig
+491747781423

Mobiltelefonnummer des Kunden

fax
String
Freiwillig
+49 89 654321

Faxnummer des Kunden

shipping
Objekt

In diesem Objekt müssen Sie die Lieferinformationen des Kunden angeben.
Unterobjekt verstecken

Parameter	Beschreibung
same_as_billing Integer Freiwillig 1	Übergeben Sie diesen Parameter, wenn die Rechnungs- und die Lieferadresse identisch sind. Beachten Sie auch, dass das gesamte shipping Unter-Objekt optional ist.
first_name String Freiwillig Max	Vorname in der Lieferadresse des Kunden
last_name String Freiwillig Mustermann	Nachname in der Lieferadresse des Kunden
email String Freiwillig test@novanet.de	E-Mail-Adresse zu der Lieferadresse des Kunden
company String Freiwillig ABC GmbH	Name der Organisation in der Lieferadresse
house_no String Freiwillig 2	Hausnummer in der Lieferadresse des Endkunden
street String Freiwillig Musterstr	Straßenname in der Lieferadresse des Endkunden Anmerkung: Der oben erwähnte Parameter house_no kann auch zusammen mit dem Parameter street übergeben werden, indem Sie eines der folgenden Trennzeichen verwenden: "/", "-", ".", ","
city String Freiwillig Musterhausen	Stadt in der Lieferadresse des Endkunden
zip String Freiwillig 12345	Postleitzahl in der Lieferadresse des Endkunden Anmerkung: Falls es keine Postleitzahl gibt, verwenden Sie bitte ‘-’ als statischen Wert.
country_code String Freiwillig DE	Land in der Lieferadresse des Endkunden. ISO-Ländercode mit 2 Buchstaben, wie definiert unter: ISO-3166-1 alpha-2
tel String Freiwillig +49 089 123456	Telefonnummer in der Lieferadresse des Kunden
mobile String Freiwillig +491747781423	Mobiltelefonnummer in der Lieferadresse des Kunden
state String Freiwillig Berlin	Das Bundesland in der Lieferadresse des Kunden bezieht sich auf eine bestimmte Region innerhalb eines Landes. Novalnet unterstützt diesen Parameter momentan in 3 Formaten: ISO 3166-2 State Codes (Codes für Bundesländer) : Sie geben das Bundesland an, indem Sie den Code für das Bundesland gemäß dem ISO 3166-2-Standard verwenden, um eine reibungslose Übertragung während der Verarbeitung der Zahlung durchzuführen. So sind Codes für Bundesländer, wie z.B. “BE” für Berlin, üblicherweise 2 Zeichen lang. Format des Ländercodes: Das Format für den Code des Bundeslandes innerhalb des Ländercodes ist für Deutschland “DE-“ gefolgt von dem Code für das Bundesland mit 2 Zeichen, z.B. „DE-BE“ für Berlin, „DE-HH“ für Hamburg. Vollständige Namen der Bundesländer: Die vollständigen Namen der Bundesländer können angegeben werden, indem eine Zeichenkette mit einer maximalen Länge von 50 Zeichen verwendet wird, z.B. „Berlin“, „Hamburg“. Anmerkung: Zulässige Zeichen sind alphanumerische ASCII-Zeichen, Leerzeichen, Bindestriche, Apostrophe und weitere Zeichen wie Umlaute innerhalb eines Latin-Zeichensatzes.
district String Freiwillig Pankow	Der Landkreis des Kunden aus der Lieferadresse bezieht sich auf einen bestimmten Verwaltungsbereich innerhalb eines Bundeslandes oder einer Provinz. Anmerkung: Zulässige Zeichen sind alphanumerische ASCII-Zeichen, Leerzeichen, Bindestriche, Apostrophe und weitere Zeichen wie Umlaute innerhalb eines Latin-Zeichensatzes.

vat_id
String
Freiwillig
DE123456

Umsatzsteuer-Nr. der Organisation

tax_id
String
Freiwillig
123/123/123

Dieser Parameter stellt die eindeutige Umsatzsteueridentifikationsnummer dar, welche einem Kunden oder einem Unternehmen zugewiesen ist. Dies ist notwendig für die Einhaltung von Steuervorschriften und ermöglicht eine genaue Identifizierung von Unternehmen im Rahmen von B2B-Transaktionen.

Anmerkung: Zulässige Zeichen sind alphanumerische ASCII-Zeichen, Leerzeichen, Bindestriche sowie Punkte.

reg_no
String
Freiwillig
HRB1234

Handelsregister-Nr. der Organisation

session
String
Bedingungsabhängig
fedgrgst5653653hdgfsvgdsf622627e

Session-ID des Kunden aus dem Shop

Anmerkung: Die Betrugsprüfung Session-Check funktioniert auf der Grundlage der Eingabe dieses Parameters.

no_nc
Integer
Freiwillig
1

Wenn Sie diesen Parameter mit dem Wert 1 übergeben, ermöglicht Ihnen dies, nicht die Pflichtparameter wie first_name, last_name, street, city, zip, country_code zu übermitteln. Entweder die E-Mail-Adresse des Endkunden oder die Mobiltelefonnummer ist ausreichend, um eine Transaktion durchzuführen.

Anmerkung: Aus juristischen / Sicherheitsgründen kann diese Option nur zugelassen werden, nachdem die Einhaltung der Vorschriften für jedes Projekt durch das Novalnet Compliance-Team. überprüft wurde.

transaction
Objekt

Parameter

Beschreibung

test_mode
Integer
Pflichtfeld
0

Gibt den Verarbeitungsmodus der Transaktion an.

Mögliche Werte:

0, wenn "Die Transaktion ist im LIVE-Modus."
1 wenn "Die Transaktion ist im TEST-Modus und kein echter Geldfluss geschieht hier. "

payment_type
String
Freiwillig
CREDITCARD

Bei Novalnet definierte Zahlungsarten. Sehen Sie dazu diesen Abschnitt zu den verfügbaren Zahlungsarten.

amount
Integer
Bedingungsabhängig
522

Der Gesamtbetrag, welcher dem Kunden belastet wird, umfasst die Einzelposten, Steuern, Versandkosten und zusätzliche Kosten (in der kleinsten Währungseinheit), z.B. Euro in Eurocent (5,22 € = 522).

tax_amount
Integer
Freiwillig
23

Der Betrag der Steuer, welche im Transaktionsbetrag insgesamt enthalten ist, der im Parameter transaction.amount definiert wird. So wird zum Beispiel auf dem südkoreanischen Markt standardmäßig eine Mehrwertsteuer auf alle Käufe berechnet und wenn Sie eine Steuerbefreiung für Sonderfälle kennzeichnen wollen, z.B. für zollfreie Läden, setzen Sie tax_amount auf 0, sodass der erstellte Kaufbeleg von der Steuer ausgenommen ist.

currency
String
Freiwillig
EUR

Währung, in welcher die Transaktion abgewickelt wird. Der Währungscode aus 3 Buchstaben ist definiert in ISO-4217.

return_url
String
Bedingungsabhängig
https://www.demoshop.de/success

Der URL für die Rückkehr zum Shop an welchen der Kunde bei einer erfolgreichen Transaktion umgeleitet werden soll. Wenn dieser Wert nicht übergeben wird, bleibt der Kunde auf der Standard-Erfolgsseite der gehosteten Zahlungsseite bei Novalnet.

error_return_url
String
Bedingungsabhängig
https://www.demoshop.de/failure

Der URL für die Rückkehr zum Shop an welchen der Kunde bei einer erfolgreichen Transaktion umgeleitet werden soll. Wenn dieser Wert nicht übergeben wird, bleibt der Kunde auf der Seite für die Auswahl der Zahlungsart der gehosteten Zahlungsseite bei Novalnet.

order_no
String
Bedingungsabhängig
123456789

Eindeutiger Bezeichner für diese Bestellung aus dem Shop. Die maximale Länge für diesen Parameter sind 50 Zeichen. Falls Sie mehr als 50 Zeichen übermitteln wollen, dann verwenden Sie bitte das unten angegebene, benutzerdefinierte Objekt mit dem Parametern input1..7 und inputval1..7.

invoice_ref
String
Freiwillig
BNR-14-213257

Rechnungsnummer, welche zur Bestellung Ihres Kunden gehört. Die maximale Länge dieses Parameters ist 50 Zeichen. Falls Sie mehr als 50 Zeichen übergeben wollen, dann verwenden Sie bitte das unten angegebene, benutzerdefinierte Objekt mit den Parametern input1..7 and inputval1..7

create_token
Integer
Freiwillig
1

Wenn dieser Parameter auf 1 gesetzt ist und zusammen mit einer Kundennummer (customer.customer_no) übergeben wird, dann werden die Zahlungsdaten des Kunden als Token für zukünftige Käufe gespeichert. Erfahren Sie mehr über Tokenisierung hier.

marker
String
Freiwillig
DEF20140103987

Ein eindeutiger Bezeichner, der innerhalb der APIs dazu verwendet wird, bestimmte Transaktionen über Endkunden bzw. Projekte hinweg zu gruppieren, für eine statistische Übersicht oder ein Filtern der Daten für Berichte. Wenn Sie zum Beispiel, die Transaktionen, die im Shop mit einem bestimmten Angebot durchgeführt wurden, separat gruppieren müssen, dann kann Ihnen die Übermittlung dieses Parameters mit einem Wert wie ‚FESTIVALOFFER‘ ermöglichen, speziell diese Transaktionen aufzulisten.

payment_data
Objekt

In diesem Object müssen Sie die Zahlungsdaten des Kunden angeben.
Unterobjekt verstecken

hook_url
String
Bedingungsabhängig
https://www.demoshop.de/webhook

URL für Benachrichtigungen / den Webhook, um die Information zu den Benachrichtigungen für die Ereignisse zu erhalten, die bei jeder Transaktion auftreten. Um mehr über die Benachrichtigungen und Ereignisse zu erfahren, sehen Sie sich bitte diesen Abschnitt an: Asynchrone Benachrichtigungen.

verify_payment_data
Integer
Freiwillig
1

Damit können Sie überprüfen, ob es für die Zahlungsdaten des Kunden schon vorher eine erfolgreiche Buchung gab und entsprechend über den Status der Zahlung entscheiden, anhand des Werts, der in diesem Parameter übergeben wird.

Einer der folgenden Werte muss im Parameter transaction.verify_payment_data übergeben werden, damit eine Entscheidung getroffen werden kann, falls die Zahlungsdaten schon verwendet wurden:

1 für "Ergebnis verarbeiten, wie es ist"
2 für "Transaktion aussetzen (hier wird nur die Autorisierung durchgeführt) und dann später einen Aufruf ausführen "
3 für "Transaktion ablehnen"

Sehen Sie sich den Abschnitt Zahlungsdaten überprüfen an, um mehr Details über die Verarbeitung zu erfahren.

due_dates
Objekt
Freiwillig
{"INVOICE":"2024-12-29","PREPAYMENT":"2021-08-16","DIRECT_DEBIT_SEPA":"2024-12-29","CASHPAYMENT":"2024-12-29"}

Für Überweisungen: Datum, an welchen der Kunde die Zahlung beglichen haben muss.
Für SEPA-Lastschrift:Datum, an welchem der Kunde bei seiner Bank belastet werden soll. Falls dieses Datum leer ist, wird Novalnet den Endkunden innerhalb von drei Arbeitstagen belasten.

2 - 14 für SEPA-Lastschrift
>7 für Rechnung und Vorkasse
>0 für Barzahlen

Anmerkung: Das Format, in welchem das Datum angegeben werden muss, ist: "JJJJ-MM-TT".

mandate_ref
String
Freiwillig
NN-12345678901234567

Eindeutige Mandatsreferenz des schriftlichen SEPA-Mandats. Diese Referenz wird im Kontoauszug des Endkunden angezeigt. Falls sie nicht angegeben wurden, wird standardmäßig die TID verwendet.

mandate_date
String
Freiwillig
2024-12-15

Anfangsdatum, an welchem der Endkunde Novalnet bzw. dem Händler erlaubte, von seinem / ihrem Konto abzubuchen. Unterschriftsdatum des SEPA-Mandats. Wird dieses Datum nicht angegeben, wird standardmäßig das Transaktionsdatum bzw. das Anfangs-/Referenzdatum des Abonnements eingesetzt.

Anmerkung: Das anzugebende Format ist: "JJJJ-MM-TT".

enforce_3d
Integer
Freiwillig
1

Wenn Sie die SCA-Authentifizierung für Kredit-/Debitkarten einsetzen wollen, verwenden Sie diesen Parameter.
Folgende Werte sind erlaubt:

1 für "Durchführung der Transaktion mit SCA-Authentifizierung"

Anmerkung: Standardmäßig führen wir die SCA-Authentifizierung für Kredit-/Debitkarten aus (Karten innerhalb des europäischen Raums).

dynamic_descriptor
String
Freiwillig
www.yourshop.com

Der dynamische Deskriptor definiert den Text, der auf dem Zahlungsnachweis des Konsumenten angezeigt wird (z.B. Kontoauszug oder ähnliches).

Anmerkung: Dieser Wert kann maximal 20 Zeichen lang sein. Längere Werte werden abgeschnitten, und der Wert darf keine Umlaute Sonderzeichen (wie < > * `") oder Leerzeichen enthalten.

invoice_no
String
Freiwillig
852963

Eindeutiger Bezeichner, invoice number (Rechnungsnummer) aus dem Shop

transfer_type
String
Freiwillig
DEBIT

Geben Sie den Überweisungstyp an: CREDIT oder DEBIT.

CREDIT – wird dem Marktplatz belastet und dem Affiliate oder Unter-Händler gutgeschrieben.
DEBIT – wird dem Affiliate oder Unter-Händler belastet und dem Marktplatz gutgeschrieben.

Standardmäßig, falls dieser Parameter nicht übergeben wird, ist der Überweisungstyp DEBIT

debit_reason_1..5
String
Freiwillig
www.test.com

Der Verwendungszweck der Abbuchung bestimmt den Text auf dem Zahlungsnachweis des Kunden (z.B. ein Kontoauszug oder ähnliches).

Anmerkung: Jedes Feld des Verwendungszwecks der Abbuchung, kann maximal 27 Zeichen umfassen, mit einer Gesamtlänge von 140 Zeichen für den gesamten Verwendungszweck. Beim Verwendungszweck wird zwischen Groß- und Kleinschreibung unterschieden, wobei Zeichen von a bis z, A bis Z und 0 bis 9 erlaubt sind. Ansonsten sind nur Leerzeichen und Bindestriche erlaubt, während andere Sonderzeichen und Symbole durch Leerzeichen ersetzt werden.

hosted_page
Objekt

Parameter	Beschreibung
logo String Freiwillig https://developer.novalnet.de/docs/your-shop-logo.png	Der absolute URL des Logos, welches auf der gehosteten Zahlungsseite angezeigt werden soll
css_url String Freiwillig https://www.demoshop.de/custom.css	Absoluter URL des CSS-Stylesheets, um den Stil der gehosteten Zahlungsseite anzupassen.
display_payments Array Freiwillig ['CREDITCARD', 'DIRECT_DEBIT_SEPA', 'PREPAYMENT', 'IDEAL']	Zahlungsarten, welche auf der gehosteten Zahlungsseite angezeigt werden sollen. Anmerkung: *(i)* Falls Sie auch hosted_page.hide_payments zusammen mit diesem Parameter übermitteln, wird dem Parameter hosted_page.display_payments der Vorzug gegeben. Beide Parameter widersprechen sich und nur einer davon wird bei der folgenden Verarbeitung angewendet. *(ii)* Wenn Sie nur die Zahlungsart anzeigen wollen, welche in dem Parameter transaction.payment_type übergeben wurde, dann setzen Sie dieselbe Zahlungsart hier.
hide_payments Array Freiwillig ['CREDITCARD', 'DIRECT_DEBIT_SEPA', 'PREPAYMENT', 'IDEAL']	Zahlungsarten, welche auf der gehosteten Zahlungsseite versteckt werden sollen. Anmerkung: *(i)* Falls Sie auch hosted_page.hide_payments zusammen mit diesem Parameter übermitteln, wird dem Parameter hosted_page.display_payments der Vorzug gegeben. Beide Parameter widersprechen sich und nur einer davon wird bei der folgenden Verarbeitung angewendet. *(ii)* Wenn die Zahlungsart, welche im Parameter transaction.payment_type übergeben wurde, auch in der Liste von hosted_page.hide_payments gefunden wird, dann wird diese bestimmte Zahlungsart nicht versteckt werden.
hide_blocks Array Freiwillig ['HEADER', 'LANGUAGE_MENU', 'SHOP_INFO', 'ADDRESS_FORM', 'TARIFF']	Wenn Sie diesen Parameter einsetzen, können Sie die Anzeige der verschiedenen Abschnitte auf der gehosteten Zahlungsseite steuern. Die folgenden Werte können eingesetzt werden, um verschiedene Abschnitte zu verstecken. ADDRESS_FORM für "Block zu den Adressdaten der Rechnung verstecken" SHOP_INFO für "Abschnitt mit den Informationen zum Shop verstecken, welcher den URL des Shops und den Namen des Projekts enthält." LANGUAGE_MENU für "Option zur Auswahl der Sprache verstecken" HEADER für "Kopfabschnitt verstecken" TARIFF für "Abschnitt zur Auswahl des Tarifs verstecken"
skip_pages Array Freiwillig ['CONFIRMATION_PAGE', 'SUCCESS_PAGE', 'PAYMENT_PAGE']	Indem Sie diesen Parameter einsetzen, können Sie die Anzeige der verschiedenen Seiten steuern, die eingesetzt werden, während eine Transaktion auf der gehosteten Zahlungsseite verarbeitet wird. Die folgenden Werte können verwendet werden, um verschiedene Seiten zu überspringen: CONFIRMATION_PAGE für "Zwischengeschaltete Überprüfungsseite überspringen" SUCCESS_PAGE für "Standard-Erfolgsseite überspringen" PAYMENT_PAGE für "Zahlungsseite am Anfang überspringen"
url_shortener Integer Bedingungsabhängig 1	Setzen Sie diesen Parameter auf 1, um eine Nachricht über die Generierung des abgekürzten URL zu erhalten. Wenn Sie die Methode der Zahlung per Zahlungslink einsetzen, ist diese Option hilfreich, da sich der abgekürzte URL einfach übertragen löst. Erfahren Sie mehr über den abgekürzten URL unter diesem >>Link<<.
link_expiry String Bedingungsabhängig 2025-01-05 04:09:26	Das Ablaufdatum des abgekürzten URL. Das anzugebende Format ist "JJJJ-MM-TT TT:MM:SS". Anmerkung: Standardmäßig ist der abgekürzte URL 21 Tage lang gültig.
link_notify Array Freiwillig ['EMAIL']	Definiert die Art und Weise, wie der Zahlungslink mit dem Endkunden geteilt wird.
return_target String Freiwillig top	Dieser Parameter gibt die Position der Zahlungsseite im iFrame-Element während einer Umleitung an. Wenn dieser Wert zum Beispiel auf ‘top’ gesetzt wird, wird die nahtlose Zahlungsseite, welche als Reaktion zurückgegeben wird, mit dem HTML-Attribut target=’_top’ platziert.
display_payments_mode Array Freiwillig ['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']	Dieser Parameter ermöglicht Ihnen Zahlungsarten nach Zahlungsmodus auf der gehosteten Zahlungsseite anzuzeigen.

subscription
Objekt

Parameter	Beschreibung
interval String Pflichtfeld 1m	Zeitraum eines Abonnements-Zyklus, zum Beispiel: 1m gibt an das die Verlängerung eines Abonnements jeden Monat geschieht. Folgende Werte sind erlaubt: d für Tag(e), zum Beispiel: 15d m für Monat(e) , zum Beispiel: 3m y für Jahr(e), zum Beispiel: 1y
trial_interval String Freiwillig 1m	Probezeitraum des Abonnements. Verwenden Sie diesen Parameter, wenn Sie nur für die erste Abonnementsperiode einen speziellen Zeitraum haben wollen. Nach der ersten Abonnementsperiode wird der in dem Parameter subscription.interval angegebene Zeitraum berücksichtigt. Folgende Werte sind erlaubt : d für Tag(e), zum Beispiel: 15d m für Monat(e) , zum Beispiel: 3m y für Jahr(e), zum Beispiel: 1y
trial_amount Integer Freiwillig 5000	Betrag für den Probezeitraum des Abonnements. Verwenden Sie diesen Parameter zusammen mit subscription.trial_interval. Der hier übergebene Betrag (in der kleinsten Währungseinheit wird für den Probezeitraum verwendet. Nach dem ersten Zeitraum wird der Betrag berücksichtigt, welcher in dem Parameter transaction.amount angegeben wurde.
expiry_date String Freiwillig 2025-06-15	Datum, an welchem das Abonnement enden soll. Anmerkung: Das anzugebende Format ist "JJJJ-MM-TT".

instalment
Objekt

Parameter	Beschreibung
preselected_cycle Integer Freiwillig 4	Der Zeitabschnitt für die Ratenzahlung muss standardmäßig ausgewählt werden, wenn die gehostete Zahlungsseite geladen wird.
cycles_list Array Freiwillig [2, 4, 6, 8, 9]	Liste der einzelnen Ratenzahlungen, die aufgelistet werden müssen.

marketplace
Objekt

Parameter	Beschreibung
tx_split Objekt Pflichtfeld {'2261':'100', '2271':'120'}	Übergeben Sie den Betrag (in der kleinsten Währungseinheit), welcher für die entsprechenden Unterhändler gebucht werden soll. Das zu verwendende Format ist ein Paar aus submerchant_id:amount. Anmerkung: Hier wird für jedes Paar aus submerchant_id:amount eine Transaktion generiert und dies wird Ihnen durch eine Nachricht / Nachrichten an den Webhook mitgeteilt.
commission_split Objekt Freiwillig {'2261': {'percentage': '100', 'amount': '700'}, '2271': {'percentage': '97'}}	Spezifizieren Sie den Typ des Disagios zur Verarbeitung in dem Parameter marketplace.tx_split. Folgende Werte sind erlaubt: amount für "Verarbeiten Sie die Angabe in tx_split als festen Betrag" percentage für "Verarbeiten Sie die Angabe in tx_split als Prozentsatz." Standardmäßig, wenn dieser Parameter nicht übergeben wird, wird der Typ des Disagios auf der Grundlage des Wertes verarbeitet, welcher im Novalnet Admin-Portal eingestellt wurde.

affiliate
Objekt

Parameter	Beschreibung
subvendors Objekt Pflichtfeld {'2261':'100', '2271':'120'}	Übergeben Sie den Betrag (in der kleinsten Währungseinheit)/Prozentsatz, welcher für den/die entsprechenden Unterhändler verbucht werden soll. Das Format, das verwendet werden soll ist ein Paar aus submerchant_id:amount/percentage (ID des Unterhändlers:Betrag/Prozentsatz). Anmerkung: Hier wird eine einzige Transaktion auf dem Marktplatz erzeugt und der Umsatz wird unter allen übergebenen submerchant_ids aufgeteilt.
commission_type String Freiwillig amount	Geben Sie den Typ des Disagios bei der Verarbeitung des Parameters affiliate.subvendors an. Folgende Werte sind erlaubt: amount für "Verarbeitung des Disagios für subvendors als festen Betrag." percentage für "Verarbeitung des Disagios für subvendors als Prozentsatz.." Standardmäßig wird, wenn dieser Parameter nicht übergeben ist, der Typ des Disagios als percentage (Prozentsatz) betrachtet. "

invoicing
Objekt

Parameter

Beschreibung

net_amount
Integer
Pflichtfeld
5000

Der Gesamtbetrag (vor Steuern) sollte hier angegeben werden.

gross_amount
Integer
Pflichtfeld
5000

Der Gesamtbetrag (einschließlich Steuern) sollte hier angegeben werden.

tax_percent
Integer
Pflichtfeld
2

Der gesamte Steuersatz für die Rechnung in Prozent sollte hier erwähnt werden.

tax_amount
Integer
Pflichtfeld
23

Der gesamte Betrag der Steuern für die Rechnung in Prozent sollte hier erwähnt werden.

coupon_percent
Integer
Freiwillig
1

Preisnachlass in Prozent, der dem Coupon zugeordnet wurde.

coupon_amount
Integer
Freiwillig
10

Betrag des Preisnachlasses, anhand des Wertes des Warenkorbs berechnet.

product_details
Mehrdimensionales Feld

Unterobjekt verstecken

Parameter	Beschreibung
code String Freiwillig P001	Code des einzelnen Produkts
name String Pflichtfeld Name des Produkts	Name des einzelnen Produkts
group String Freiwillig Produktgruppe	Gruppe des einzelnen Produkts
description String Freiwillig Beschreibung des Produkts	Beschreibung jedes Eintrags auf der Rechnung im Detail
unit String Pflichtfeld ST	Referenz auf die Einheit des Produkts
quantity Integer Pflichtfeld 2	Menge des Produkts
unit_price Integer Pflichtfeld 100	Preis jeder Ware (in der kleinsten Währungseinheit) z.B.: für Euro in Eurocent (5,22 € = 522)
total_price Integer Pflichtfeld 200	Gesamtpreis (Preis * Menge) (in der kleinsten Währungseinheit), z.B.: für Euro in Eurocent (5,22 € = 522)
tax_amount Integer Pflichtfeld 1	Betrag der Steuer (in der kleinsten Währungseinheit), z.B: für Euro in Eurocent (5,22 € = 522)
tax_percent Integer Pflichtfeld 1	Steuern in Prozent
discount Integer Freiwillig 0	Identifikation von Preisnachlässen und normalen Angaben zum einzelnen Produkt. Die folgenden Werte sind zulässig: 0 - für "Die angegebene Information in der Rechnung wird als normales Detail des einzelnen Produkts betrachtet” 1 - für "Die angegebene Information in der Rechnung wird als Detail zum Preisnachlass betrachtet."
note String Freiwillig Anmerkung zum Produkt	Zusätzliche Anmerkung zu jedem Rechnungsdetail.

customer_support
String
Freiwillig
Max Mustermann | Email: support@yourshop.de

Richten Sie die Kundendienst-Details hier ein.

notice
Objekt
Freiwillig
{'1' : 'Notice 1', '2' : 'Notice 2', '3' : 'Notice 3'}

Zusätzliche Nachricht, welche Sie dem Endkunden in der PDF-Abrechnung übermitteln wollen. Sie können pro Transaktion bis zu drei Nachrichten hinzufügen.

custom_invoice_no
String
Freiwillig
INV-32

Eine benutzerdefinierte Rechnungsnummer, welche anstelle der standardmäßigen, durch das System generierten Rechnungsnummer verwendet wird.

Anmerkung: Der Wert sollte für jeden Aufruf zur Rechnungsgenerierung eindeutig sein.

send_invoice_pdf
Integer
Bedingungsabhängig
1

Der Endkunde erhält die Rechnung als PDF-Datei im Anhang der Bestellbestätigungs-E-Mail.

custom
Objekt

Parameter	Beschreibung
lang String Freiwillig DE	Sprachcode mit 2 Buchstaben gemäß dem ISO 639-1-Standard
input1..7 String Freiwillig psp	Beliebige Schlüssel-Wert-Paare, welche bei der Buchung angegeben und einfach mit der Buchung zurück übermittelt werden können.
inputval1..7 String Freiwillig novalnet	Beliebige Schlüssel-Wert-Paare, welche bei der Buchung angegeben und einfach mit der Buchung zurück übermittelt werden können.

cart_info
Objekt

Parameter	Beschreibung
line_items Array Freiwillig	Details für jedes Produkt im Warenkorb (Bezeichnung, Beschreibung, Preis etc.)
items_shipping_price Integer Freiwillig 500	Versandkosten für die Produkte im Warenkorb, z. B. Euro in Eurocents (5 € = 500).
items_tax_price Integer Freiwillig 200	Betrag der Steuer für die Produkte im Warenkorb, z. B. Euro in Eurocents (2 € = 200).
items_handling_price Integer Freiwillig 400	Bearbeitungsbetrag für die Produkte im Warenkorb, z. B. Euro in Eurocents (4 € = 400).

result
Objekt

Parameter	Beschreibung
status_text String Pflichtfeld erfolgreich	Dem Entwickler angezeigte Nachricht, welche den aufgetretenen Fehler beschreibt und mögliche Schritte, um diesen zu korrigieren.
status String Pflichtfeld SUCCESS\|FAILURE	Status der API für die Transaktion
redirect_url String Bedingungsabhängig https://payport.novalnet.de/payport?nn_session=asdfrewqrdsshjhjk124efsfsdf	Der URL, an welchen der Käufer umgeleitet werden muss, um die Zahlung auf der von Novalnet gehosteten Zahlungsseite oder im Bankportal eines externen Dienstleisters abzuschließen.
additional_message String Bedingungsabhängig Card lost	Zusätzliche Nachricht zu der Transaktion
status_code Integer Pflichtfeld 100	Statuscode zur API für die Transaktion

transaction
Objekt

Parameter

Beschreibung

payment_type
String
Freiwillig
CREDITCARD

Zahlungsart der Transaktion (von Novalnet definiert). Sehen Sie sich bitte, diesen Abschnitt zu Details der Zahlungsarten an.

amount
Integer
Bedingungsabhängig
522

currency
String
Freiwillig
EUR

Währung, in welcher die Transaktion abgewickelt wird. Der Währungscode aus 3 Buchstaben ist definiert in ISO-4217.

order_no
String
Bedingungsabhängig
123456789

Eindeutiger, aus dem Shop übermittelter Bezeichner für diese Bestellung

test_mode
Integer
Pflichtfeld
0

Gibt den Verarbeitungsmodus der Transaktion an.

Mögliche Werte:

0, wenn "Die Transaktion ist im LIVE-Modus."
1 wenn "Die Transaktion ist im TEST-Modus und kein echter Geldfluss geschieht hier. "

txn_secret
String
Pflichtfeld
fd77014683544a21ed47d468fa24e27b

Transaction secret ist ein temporärer Bezeichner für Zahlungsarten, deren Ablauf eine Umleitung enthält, wird während des gesamten Ablaufs mitgegeben und ist nützlich, um das Ergebnis der Zahlung zu überprüfen.

invoice_ref
String
Freiwillig
BNR-14-213257

payment_data
Objekt

Dieses Object enthält die abgesicherten Zahlungsdaten des Kunden.
Unterobjekt verstecken

Parameter	Beschreibung
token String Freiwillig RcBw2w00a02c-R22w22w22wNJV-V22wV22w10k22wB18sBR06g00aD04eZ12m10k	Das server-seitige Zahlungstoken Ihrer aktuellen Transaktion Anmerkung: Dieser Parameter wird nur zurückgegeben, wenn Sie sich für die Option “create token” (Token anlegen) entschieden haben.
iban String Bedingungsabhängig DEXXXXXXXXXXXXXX1956	IBAN (International Kontonummer) des Kontoinhabers
bic String Bedingungsabhängig CMCIDEDDXXX	BIC (Bank Identifier Code) des Kontoinhabers
cc_3d Integer Bedingungsabhängig 1	Dieser Parameter gibt an, ob Sie eine 3D-Secure-Authentifizierung für eine Transaktion durchführen wollen oder nicht. Falls dieser auf 1 gesetzt ist, wird die Transaktion als 3D-Secure-Transaktion verarbeitet werden.

marker
String
Freiwillig
DEF20140103987

hook_url
String
Bedingungsabhängig
https://www.demoshop.de/webhook

link_expiry
String
Bedingungsabhängig
2025-01-05 04:09:26

Das Ablaufdatum des abgekürzten URL. Das anzugebende Format ist "JJJJ-MM-TT TT:MM:SS".

Anmerkung: Standardmäßig ist der abgekürzte URL 21 Tage lang gültig.

qr_image
String
Bedingungsabhängig
https://nnt.ag/qr/ux631hb9.png

Der QR-Code zum abgekürzten URL

mandate_ref
String
Freiwillig
NN-12345678901234567

Eindeutige Mandatsreferenz des schriftlichen SEPA-Mandats. Diese Referenz wird im Kontoauszug des Endkunden angezeigt. Falls sie nicht angegeben wurden, wird standardmäßig die TID verwendet.

transfer_type
String
Freiwillig
DEBIT

Geben Sie den Überweisungstyp an: CREDIT oder DEBIT.

CREDIT – wird dem Marktplatz belastet und dem Affiliate oder Unter-Händler gutgeschrieben.
DEBIT – wird dem Affiliate oder Unter-Händler belastet und dem Marktplatz gutgeschrieben.

Standardmäßig, falls dieser Parameter nicht übergeben wird, ist der Überweisungstyp DEBIT

debit_reason_1..5
String
Freiwillig
www.test.com

<?php

// Need to enter your payment access key value here
$payment_access_key  = '###YOUR_PAYMENT_ACCESS_KEY###';

// Now, have to encode the $payment_access_key value with the base64 encode
$encoded_data 		 = base64_encode($payment_access_key);

// Action Endpoint 
$endpoint            = 'https://payport.novalnet.de/v2/seamless/payment';

// Build the Headers array
$headers = [

	// The Content-Type should be "application/json"
	'Content-Type:application/json', 
	
	// The charset should be "utf-8"
	'Charset:utf-8', 
	
	// Optional
	'Accept:application/json', 
	
	// The formed authenticate value (case-sensitive)
	'X-NN-Access-Key:' . $encoded_data 
];

$data = [];

// Build Merchant Data
$data['merchant'] = [

	// Your API signature value
    'signature' => '###YOUR_API_SIGNATURE###', 
    
    // Your corresponding tariff ID
    'tariff'    => '###YOUR_TARIFF_ID###'
];

// Build Customer Data
$data['customer'] = [

	// Shopper's first name
    'first_name'  => 'Max',
    
     // Shopper's last name
    'last_name'   => 'Mustermann', 
    
    // Shopper's email
    'email'       => 'test@novalnet.de', 
    
    // Shopper's IP address
    'customer_ip' => '###CUSTOMER_IP###',

    // Shopper's birthdate value YYYY-MM-DD 
    //'birth_date'  => '1992-06-10', 
    
    // Shopper's customer number from the shop
    //'customer_no' => '###CUSTOMER_NUMBER###',
    
    // Shopper's Telephone number
    //'tel'         => '+49 089 123456',
    
    // Shopper's Mobile number
    //'mobile'      => '+49 174 7781423',
    
    // Shopper's gender
    'gender'      => 'u',

    // Shopper's company vat ID value (optional)
    //'vat_id'      => 'DE123456', 
    
    // Shopper's company regestration number (optional)
    //'reg_no'      => 'HRB1234', 
    
    // Shopper's company tax ID value (optional)
    //'tax_id'      => '123/123/123',
    
    // Shopper's session value
    'session'     => 'fedgrgst5653653hdgfsvgdsf622627e', 
    
    // Shopper's fax number
    //'fax'         => '+49 89 654321', 
    
    // Shopper's billing address
    'billing'     => [
    
		// Street
		'street'       => 'Musterstr',
        
		// House number
		'house_no'     => '2',
		
		// City
		'city'         => 'Musterhausen',
		
		// zip
		'zip'          => '12345',
		
		// Country's ISO code
		'country_code' => 'DE',
        
        // Name of the company
        //'company'      => 'ABC GmbH',
        
		// State
        'state'      => 'Berlin'
    ],
    
    /*'shipping' => [
    
        // Pass this parameter if the billing and the shipping address are identical 
		'same_as_billing' => '1',
    
        // First name
        'first_name'    => 'Norbert',
        
        // Last name
        'last_name'     => 'Maier',
        
        // Email
        'email'         => 'test@novalnet.de',
    
        // Street
		'street'        => 'Hauptstr',
    
		// House number
		'house_no'      => '9',
		
		// City
		'city'          => 'Kaiserslautern',
		
		// zip
		'zip'           => '66862',
		
		// Country's ISO code
		'country_code'  => 'DE',
        
        // Telephone number
        'tel'           => '+49 089 123456',
        
        // Name of the company
        'company'       => 'A.B.C. Gerüstbau GmbH',
        
        // Mobile number
        'mobile'        => '+49 174 7781423',
        
		// State
        'state'      => 'Berlin'
    ],
    */
    // Use of minimal customer data
    //'no_nc'        => '1'
    
];

// Build Transaction Data
$data['transaction'] = [

	// The Payment type of the transaction
    //'payment_type'     => '###PAYMENT_TYPE###',
    
    // The transaction Amount in smaller currency unit
    'amount'           => '###TRANSACTION_AMOUNT###',
    
    // The transaction currency's ISO code
    //'currency'         => '###TRANSACTION_CURRENCY###',
    
    // The mode of the transaction
    'test_mode'        => '###TEST_MODE###',
    
    // The order number of the transaction
    'order_no'         => '###TRANSACTION_ORDER_NUMBER###',
    
    // The reference related to your customer`s invoice of the order.
    //'invoice_ref'         => '###INVOICE_REF###',
    
    // Need to be specify this for the Redirect payment types to which you need to redirect on SUCCESS
    'return_url'       => '###YOUR_RETURN_URL###',
    
    // Need to be specify this for the Redirect payment types to which you need to redirect on FAILURE (optional)
    'error_return_url' => '###YOUR_ERROR_RETURN_URL###',
    
    // The Notify URL value for this particular transaction
    'hook_url'         => '###HOOK_URL###',
    
    // The invoice number related to your customer`s invoice of the order.    
    //'invoice_no': '###INVOICE_NO###',
    
    // The unique mandate reference of the written SEPA mandate.
    //'mandate_ref'	   => '###MANDATE_REF###',
    
    // The start date at which the end-customer allowed Novalnet or the merchant to book from his/her account.
    //'mandate_date'	   => '###MANDATE_DATE###',
    
    // The debit reason defines the text on the customer's proof of payment.
    /*'debit_reason_1'	   => '###DEBIT_REASON_1###',
    'debit_reason_2'	   => '###DEBIT_REASON_2###',
    'debit_reason_3'	   => '###DEBIT_REASON_3###',
    'debit_reason_4'	   => '###DEBIT_REASON_4###',*/
    
    // The flag to create the token for the payment data
    //'create_token'     => 1,
    
    // Processing the transaction with SCA authentication
    //'enforce_3d'           => '1',
    
    //'verify_payment_data' => '1',
    
    //'transfer_type': '###TRANSFER_TYPE###',
    
    //'dynamic_descriptor' => 'www.yourshop.com',
    
    // Date by which the customer must settle the payment 
    /*'due_dates'     => [
		'INVOICE' => '2021-08-25',
		'PREPAYMENT' => '2021-08-16',
		'DIRECT_DEBIT_SEPA'=>'2021-08-25',
		'CASHPAYMENT' => '2021-08-25'
	],*/
    
    // Build Payment Data
   /* 'payment_data'     => [
		// Build your payment data based on your selected payment type
		'token' => '###TOKEN###'
    ]*/
];

// Hosted Payment page customizations
$data['hosted_page'] = [

	// Change logo in the Hosted payment page
	//'logo'             => '###YOUR_SHOP_LOGO###',		
    
    //'css_url' => 'https://www.demoshop.de/custom.css',
    
	// Payment types to be hide in the Hosted Payment Page
	//'hide_payments' => ['CREDITCARD', 'DIRECT_DEBIT_SEPA', 'PREPAYMENT', 'IDEAL'],
	
	// Payment types to be displayed in the Hosted Payment Page
	'display_payments' => ['CREDITCARD', 'DIRECT_DEBIT_SEPA', 'PREPAYMENT', 'IDEAL', 'ONLINE_TRANSFER', 'PAYPAL'],
	
	// Hide the following sections from the Hosted Payment Page
	'hide_blocks' 	   => ['ADDRESS_FORM', 'SHOP_INFO', 'LANGUAGE_MENU', 'HEADER', 'TARIFF'],
	
	// Customize the display of the following pages
	'skip_pages'	   => ['CONFIRMATION_PAGE', 'SUCCESS_PAGE', 'PAYMENT_PAGE'],	
	
	'url_shortener' => '1',
	
	'link_expiry' => 'YYYY-MM-DD HH:MM:SS',
	
	//'link_notify' => '['EMAIL']',
	
	//'return_target' => 'top',
	
	//'display_payments_mode' => '['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']'
];

// Subscription Data
$data['subscription'] = [

    // The interval between each cycle
    'interval'       => '1m',

    // Subscription trial interval if applicable
    //'trial_interval' => '3m',

    // Subscription trial interval amount if applicable
    //'trial_amount'   => '150',
    
    // Subscription expiry date 
    //'expiry_date'   => 'YYYY-MM-DD'
];

// Instalment data
$data['instalment'] = [

	// The interval between each cycle
	'interval' => '1m',

	// Total number of cycles
	'cycles' => '2'
];
/*
// Marketplace data
$data['marketplace'] = [

	// To submit amount for several affiliates to be booked
	'tx_split' => [
		'2261' => '20',
		'2271' => '30'
	],  
	// Commission type for the corresponding affiliates
	'commission_split' => [
		'2261' => [
			'percentage' => '100',
			'amount' => '700',			
		],
		'2271' => [
			'percentage' => '97'	
		]
	]
];
*/
// Affiliate Data
$data['affiliate'] = [
	
	// To submit shares for several affiliates for the same transaction
	'subvendors'=> [
		'2261' => '20',
		'2271' => '30'
	],
	// Commission type  for several affiliates for the same transaction
	//'commission_type'=> 'amount'
];

// Invoicing Data
$data['invoicing'] = [

    // Overall invoice tax percent should be mentioned here
    'tax_percent'      => 2,
                       
    // Overall invoice tax amount should be mentioned here
    'tax_amount'       => 2,
    
    // Discount coupon percentage should be mentioned here
    //'coupon_percent'       => 1,
    
    // Discount coupon amount should be mentioned here
    //'coupon_amount'       => 10,
                       
    // Total amount (excl. tax) should be mentioned here
    'net_amount'       => 5000,
                       
    // Total amount (incl. tax) should be mentioned here              
    'gross_amount'     => 5000,
    
    // Individual product details should be mentioned here
    'product_details'  => [
       [
        //'code'          => 'P001',
        'name'          => 'Product name',
        //'group'         => 'Product group',
        //'description'   => 'Product description',
        'unit'          => 2,
        'quantity'      => 2,
        'unit_price'    => 100,
        'total_price'   => 200,
        'tax_amount'    => 1,
        'tax_percent'   => 1,
        //'discount'      => 0,
        //'note'          => 'Note about the product'
      ]
    ],
    /*
    // The notification which you wants to provide to the end-customer in invoice PDF. 
    'notice' => [
		'1' => 'Notice 1',
		'2' => 'Notice 2',
		'3' => 'Notice 3'
    ],
    */
    // Customize the customer support details here
    //'customer_support'  => 'Max Mustermann | Email: support@yourshop.de',
	
	// Custom Invoice number 
	//'custom_invoice_no' => 'INV-32',
	
	// Send the invoice pdf to end customer 
	'send_invoice_pdf' => '1'
];
/*
// Cart Product Data
$data['cart_info'] = [
    
    'line_items'  => [
       [
        'category'          => 'physical',
        'description'          => '',
        'name'         => '4 Jeans und shoe',
        'price'   => '3500',
        'quantity'          => 1
      ]
    ],

    'items_shipping_price'       => 1500,
              
    'items_tax_price'     => 950,
    
    'items_handling_price'     => 500
];

// Custom Data
$data['custom'] = [
	
	// Shopper's selected language in shop
	'lang'      => 'DE',
	
	// Custom parameter's key
	'input1'    => 'your internal reference parameter name',
	
	// Custom parameter's value
	'inputval1' => 'your internal reference parameter value'
];
*/
// Convert the array to JSON string

$json_data = json_encode($data);

// Handle Response
$response = send_request($json_data, $endpoint, $headers);

function send_request($data, $url, $headers) {

    // Initiate cURL
    $curl = curl_init();
    
    // Set the url
    curl_setopt($curl, CURLOPT_URL, $url);
    
    // Set the result output to be a string
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    // Set the POST value to true (mandatory)
    curl_setopt($curl, CURLOPT_POST, true);
    
    // Set the post fields
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    
    // Set the headers
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

    // Execute cURL
    $result = curl_exec($curl);

    // Handle cURL error
	if (curl_errno($curl)) {
		echo 'Request Error:' . curl_error($curl);
		return $result;
	}
	// Close cURL
	curl_close($curl);  
	
	// Decode the JSON string
	$result = json_decode($result);
	
	return $result;
}

?>

CURL

curl --location --request POST 'https://payport.novalnet.de/v2/seamless/payment' -H 'Content-Type: application/json' -H 'Charset:utf-8' -H 'Accept: application/json' -H 'X-NN-Access-Key: ###YOUR_ENCODED_PAYMENT_ACCESS_KEY###' -d '{"merchant":{"signature":"###YOUR_API_SIGNATURE###","tariff":"###YOUR_TARIFF_ID###"},"customer":{"first_name":"Max","last_name":"Mustermann","email":"test@novalnet.de","customer_ip":"###CUSTOMER_IP###","customer_no":"###CUSTOMER_NUMBER###","birth_date":"1992-06-10","tel":"+49 089 123456","mobile":"+49 174 7781423","gender":"u","vat_id":"DE123456","reg_no":"HRB1234","tax_id":"123\/123\/123","session":"fedgrgst5653653hdgfsvgdsf622627e","fax":"+49 89 654321","billing":{"street":"Musterstr","house_no":"2","city":"Musterhausen","zip":"12345","country_code":"DE","company":"ABC GmbH"},"shipping":{"first_name":"Norbert","last_name":"Maier","email":"test@novalnet.de","street":"Hauptstr","house_no":"9","city":"Kaiserslautern","zip":"66862","country_code":"DE","tel":"+49 089 123456","company":"A.B.C. Ger\u00fcstbau GmbH","mobile":"+49 174 7781423"}},"transaction":{"payment_type":"###PAYMENT_TYPE###","amount":"###TRANSACTION_AMOUNT###","currency":"###TRANSACTION_CURRENCY###","test_mode":"###TEST_MODE###","order_no":"###TRANSACTION_ORDER_NUMBER###","return_url":"###YOUR_RETURN_URL###","error_return_url":"###YOUR_ERROR_RETURN_URL###","hook_url":"###HOOK_URL###","create_token":1,"payment_data":{"token":"###TOKEN###"}},"hosted_page":{"logo":"###YOUR_SHOP_LOGO###","display_payments":["CREDITCARD","DIRECT_DEBIT_SEPA","PREPAYMENT","IDEAL","ONLINE_TRANSFER","PAYPAL"],"hide_blocks":["ADDRESS_FORM","SHOP_INFO","LANGUAGE_MENU","HEADER","TARIFF"],"skip_pages":["CONFIRMATION_PAGE","SUCCESS_PAGE","PAYMENT_PAGE"]},"subscription":{"interval":"1m","trial_interval":"3m","trial_amount":"150"},"marketplace":{"tx_split":{"2261":"20","2271":"30"}},"affiliate":{"subvendors":{"2261":"20","2271":"30"}},"custom":{"lang":"DE"},"invoicing":{"tax_percent":2,"tax_amount":2,"net_amount":5000,"gross_amount":5000,"product_details":[{"code":"P001","name":"Product name","group":"Product group","description":"Product description","quantity":2,"unit":2,"unit_price":100,"total_price":200,"tax_amount":1,"tax_percent":1,"discount":0,"note":"Note about the product"}],"notice":{"1":"Notice 1","2":"Notice 2","3":"Notice 3"},"customer_support":"Max Mustermann | Email: support@yourshop.de","custom_invoice_no":"INV-32"}}';

NODEJS

#!/usr/bin/node

const https = require('https');
// data sent in the body of the request
const postData = JSON.stringify({
  "merchant": {
    "signature": "###YOUR_API_SIGNATURE###",
    "tariff": "###YOUR_TARIFF_ID###"
  },
  "customer": {
    //"gender": "u",
    "first_name": "Max",
    "last_name": "Mustermann",
    "email": "test@novalnet.de",
    "billing": {
      "company": "ABC GmbH",
      "house_no": "2",
      "street": "Musterstr",
      "city": "Musterhausen",
      "zip": "12345",
      "country_code": "DE",
      "state": "Berlin"
    },
    "customer_ip": "###CUSTOMER_IP###",
    //"customer_no": "###CUSTOMER_NUMBER###",
    "birth_date": "1992-06-10",
    //"tel": "+49 089 123456",
    //"mobile": "+49 089 123456",
    //"fax": "+49 89 654321",
    /*
    "shipping": {
      "same_as_billing": "1",
      "city": "Kaiserslautern",
      "company": "A.B.C. Gerüstbau GmbH",
      "country_code": "DE",
      "email": "test@novanet.de",
      "first_name": "Norbert",
      "house_no": "9",
      "last_name": "Maier",
      "mobile": "+491747781423",
      "state": "Berlin",
      "street": "Hauptstr",
      "tel": "+49 089 123456",
      "zip": "66862"
    },
    */
    //"vat_id": "DE123456",
    //"tax_id": "123/123/123",
    //"reg_no": "HRB1234",
    //"session": "fedgrgst5653653hdgfsvgdsf622627e",
    //"no_nc": "1"
  },
  "transaction": {
    "test_mode": "###TEST_MODE###",
    "payment_type": "###PAYMENT_TYPE###",
    "amount": "###TRANSACTION_AMOUNT###",
    "currency": "###TRANSACTION_CURRENCY###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "hook_url": "###HOOK_URL###",
    "return_url": "###YOUR_RETURN_URL###",
    "error_return_url": "###YOUR_ERROR_RETURN_URL###",
    /*
    "invoice_ref": "###INVOICE_REF###",
    "mandate_ref": "###MANDATE_REF###",
    "mandate_date": "###MANDATE_DATE###",
    "invoice_no": "###INVOICE_NO###",
    "create_token": "1",
    "payment_data": {
      "token": "###TOKEN###"
    },	
    "due_dates": {
      "INVOICE": "2023-08-25",
      "PREPAYMENT": "2023-08-25",
      "DIRECT_DEBIT_SEPA": "2023-08-25",
      "CASHPAYMENT": "2023-08-25"
    },
    "debit_reason_1": "###DEBIT_REASON_1###"
    */
  },
  "hosted_page": {
    //"logo": "###YOUR_SHOP_LOGO###",
    //"css_url": "https://www.demoshop.de/custom.css",
    "hide_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL"
    ],
    "display_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL",
      "ONLINE_TRANSFER",
      "PAYPAL"
    ],
    "hide_blocks": [
      "ADDRESS_FORM",
      "SHOP_INFO",
      "LANGUAGE_MENU",
      "HEADER",
      "TARIFF"
    ],
    "skip_pages": [
      "CONFIRMATION_PAGE",
      "SUCCESS_PAGE",
      "PAYMENT_PAGE"
    ],
	"url_shortener":"1",
	"link_expiry":"YYYY-MM-DD HH:MM:SS",
	//"link_notify":"['EMAIL']",
	//"return_target":"top",
	//"display_payments_mode":"['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",

  },
  "subscription": {
    "interval": "2m",
    /*
    "trial_interval": "3m",
    "trial_amount": "150",
    "expiry_date": "YYYY-MM-DD"
    */
  },
  "instalment": {
    "interval": "2m",
    "cycles": "2"
  },
  /*
  "marketplace": {
    "tx_split": {
      "2261": "100",
      "2271": "120"
    },
    "commission_split": {
      "2261": {
        "percentage": "100",
        "amount": "700"
      },
      "2271": {
        "percentage": "97"
      }
    }
  },
  */
  "affiliate": {
    "subvendors": {
      "2261": "100",
      "2271": "120"
    },
    //"commission_type": "amount"
  },
  "invoicing": {
    "tax_percent": 2,
    "tax_amount": 2,
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    //"coupon_percent": 1,
    //"coupon_amount": 10,
    "product_details": [
      {
        //"code": "P001",
        "name": "Product name",
        //"group": "Product group",
        //"description": "Product description",
        "quantity": 2,
        "unit": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        //"discount": 0,
        //"note": "Note about the product"
      }
    ],
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    //"customer_support": "Max Mustermann | Email: support@yourshop.de",
    //"custom_invoice_no": "INV-32",
    "send_invoice_pdf": "1"
  },
  /*
  "cart_info": {
    "line_items": [
      {
        "category": "physical",
        "description": "",
        "name": "4 Jeans und shoe",
        "price": "3500",
        "quantity": 1
      }
    ],
    "items_shipping_price": "1500",
    "items_tax_price": "950",
    "items_handling_price": "500"
  },
  "custom": {
    "lang": "DE",
    "input1": "{{input1}}",
    "inputval1": "{{inputval1}}"
  }
  */
});

const options = {
  hostname: 'payport.novalnet.de',
  port: 443,
  path: '/v2/seamless/payment',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(postData),
    'Charset': 'utf-8',
    'Accept': 'application/json',
    'X-NN-Access-Key': '"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###"'
  },
};

const req = https.request(options, (res) => {
  console.log('statusCode:', res.statusCode);
  // console.log('headers:', res.headers);

  res.on('data', (d) => {
    process.stdout.write(d);
  });
});

req.on('error', (e) => {
  console.error('ERROR: ',e);
});

// Write data to request body
req.write(postData);
req.end();

PYTHON

#!/usr/bin/python3
import http.client
import json

CONN = http.client.HTTPSConnection("payport.novalnet.de")
PAYLOAD = json.dumps({
"merchant": {
	"signature": "###YOUR_API_SIGNATURE###",
	"tariff": "###YOUR_TARIFF_ID###"
},
"customer": {
	#"gender": "u",
	"first_name": "Max",
	"last_name": "Mustermann",
	"email": "test@novalnet.de",
	"billing": {
		"company": "ABC GmbH",
		"house_no": "2",
		"street": "Musterstr",
		"city": "Musterhausen",
		"zip": "12345",
		"country_code": "DE",
		"state": "Berlin"
	},
	"customer_ip": "###CUSTOMER_IP###",
	#"customer_no": "###CUSTOMER_NUMBER###",
	"birth_date": "1992-06-10",
	#"tel": "+49 089 123456",
	#"mobile": "+49 089 123456",
	#"fax": "+49 89 654321",	
	#"shipping": {
		  #"same_as_billing": "1",
		  #"city": "Kaiserslautern",
		  #"company": "A.B.C. Gerüstbau GmbH",
		  #"country_code": "DE",
		  #"email": "test@novanet.de",
		  #"first_name": "Norbert",
		  #"house_no": "9",
		  #"last_name": "Maier",
		  #"mobile": "+491747781423",
		  #"state": "Berlin",
		  #"street": "Hauptstr",
		  #"tel": "+49 089 123456",
		  #"zip": "66862"
	#},
	#"vat_id": "DE123456",
	#"tax_id": "123/123/123",
	#"reg_no": "HRB1234",
	#"session": "fedgrgst5653653hdgfsvgdsf622627e",
	#"no_nc": "1"
},  
"transaction": {
	"test_mode": "###TEST_MODE###",
	"payment_type": "###PAYMENT_TYPE###",
	"amount": "###TRANSACTION_AMOUNT###",
	"currency": "###TRANSACTION_CURRENCY###",
	"order_no": "###TRANSACTION_ORDER_NUMBER###",
	"hook_url": "###HOOK_URL###",
	"return_url": "###YOUR_RETURN_URL###",
	"error_return_url": "###YOUR_ERROR_RETURN_URL###",

	#"invoice_ref": "###INVOICE_REF###",
	#"mandate_ref": "###MANDATE_REF###",
	#"mandate_date": "###MANDATE_DATE###",
	#"invoice_no": "###INVOICE_NO###",
	#"create_token": "1",
	#"payment_data": {
		#"token": "###TOKEN###"
	#},	
	#"due_dates": {
		#"INVOICE": "2023-08-25",
		#"PREPAYMENT": "2023-08-25",
		#"DIRECT_DEBIT_SEPA": "2023-08-25",
		#"CASHPAYMENT": "2023-08-25"
	#},
	#"debit_reason_1": "###DEBIT_REASON_1###"

},
"hosted_page": {
	#"logo": "###YOUR_SHOP_LOGO###",
	#"css_url": "https://www.demoshop.de/custom.css",
	"hide_payments": [
		"CREDITCARD",
		"DIRECT_DEBIT_SEPA",
		"PREPAYMENT",
		"IDEAL"
	],
	"display_payments": [
		"CREDITCARD",
		"DIRECT_DEBIT_SEPA",
		"PREPAYMENT",
		"IDEAL",
		"ONLINE_TRANSFER",
		"PAYPAL"
	],
	"hide_blocks": [
		"ADDRESS_FORM",
		"SHOP_INFO",
		"LANGUAGE_MENU",
		"HEADER",
		"TARIFF"
	],
	"skip_pages": [
		"CONFIRMATION_PAGE",
		"SUCCESS_PAGE",
		"PAYMENT_PAGE"
	],
	"url_shortener":"1",
	"link_expiry":"YYYY-MM-DD HH:MM:SS",
	#"link_notify":"['EMAIL']",
	#"return_target":"top",
	#"display_payments_mode":"['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",
},
"subscription": {
	"interval": "2m",    
	#"trial_interval": "3m",
	#"trial_amount": "150",
	#"expiry_date": "YYYY-MM-DD"    
},
"instalment": {
	"interval": "2m",
	"cycles": "2"
},

#"marketplace": {
	# "tx_split": {
		#  "2261": "100",
		# "2271": "120"
	#},
	#"commission_split": {
		# "2261": {
			#  "percentage": "100",
			# "amount": "700"
			#},
		#"2271": {
			"percentage": "97"
			#}
		#}
#},

"affiliate": {
	"subvendors": {
		"2261": "100",
		"2271": "120"
	},
	#"commission_type": "amount"
},
"invoicing": {
	"tax_percent": 2,
	"tax_amount": 2,
	"net_amount": 5000,
	"gross_amount": 5000,
	"tax_percent": 2,
	"tax_amount": 2,
	#"coupon_percent": 1,
	#"coupon_amount": 10,
	"product_details": [
	{
		#"code": "P001",
		"name": "Product name",
		#"group": "Product group",
		#"description": "Product description",
		"quantity": 2,
		"unit": 2,
		"unit_price": 100,
		"total_price": 200,
		"tax_amount": 1,
		"tax_percent": 1,
		#"discount": 0,
		#"note": "Note about the product"
	}
	],
	"notice": {
	"1": "Notice 1",
	"2": "Notice 2",
	"3": "Notice 3"
	},
	#"customer_support": "Max Mustermann | Email: support@yourshop.de",
	#"custom_invoice_no": "INV-32",
	"send_invoice_pdf": "1"
},
#"cart_info": {
	# "line_items": [
	#  {
		#  "category": "physical",
		#  "description": "",
		# "name": "4 Jeans und shoe",
		# "price": "3500",
		# "quantity": 1
	#}
	#],
	# "items_shipping_price": "1500",
	# "items_tax_price": "950",
	# "items_handling_price": "500"
#},

#"custom": {
	# "lang": "DE",
	#"input1": "{{input1}}",
	#"inputval1": "{{inputval1}}"
#}
})

HEADERS = {
  'Content-Type': 'application/json',
  'Charset': 'utf-8',
  'Accept': 'application/json',
  'X-NN-Access-Key': '"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###"'
}
CONN.request("POST", "/v2/seamless/payment", PAYLOAD, HEADERS)
RES = CONN.getresponse()
DATA = RES.read()
print(DATA.decode("utf-8"))

RUBY

#!/usr/bin/ruby
require "uri"
require "json"
require "net/http"

url = URI("https://payport.novalnet.de/v2/seamless/payment")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Charset"] = "utf-8"
request["Accept"] = "application/json"
request["X-NN-Access-Key"] = "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\""
request.body = JSON.dump({
"merchant": {
	"signature": "###YOUR_API_SIGNATURE###",
	"tariff": "###YOUR_TARIFF_ID###"
},
"customer": {
	#"gender": "u",
	"first_name": "Max",
	"last_name": "Mustermann",
	"email": "test@novalnet.de",
	"billing": {
		"company": "ABC GmbH",
		"house_no": "2",
		"street": "Musterstr",
		"city": "Musterhausen",
		"zip": "12345",
		"country_code": "DE",
		"state": "Berlin"
	},
	"customer_ip": "###CUSTOMER_IP###",
	#"customer_no": "###CUSTOMER_NUMBER###",
	"birth_date": "1992-06-10",
	#"tel": "+49 089 123456",
	#"mobile": "+49 089 123456",
	#"fax": "+49 89 654321",	
	#"shipping": {
		  #"same_as_billing": "1",
		  #"city": "Kaiserslautern",
		  #"company": "A.B.C. Gerüstbau GmbH",
		  #"country_code": "DE",
		  #"email": "test@novanet.de",
		  #"first_name": "Norbert",
		  #"house_no": "9",
		  #"last_name": "Maier",
		  #"mobile": "+491747781423",
		  #"state": "Berlin",
		  #"street": "Hauptstr",
		  #"tel": "+49 089 123456",
		  #"zip": "66862"
	#},
	#"vat_id": "DE123456",
	#"tax_id": "123/123/123",
	#"reg_no": "HRB1234",
	#"session": "fedgrgst5653653hdgfsvgdsf622627e",
	#"no_nc": "1"
},  
"transaction": {
	"test_mode": "###TEST_MODE###",
	"payment_type": "###PAYMENT_TYPE###",
	"amount": "###TRANSACTION_AMOUNT###",
	"currency": "###TRANSACTION_CURRENCY###",
	"order_no": "###TRANSACTION_ORDER_NUMBER###",
	"hook_url": "###HOOK_URL###",
	"return_url": "###YOUR_RETURN_URL###",
	"error_return_url": "###YOUR_ERROR_RETURN_URL###",

	#"invoice_ref": "###INVOICE_REF###",
	#"mandate_ref": "###MANDATE_REF###",
	#"mandate_date": "###MANDATE_DATE###",
	#"invoice_no": "###INVOICE_NO###",
	#"create_token": "1",
	#"payment_data": {
		#"token": "###TOKEN###"
	#},	
	#"due_dates": {
		#"INVOICE": "2023-08-25",
		#"PREPAYMENT": "2023-08-25",
		#"DIRECT_DEBIT_SEPA": "2023-08-25",
		#"CASHPAYMENT": "2023-08-25"
	#},
	#"debit_reason_1": "###DEBIT_REASON_1###"

},
"hosted_page": {
	#"logo": "###YOUR_SHOP_LOGO###",
	#"css_url": "https://www.demoshop.de/custom.css",
	"hide_payments": [
		"CREDITCARD",
		"DIRECT_DEBIT_SEPA",
		"PREPAYMENT",
		"IDEAL"
	],
	"display_payments": [
		"CREDITCARD",
		"DIRECT_DEBIT_SEPA",
		"PREPAYMENT",
		"IDEAL",
		"ONLINE_TRANSFER",
		"PAYPAL"
	],
	"hide_blocks": [
		"ADDRESS_FORM",
		"SHOP_INFO",
		"LANGUAGE_MENU",
		"HEADER",
		"TARIFF"
	],
	"skip_pages": [
		"CONFIRMATION_PAGE",
		"SUCCESS_PAGE",
		"PAYMENT_PAGE"
	],
	"url_shortener": "1",
	"link_expiry": "YYYY-MM-DD HH:MM:SS",
	#"link_notify": "['EMAIL']",
	#"return_target": "top",
	#"display_payments_mode": "['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",
},
"subscription": {
	"interval": "2m",    
	#"trial_interval": "3m",
	#"trial_amount": "150",
	#"expiry_date": "YYYY-MM-DD"    
},
"instalment": {
	"interval": "2m",
	"cycles": "2"
},

#"marketplace": {
	# "tx_split": {
		#  "2261": "100",
		# "2271": "120"
	#},
	#"commission_split": {
		# "2261": {
			#  "percentage": "100",
			# "amount": "700"
			#},
		#"2271": {
			"percentage": "97"
			#}
		#}
#},

"affiliate": {
	"subvendors": {
		"2261": "100",
		"2271": "120"
	},
	#"commission_type": "amount"
},
"invoicing": {
	"tax_percent": 2,
	"tax_amount": 2,
	"net_amount": 5000,
	"gross_amount": 5000,
	"tax_percent": 2,
	"tax_amount": 2,
	#"coupon_percent": 1,
	#"coupon_amount": 10,
	"product_details": [
	{
		#"code": "P001",
		"name": "Product name",
		#"group": "Product group",
		#"description": "Product description",
		"quantity": 2,
		"unit": 2,
		"unit_price": 100,
		"total_price": 200,
		"tax_amount": 1,
		"tax_percent": 1,
		#"discount": 0,
		#"note": "Note about the product"
	}
	],
	"notice": {
	"1": "Notice 1",
	"2": "Notice 2",
	"3": "Notice 3"
	},
	#"customer_support": "Max Mustermann | Email: support@yourshop.de",
	#"custom_invoice_no": "INV-32",
	"send_invoice_pdf": "1"
},
#"cart_info": {
	# "line_items": [
	#  {
		#  "category": "physical",
		#  "description": "",
		# "name": "4 Jeans und shoe",
		# "price": "3500",
		# "quantity": 1
	#}
	#],
	# "items_shipping_price": "1500",
	# "items_tax_price": "950",
	# "items_handling_price": "500"
#},

#"custom": {
	# "lang": "DE",
	#"input1": "{{input1}}",
	#"inputval1": "{{inputval1}}"
#}
})

response = https.request(request)
puts response.read_body

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://payport.novalnet.de/v2/seamless/payment"
  method := "POST"

  payload := strings.NewReader(`{
  "merchant": {
    "signature": "###YOUR_API_SIGNATURE###",
    "tariff": "###YOUR_TARIFF_ID###"
  },
  "customer": {
    //"gender": "u",
    "first_name": "Max",
    "last_name": "Mustermann",
    "email": "test@novalnet.de",
    "billing": {
      "company": "ABC GmbH",
      "house_no": "2",
      "street": "Musterstr",
      "city": "Musterhausen",
      "zip": "12345",
      "country_code": "DE",
      "state": "Berlin"
    },
    "customer_ip": "###CUSTOMER_IP###",
    //"customer_no": "###CUSTOMER_NUMBER###",
    "birth_date": "1992-06-10",
    //"tel": "+49 089 123456",
    //"mobile": "+49 089 123456",
    //"fax": "+49 89 654321",
    /*
    "shipping": {
      "same_as_billing": "1",
      "city": "Kaiserslautern",
      "company": "A.B.C. Gerüstbau GmbH",
      "country_code": "DE",
      "email": "test@novanet.de",
      "first_name": "Norbert",
      "house_no": "9",
      "last_name": "Maier",
      "mobile": "+491747781423",
      "state": "Berlin",
      "street": "Hauptstr",
      "tel": "+49 089 123456",
      "zip": "66862"
    },
    */
    //"vat_id": "DE123456",
    //"tax_id": "123/123/123",
    //"reg_no": "HRB1234",
    //"session": "fedgrgst5653653hdgfsvgdsf622627e",
    //"no_nc": "1"
  },
  "transaction": {
    "test_mode": "###TEST_MODE###",
    "payment_type": "###PAYMENT_TYPE###",
    "amount": "###TRANSACTION_AMOUNT###",
    "currency": "###TRANSACTION_CURRENCY###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "hook_url": "###HOOK_URL###",
    "return_url": "###YOUR_RETURN_URL###",
    "error_return_url": "###YOUR_ERROR_RETURN_URL###",
    /*
    "invoice_ref": "###INVOICE_REF###",
    "mandate_ref": "###MANDATE_REF###",
    "mandate_date": "###MANDATE_DATE###",
    "invoice_no": "###INVOICE_NO###",
    "create_token": "1",
    "payment_data": {
      "token": "###TOKEN###"
    },	
    "due_dates": {
      "INVOICE": "2023-08-25",
      "PREPAYMENT": "2023-08-25",
      "DIRECT_DEBIT_SEPA": "2023-08-25",
      "CASHPAYMENT": "2023-08-25"
    },
    "debit_reason_1": "###DEBIT_REASON_1###"
    */
  },
  "hosted_page": {
    //"logo": "###YOUR_SHOP_LOGO###",
    //"css_url": "https://www.demoshop.de/custom.css",
    "hide_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL"
    ],
    "display_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL",
      "ONLINE_TRANSFER",
      "PAYPAL"
    ],
    "hide_blocks": [
      "ADDRESS_FORM",
      "SHOP_INFO",
      "LANGUAGE_MENU",
      "HEADER",
      "TARIFF"
    ],
    "skip_pages": [
      "CONFIRMATION_PAGE",
      "SUCCESS_PAGE",
      "PAYMENT_PAGE"
    ],
	"url_shortener":"1",
	"link_expiry":"YYYY-MM-DD HH:MM:SS",
	//"link_notify":"['EMAIL']",
	//"return_target":"top",
	//"display_payments_mode":"['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",

  },
  "subscription": {
    "interval": "2m",
    /*
    "trial_interval": "3m",
    "trial_amount": "150",
    "expiry_date": "YYYY-MM-DD"
    */
  },
  "instalment": {
    "interval": "2m",
    "cycles": "2"
  },
  /*
  "marketplace": {
    "tx_split": {
      "2261": "100",
      "2271": "120"
    },
    "commission_split": {
      "2261": {
        "percentage": "100",
        "amount": "700"
      },
      "2271": {
        "percentage": "97"
      }
    }
  },
  */
  "affiliate": {
    "subvendors": {
      "2261": "100",
      "2271": "120"
    },
    //"commission_type": "amount"
  },
  "invoicing": {
    "tax_percent": 2,
    "tax_amount": 2,
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    //"coupon_percent": 1,
    //"coupon_amount": 10,
    "product_details": [
      {
        //"code": "P001",
        "name": "Product name",
        //"group": "Product group",
        //"description": "Product description",
        "quantity": 2,
        "unit": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        //"discount": 0,
        //"note": "Note about the product"
      }
    ],
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    //"customer_support": "Max Mustermann | Email: support@yourshop.de",
    //"custom_invoice_no": "INV-32",
    "send_invoice_pdf": "1"
  },
  /*
  "cart_info": {
    "line_items": [
      {
        "category": "physical",
        "description": "",
        "name": "4 Jeans und shoe",
        "price": "3500",
        "quantity": 1
      }
    ],
    "items_shipping_price": "1500",
    "items_tax_price": "950",
    "items_handling_price": "500"
  },
  "custom": {
    "lang": "DE",
    "input1": "{{input1}}",
    "inputval1": "{{inputval1}}"
  }
  */
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Charset", "utf-8")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-NN-Access-Key", "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\"")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

JAVA

/* List of required libraries (see also the import statements below): 
- commons-logging-1.2.jar    
- httpasyncclient-4.1.5.jar  
- httpclient-4.3.3.jar  
- httpcore-4.4.16.jar   
- httpcore-nio-4.4.16.jar  
- httpmime-4.5.14.jar      
- json-20230227.jar  
- unirest-java-3.9.00.jar
*/

import org.json.JSONArray;
import org.apache.http.auth.*;
import org.apache.http.nio.conn.*; 
import org.apache.http.concurrent.*;
import org.apache.http.nio.reactor.*;
import org.apache.commons.logging.*;
import org.apache.http.entity.mime.content.*; 
import kong.unirest.*;

public class CancelRequest {
  public void send_test_request() {
    Unirest.config().connectTimeout(1000).socketTimeout(2000);
    HttpResponse<String> response = Unirest.post("https://payport.novalnet.de/v2/seamless/payment")
    .header("Content-Type", "application/json")
    .header("Charset", "utf-8")
    .header("Accept", "application/json")
    .header("X-NN-Access-Key", "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\"")
	.body("{
  "merchant": {
    "signature": "###YOUR_API_SIGNATURE###",
    "tariff": "###YOUR_TARIFF_ID###"
  },
  "customer": {
    //"gender": "u",
    "first_name": "Max",
    "last_name": "Mustermann",
    "email": "test@novalnet.de",
    "billing": {
      "company": "ABC GmbH",
      "house_no": "2",
      "street": "Musterstr",
      "city": "Musterhausen",
      "zip": "12345",
      "country_code": "DE",
      "state": "Berlin"
    },
    "customer_ip": "###CUSTOMER_IP###",
    //"customer_no": "###CUSTOMER_NUMBER###",
    "birth_date": "1992-06-10",
    //"tel": "+49 089 123456",
    //"mobile": "+49 089 123456",
    //"fax": "+49 89 654321",
    /*
    "shipping": {
      "same_as_billing": "1",
      "city": "Kaiserslautern",
      "company": "A.B.C. Gerüstbau GmbH",
      "country_code": "DE",
      "email": "test@novanet.de",
      "first_name": "Norbert",
      "house_no": "9",
      "last_name": "Maier",
      "mobile": "+491747781423",
      "state": "Berlin",
      "street": "Hauptstr",
      "tel": "+49 089 123456",
      "zip": "66862"
    },
    */
    //"vat_id": "DE123456",
    //"tax_id": "123/123/123",
    //"reg_no": "HRB1234",
    //"session": "fedgrgst5653653hdgfsvgdsf622627e",
    //"no_nc": "1"
  },
  "transaction": {
    "test_mode": "###TEST_MODE###",
    "payment_type": "###PAYMENT_TYPE###",
    "amount": "###TRANSACTION_AMOUNT###",
    "currency": "###TRANSACTION_CURRENCY###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "hook_url": "###HOOK_URL###",
    "return_url": "###YOUR_RETURN_URL###",
    "error_return_url": "###YOUR_ERROR_RETURN_URL###",
    /*
    "invoice_ref": "###INVOICE_REF###",
    "mandate_ref": "###MANDATE_REF###",
    "mandate_date": "###MANDATE_DATE###",
    "invoice_no": "###INVOICE_NO###",
    "create_token": "1",
    "payment_data": {
      "token": "###TOKEN###"
    },	
    "due_dates": {
      "INVOICE": "2023-08-25",
      "PREPAYMENT": "2023-08-25",
      "DIRECT_DEBIT_SEPA": "2023-08-25",
      "CASHPAYMENT": "2023-08-25"
    },
    "debit_reason_1": "###DEBIT_REASON_1###"
    */
  },
  "hosted_page": {
    //"logo": "###YOUR_SHOP_LOGO###",
    //"css_url": "https://www.demoshop.de/custom.css",
    "hide_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL"
    ],
    "display_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL",
      "ONLINE_TRANSFER",
      "PAYPAL"
    ],
    "hide_blocks": [
      "ADDRESS_FORM",
      "SHOP_INFO",
      "LANGUAGE_MENU",
      "HEADER",
      "TARIFF"
    ],
    "skip_pages": [
      "CONFIRMATION_PAGE",
      "SUCCESS_PAGE",
      "PAYMENT_PAGE"
    ],
	"url_shortener":"1",
	"link_expiry":"YYYY-MM-DD HH:MM:SS",
	//"link_notify":"['EMAIL']",
	//"return_target":"top",
	//"display_payments_mode":"['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",

  },
  "subscription": {
    "interval": "2m",
    /*
    "trial_interval": "3m",
    "trial_amount": "150",
    "expiry_date": "YYYY-MM-DD"
    */
  },
  "instalment": {
    "interval": "2m",
    "cycles": "2"
  },
  /*
  "marketplace": {
    "tx_split": {
      "2261": "100",
      "2271": "120"
    },
    "commission_split": {
      "2261": {
        "percentage": "100",
        "amount": "700"
      },
      "2271": {
        "percentage": "97"
      }
    }
  },
  */
  "affiliate": {
    "subvendors": {
      "2261": "100",
      "2271": "120"
    },
    //"commission_type": "amount"
  },
  "invoicing": {
    "tax_percent": 2,
    "tax_amount": 2,
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    //"coupon_percent": 1,
    //"coupon_amount": 10,
    "product_details": [
      {
        //"code": "P001",
        "name": "Product name",
        //"group": "Product group",
        //"description": "Product description",
        "quantity": 2,
        "unit": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        //"discount": 0,
        //"note": "Note about the product"
      }
    ],
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    //"customer_support": "Max Mustermann | Email: support@yourshop.de",
    //"custom_invoice_no": "INV-32",
    "send_invoice_pdf": "1"
  },
  /*
  "cart_info": {
    "line_items": [
      {
        "category": "physical",
        "description": "",
        "name": "4 Jeans und shoe",
        "price": "3500",
        "quantity": 1
      }
    ],
    "items_shipping_price": "1500",
    "items_tax_price": "950",
    "items_handling_price": "500"
  },
  "custom": {
    "lang": "DE",
    "input1": "{{input1}}",
    "inputval1": "{{inputval1}}"
  }
  */
}")
    .asString();
    System.out.println(response.getBody());
  }
  public static void main(String[] args) {
    CancelRequest requestClient = new CancelRequest();
    requestClient.send_test_request();
  }

}

CSHARP

using System;
/*using System.Net.Http.WebRequest; */
using System.Net.Http;

namespace CancellationRequest
{
  public class Cancellation {

    public string check_cancellation_request() {
      var client = new HttpClient();
      var request = new HttpRequestMessage(HttpMethod.Post, "https://payport.novalnet.de/v2/seamless/payment");

      request.Headers.Add("Charset", "utf-8");
      request.Headers.Add("Accept", "application/json");
      request.Headers.Add("X-NN-Access-Key", "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\"");
      var content = new StringContent("{
  "merchant": {
    "signature": "###YOUR_API_SIGNATURE###",
    "tariff": "###YOUR_TARIFF_ID###"
  },
  "customer": {
    //"gender": "u",
    "first_name": "Max",
    "last_name": "Mustermann",
    "email": "test@novalnet.de",
    "billing": {
      "company": "ABC GmbH",
      "house_no": "2",
      "street": "Musterstr",
      "city": "Musterhausen",
      "zip": "12345",
      "country_code": "DE",
      "state": "Berlin"
    },
    "customer_ip": "###CUSTOMER_IP###",
    //"customer_no": "###CUSTOMER_NUMBER###",
    "birth_date": "1992-06-10",
    //"tel": "+49 089 123456",
    //"mobile": "+49 089 123456",
    //"fax": "+49 89 654321",
    /*
    "shipping": {
      "same_as_billing": "1",
      "city": "Kaiserslautern",
      "company": "A.B.C. Gerüstbau GmbH",
      "country_code": "DE",
      "email": "test@novanet.de",
      "first_name": "Norbert",
      "house_no": "9",
      "last_name": "Maier",
      "mobile": "+491747781423",
      "state": "Berlin",
      "street": "Hauptstr",
      "tel": "+49 089 123456",
      "zip": "66862"
    },
    */
    //"vat_id": "DE123456",
    //"tax_id": "123/123/123",
    //"reg_no": "HRB1234",
    //"session": "fedgrgst5653653hdgfsvgdsf622627e",
    //"no_nc": "1"
  },
  "transaction": {
    "test_mode": "###TEST_MODE###",
    "payment_type": "###PAYMENT_TYPE###",
    "amount": "###TRANSACTION_AMOUNT###",
    "currency": "###TRANSACTION_CURRENCY###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "hook_url": "###HOOK_URL###",
    "return_url": "###YOUR_RETURN_URL###",
    "error_return_url": "###YOUR_ERROR_RETURN_URL###",
    /*
    "invoice_ref": "###INVOICE_REF###",
    "mandate_ref": "###MANDATE_REF###",
    "mandate_date": "###MANDATE_DATE###",
    "invoice_no": "###INVOICE_NO###",
    "create_token": "1",
    "payment_data": {
      "token": "###TOKEN###"
    },	
    "due_dates": {
      "INVOICE": "2023-08-25",
      "PREPAYMENT": "2023-08-25",
      "DIRECT_DEBIT_SEPA": "2023-08-25",
      "CASHPAYMENT": "2023-08-25"
    },
    "debit_reason_1": "###DEBIT_REASON_1###"
    */
  },
  "hosted_page": {
    //"logo": "###YOUR_SHOP_LOGO###",
    //"css_url": "https://www.demoshop.de/custom.css",
    "hide_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL"
    ],
    "display_payments": [
      "CREDITCARD",
      "DIRECT_DEBIT_SEPA",
      "PREPAYMENT",
      "IDEAL",
      "ONLINE_TRANSFER",
      "PAYPAL"
    ],
    "hide_blocks": [
      "ADDRESS_FORM",
      "SHOP_INFO",
      "LANGUAGE_MENU",
      "HEADER",
      "TARIFF"
    ],
    "skip_pages": [
      "CONFIRMATION_PAGE",
      "SUCCESS_PAGE",
      "PAYMENT_PAGE"
    ],
	"url_shortener":"1",
	"link_expiry":"YYYY-MM-DD HH:MM:SS",
	//"link_notify":"['EMAIL']",
	//"return_target":"top",
	//"display_payments_mode":"['DIRECT', 'REDIRECT', 'INSTALMENT', 'SUBSCRIPTION']",

  },
  "subscription": {
    "interval": "2m",
    /*
    "trial_interval": "3m",
    "trial_amount": "150",
    "expiry_date": "YYYY-MM-DD"
    */
  },
  "instalment": {
    "interval": "2m",
    "cycles": "2"
  },
  /*
  "marketplace": {
    "tx_split": {
      "2261": "100",
      "2271": "120"
    },
    "commission_split": {
      "2261": {
        "percentage": "100",
        "amount": "700"
      },
      "2271": {
        "percentage": "97"
      }
    }
  },
  */
  "affiliate": {
    "subvendors": {
      "2261": "100",
      "2271": "120"
    },
    //"commission_type": "amount"
  },
  "invoicing": {
    "tax_percent": 2,
    "tax_amount": 2,
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    //"coupon_percent": 1,
    //"coupon_amount": 10,
    "product_details": [
      {
        //"code": "P001",
        "name": "Product name",
        //"group": "Product group",
        //"description": "Product description",
        "quantity": 2,
        "unit": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        //"discount": 0,
        //"note": "Note about the product"
      }
    ],
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    //"customer_support": "Max Mustermann | Email: support@yourshop.de",
    //"custom_invoice_no": "INV-32",
    "send_invoice_pdf": "1"
  },
  /*
  "cart_info": {
    "line_items": [
      {
        "category": "physical",
        "description": "",
        "name": "4 Jeans und shoe",
        "price": "3500",
        "quantity": 1
      }
    ],
    "items_shipping_price": "1500",
    "items_tax_price": "950",
    "items_handling_price": "500"
  },
  "custom": {
    "lang": "DE",
    "input1": "{{input1}}",
    "inputval1": "{{inputval1}}"
  }
  */
}", null, "application/json");
      request.Content = content;
      var response = client.SendAsync(request).Result;
      response.EnsureSuccessStatusCode();
      var responseText = response.Content.ReadAsStringAsync().Result;
      Console.WriteLine(responseText);
      return responseText;

    }

    public static void Main() {
      var testRequest = new Cancellation();
      testRequest.check_cancellation_request(); 
    }

  }
}

Referenz zu den Parametern

Authentifizierung über den Header

Header des HTTP-Aufrufs

Endpunkt URL(s)

Zahlung

URL des Endpunkts:

Autorisierung

URL des Endpunkts:

Liste der Parameter

merchantObjekt

customerObjekt

transactionObjekt

hosted_pageObjekt

subscriptionObjekt

instalmentObjekt

marketplaceObjekt

affiliateObjekt

invoicingObjekt

customObjekt

cart_infoObjekt

resultObjekt

transactionObjekt

merchant
Objekt

customer
Objekt

transaction
Objekt

hosted_page
Objekt

subscription
Objekt

instalment
Objekt

marketplace
Objekt

affiliate
Objekt

invoicing
Objekt

custom
Objekt

cart_info
Objekt

result
Objekt

transaction
Objekt