Invoice Creation

Payment Actions API Transaction Invoice Creation

Invoice Creation | Novalnet Docs

This action is used to create the Customer Invoice pdf generation.

This is only necessary if you use the additional feature of Novalnet for the invoice generation. But before, please activate the additional service named End customer invoicing on Novalnet Admin Portal under Additional Services menu.

Header Authentication

To authenticate your payment requests, use Novalnet's custom header authentication. The custom header field is constructed as follows:

Each header request is built using the Payment access key. To get your Payment Access Key, login to your Novalnet Admin Portal and navigate to the path Projects -> [Select Desired Project] -> API credentials -> Payment access key.
The Payment Access Key should be encoded using a variant of Base64.
The resultant base64_encoded value should be passed in the Novalnet's custom header key X-NN-Access-Key.
The custom header field is formulated in the format
X-NN-Access-Key:base64_encoded_value.

All requests must be carried out through an HTTPS connection along with the header values, otherwise, the request will fail with authorization error messages.

Your Payment Access Key carry many privileges, so be sure to keep them secure! Do not share your secret Payment Access Key in publicly accessible areas such as GitHub, client-side code, and so forth.

HTTP request headers

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

End Point

URL:

https://payport.novalnet.de/v2/transaction/invoice

<?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, 
];
?>

RESULT

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###'

RESULT

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###'
		},

RESULT

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###'
}

RESULT

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###"

RESULT

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###")

RESULT

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###")

RESULT

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###\"");

RESULT

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

Parameter List

Each request is separated into so-called objects which indicate an entity

Each parameter is marked with attributes Mandatory, Conditional, Optional. Based on your necessity, you can use these parameters accordingly.

- Icon denotes the parameter is used on the conditional attribute basis, and hovering on this icon will give you the details about that condition.

- Icon denotes the payment methods supported or relevant to the parameter defined, and hovering on this icon will give you the details of the list of payment methods supported.

transaction
Object

Parameter	Description
tid Integer Mandatory 12997200005200690	17 digit unique successful Novalnet transaction ID

invoicing
Object

Parameter

Description

net_amount
Integer
Mandatory
5000

Total amount (excl. tax) should be mentioned here

gross_amount
Integer
Mandatory
5000

Total amount (incl. tax) should be mentioned here

tax_percent
Integer
Mandatory
2

Overall invoice tax percent should be mentioned here

tax_amount
Integer
Mandatory
23

Overall invoice tax amount should be mentioned here

product_details
Multi-Dimensional Array

Hide child object

name
String
Mandatory
Product Name

Product item name

group
String
Optional
Product group

Product item group

description
String
Optional
Product description

Description of the each invoice detail entry

unit
String
Mandatory
ST

Product unit reference

quantity
Integer
Mandatory
2

Product quantity

unit_price
Integer
Mandatory
100

Each item price (in minor units), for eg:- Euro in Eurocents (5,22 € = 522)

total_price
Integer
Mandatory
200

Total price (price * quantity) (in minor units), for eg:- Euro in Eurocents (5,22 € = 522)

tax_amount
Integer
Mandatory
1

Tax amount (in minor units), for eg:- Euro in Eurocents (5,22 € = 522)

tax_percent
Integer
Mandatory
1

Tax percentage

discount
Integer
Optional
0

Identification of discount and normal product item detail.

The following values are permitted:

0 - for "Given invoice detail will be considered as normal product item detail"
1 - for "Given invoice detail will be considered as discount detail"

note
String
Optional
Note about the product

Additional note for each invoice detail

customer_support
String
Optional
Max Mustermann | Email: support@yourshop.de Customize the customer support details here notice
Object
Optional
{'1' : 'Notice 1', '2' : 'Notice 2', '3' : 'Notice 3'} The notification which you wants to provide to the end-customer in invoice PDF. You can add upto three notifications per transaction. reference
String
Conditional
4-20-270 The reference value returned during the Initial (DEBIT) transaction Invoice process

Note: It is mandatory for the following types: CREDIT, CORRECTION, CANCEL date
String
Optional
2026-08-19 The date in which the invoice need to be generated

Note: The format to be specified is "YYYY-MM-DD".

type
String
Optional
DEBIT The invoice type denotes the reason for the invoice generation

The following values are permitted:

DEBIT for "Regular invoice (by default)"
CREDIT for "Credit note invoice"
CORRECTION for "Invoice correction"
CANCEL for "Cancellation invoice"

custom_invoice_no
String
Optional
INV-32 A customized invoice number which will be used instead of the default system generated invoice number.

Note: The value should be unique for each invoice generation request. send_invoice_pdf
Integer
Conditional
1 The end customer will receive an Invoice PDF as an attachment in the invoicing email.

1 - send the Invoice PDF to the end customer
0 - skip the delivery of the Invoice PDF.

coupon_percent
Integer
Optional
1 Discount percentage assigned for the coupon. coupon_amount
Integer
Optional
10 Discount amount calculated from the cart value. accounting
Object
Hide child object
end_date
String
Optional
2022-02-25 The end date of Invoice accounting

custom
Object

Parameter	Description
lang String Optional EN	Language Code as two characters as per ISO 639-1 standards
input1..7 String Optional psp	Custom Arbitrary key-value pairs that can be specified when creating the invoice and based on request will be reflected in the invoice PDF.
inputval1..7 String Optional novalnet	Custom Arbitrary key-value pairs that can be specified when creating the invoice and based on request will be reflected in the invoice PDF.

customer
Object

result
Object

Parameter	Description
status_text String Mandatory Successful	Developer-facing message that describes the error encountered and possible steps to correct it.
status String Mandatory SUCCESS\|FAILURE	Status about the API for the transaction
status_code Integer Mandatory 100	Status code about the API for the transaction

invoicing
Object

Parameter	Description
reference String Mandatory 4-20-270	Customer invoice reference number
related_tokens String Mandatory {"4-20-270":"821a01f41a0b4eedf9b3ea6f27d80962", "4-20-272":"c948ac7f3e3060dcea9c7bb7c3510492"}	The key value pair of invoice reference number and invoice token value. You can use the token value in the URL: https://mis.novalnet.de/downloadpdf/view/{TOKEN}.pdf to load the invoice pdf
token String Mandatory c948ac7f3e3060dcea9c7bb7c3510492	An unique invoice token value. You can use this token value in the URL: https://mis.novalnet.de/downloadpdf/view/{token}.pdf to load the invoice pdf

<?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/transaction/invoice';

// 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 Transaction Data
$data['transaction'] = [

	// the TID used to create the invoice
    'tid'         => '###NOVALNET_TID###',  
];

// Invoicing Data, used for the additional invoicing service - Optional data object - Decomment it based on your usage) 
$data['invoicing'] = [

    // Overall invoice tax percent should be mentioned here
    'tax_percent'      => 2,
                       
    // Overall invoice tax amount should be mentioned here
    'tax_amount'       => 2,
                       
    // Total amount (excl. tax) should be mentioned here
    'net_amount'       => 5000,
                       
    // Total amount (incl. tax) should be mentioned here              
    'gross_amount'     => 5000,
    
    // The date in which the invoice need to be generated       
    'date'    		   => '2025-09-20',
    
    // The type of the invoice           
    'type'     		   => 'DEBIT',
    
    // Individual product details should be mentioned here
    'product_details'  => [
      [
        'code'          => 'P001',
        'name'          => 'Product name',
        'group'         => 'Product group',
        'description'   => 'Product description',
        'quantity'      => 2,
        'unit'          => 'ST',
        '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'
];

// Custom Data - Optional object - Decomment it based on your usage
$data['custom'] = [
	
	// Shopper's selected language in shop
	'lang'      => 'EN',
	
	// 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;
}

?>

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

CURL

curl --location --request POST 'https://payport.novalnet.de/v2/transaction/invoice' -H 'Content-Type: application/json' -H 'Charset:utf-8' -H 'Accept: application/json' -H 'X-NN-Access-Key: ###YOUR_ENCODED_PAYMENT_ACCESS_KEY###' -d '{"transaction":{"tid":"###NOVALNET_TID###"},"invoicing":{"tax_percent":2,"tax_amount":2,"net_amount":5000,"gross_amount":5000,"date":"2025-09-20","type":"DEBIT","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"},"custom":{"lang":"EN"}}';

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

NODEJS

#!/usr/bin/node
// request for updating transaction details script using the standard https library

const https = require('https');
// data sent in the body of the request
const postData = JSON.stringify({
  "transaction": {
    "tid": "###NOVALNET_TID###",
  },
  "invoicing": {
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    "product_details": [
      {
        "code": "P001",
        "name": "Product name",
        "group": "Product group",
        "description": "Product description",
        "unit": "ST",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        "note": "Note about the product"
      }
    ],
    "customer_support": "Max Mustermann | Email: mailto:support@yourshop.de",
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    "send_invoice_pdf": 1,
    "custom_invoice_no": "INV-32"
  },
  "custom": {
    "lang": "EN"
  }
});

const options = {
  'hostname': 'payport.novalnet.de',
  'port': 443,
  'path': '/v2/transaction/invoice',

  '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();

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

PYTHON

#!/usr/bin/python3

import http.client
import json

CONN = http.client.HTTPSConnection("payport.novalnet.de")
PAYLOAD = json.dumps({
    "transaction": {
        "tid": "###NOVALNET_TID###"
    },
    "invoicing": {
		"net_amount": 5000,
		"gross_amount": 5000,
		"tax_percent": 2,
		"tax_amount": 2,
		"product_details": [
		  {
			"code": "P001",
			"name": "Product name",
			"group": "Product group",
			"description": "Product description",
			"unit": "ST",
			"quantity": 2,
			"unit_price": 100,
			"total_price": 200,
			"tax_amount": 1,
			"tax_percent": 1,
			"note": "Note about the product"
		  }
		],
		"customer_support": "Max Mustermann | Email: mailto:support@yourshop.de",
		"notice": {
		  "1": "Notice 1",
		  "2": "Notice 2",
		  "3": "Notice 3"
		},
		"send_invoice_pdf": 1,
		"custom_invoice_no": "INV-32"
	  },
    "custom": {
        "lang": "EN"
    }
})
HEADERS = {
    'Content-Type': 'application/json',
    'Charset': 'utf-8',
    'Accept': 'application/json',
    'X-NN-Access-Key': '###YOUR_ENCODED_PAYMENT_ACCESS_KEY###'
}
CONN.request("POST", "/v2/transaction/invoice", PAYLOAD, HEADERS)
RES = CONN.getresponse()
DATA = RES.read()
print(DATA.decode("utf-8"))

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

RUBY

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

url = URI("https://payport.novalnet.de/v2/transaction/invoice")

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

request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Charset"] = "utf-8"
request["X-NN-Access-Key"] = "###YOUR_ENCODED_PAYMENT_ACCESS_KEY###"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "transaction": {
    "tid": "###NOVALNET_TID###"
  },
  "invoicing": {
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    "product_details": [
      {
        "code": "P001",
        "name": "Product name",
        "group": "Product group",
        "description": "Product description",
        "unit": "ST",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        "note": "Note about the product"
      }
    ],
    "customer_support": "Max Mustermann | Email: mailto:support@yourshop.de",
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    "send_invoice_pdf": 1,
    "custom_invoice_no": "INV-32"
  },
  "custom": {
    "lang": "EN"
  }
})

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

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

package main

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

func main() {

  url := "https://payport.novalnet.de/v2/transaction/invoice"
  method := "POST"

  payload := strings.NewReader(`{
  "transaction": {
    "tid": "###NOVALNET_TID###"
  },
  "invoicing": {
    "net_amount": 5000,
    "gross_amount": 5000,
    "tax_percent": 2,
    "tax_amount": 2,
    "product_details": [
      {
        "code": "P001",
        "name": "Product name",
        "group": "Product group",
        "description": "Product description",
        "unit": "ST",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "tax_amount": 1,
        "tax_percent": 1,
        "note": "Note about the product"
      }
    ],
    "customer_support": "Max Mustermann | Email: mailto:support@yourshop.de",
    "notice": {
      "1": "Notice 1",
      "2": "Notice 2",
      "3": "Notice 3"
    },
    "send_invoice_pdf": 1,
    "custom_invoice_no": "INV-32"
  },
  "custom": {
    "lang": "EN"
  }
}`)

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

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

  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))
}

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

JAVA

// request for updating the details of an existing transaction 
/* 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 java.io.*;

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 InvoiceCreation {
  public static void main(String []args) throws Exception{
    Unirest.config().connectTimeout(1000).socketTimeout(2000);

    HttpResponse<string> response = Unirest.post("https://payport.novalnet.de/v2/transaction/invoice")
      .header("Content-Type", "application/json")
      .header("Charset", "utf-8")
      .header("Accept", "application/json")
      .header("X-NN-Access-Key", "###YOUR_ENCODED_PAYMENT_ACCESS_KEY###")
      .body("{\n  \"transaction\": {\n    \"tid\": \"###NOVALNET_TID###\"},\n     \"invoicing\":{\n        \"net_amount\":5000,\n        \"gross_amount\":5000,\n        \"tax_percent\":2,\n        \"tax_amount\":2,\n        \"product_details\":[\n            {\n            \"code\":\"P001\",\n            \"name\":\"Product name\",\n            \"group\":\"Product group\",\n            \"description\":\"Product description\",\n            \"unit\":\"ST\",\n            \"quantity\":2,\n            \"unit_price\":100,\n            \"total_price\":200,\n            \"tax_amount\":1,\n            \"tax_percent\":1,\n            \"note\":\"Note about the product\"\n        }\n        ],\n        \"customer_support\":\"Max Mustermann | Email: mailto:support@yourshop.de\",\n        \"notice\":{\n            \"1\":\"Notice 1\",\n            \"2\":\"Notice 2\",\n            \"3\":\"Notice 3\"\n        },\n        \"send_invoice_pdf\":1,\n        \"custom_invoice_no\":\"INV-32\"\n    },\n  \"custom\": {\n    \"lang\": \"EN\"\n  }\n}")
      .asString();
    
    System.out.println(response.getBody());
  }
}</string>

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

CSHARP

using System;
using System.Net.Http;

namespace InvoiceCreationRequest
{
  public class InvoiceCreation {

    public string check_invoice_creation_request() {

      var client = new HttpClient();
      var request = new HttpRequestMessage(HttpMethod.Post, "https://payport.novalnet.de/v2/transaction/invoice");

      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("{\n  \"transaction\": {\n    \"tid\": \"###NOVALNET_TID###\"},\n     \"invoicing\":{\n        \"net_amount\":5000,\n        \"gross_amount\":5000,\n        \"tax_percent\":2,\n        \"tax_amount\":2,\n        \"product_details\":[\n            {\n            \"code\":\"P001\",\n            \"name\":\"Product name\",\n            \"group\":\"Product group\",\n            \"description\":\"Product description\",\n            \"unit\":\"ST\",\n            \"quantity\":2,\n            \"unit_price\":100,\n            \"total_price\":200,\n            \"tax_amount\":1,\n            \"tax_percent\":1,\n            \"note\":\"Note about the product\"\n        }\n        ],\n        \"customer_support\":\"Max Mustermann | Email: mailto:support@yourshop.de\",\n        \"notice\":{\n            \"1\":\"Notice 1\",\n            \"2\":\"Notice 2\",\n            \"3\":\"Notice 3\"\n        },\n        \"send_invoice_pdf\":1,\n        \"custom_invoice_no\":\"INV-32\"\n    },\n  \"custom\": {\n    \"lang\": \"EN\"\n  }\n}", 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 InvoiceCreation();
      testRequest.check_invoice_creation_request(); 
    }

  }
}

{
   "transaction":{
      "tid":"###NOVALNET_TID###"
   },
   "invoicing":{
      "tax_percent":2,
      "tax_amount":2,
      "net_amount":5000,
      "gross_amount":5000,
      "date":"###INVOICE_DATE###",
      "type":"DEBIT",
      "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"
   },
   "custom":{
      "lang":"EN"
   }
}

{
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
   },
   "invoicing":{
      "reference":"###INVOICE_REFERENCE###",
      "related_tokens": {
		 "###INVOICE_REFERENCE###":"###INVOICE_TOKEN###"
      },
      "token":"###INVOICE_TOKEN###"
   }
}

Parameter	Description
start_date String Optional 2022-02-14	The start date of Invoice accounting