By Transaction ID

Payment Actions API Retrieve Transaction By Transaction ID

By Transaction ID | Novalnet Docs

Retrieve all the information related to the transaction using the unique identifier from Novalnet - transaction ID (TID).

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/details

<?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

custom
Object

Parameter	Description
lang String Optional EN	Language Code as two characters as per ISO 639-1 standards

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
additional_message String Conditional Card lost	Additional message about the transaction
status_code Integer Mandatory 100	Status code about the API for the transaction

transaction
Object

Parameter

Description

tid
Integer
Mandatory
12997200005200690

17 digit unique Novalnet transaction ID

The current status of the payment

payment_type
String
Mandatory
CREDITCARD

Transaction's Payment type (defined in Novalnet). Refer this section for the payment type details.

amount
Integer
Conditional
522

The total amount to be charged from the customer includes the line items, tax, shipping and additional costs (in minor units), e.g., Euro in Eurocents (5,22 € = 522).

currency
String
Mandatory
EUR

The currency in which the transaction is being processed. The three-character currency code as defined in ISO-4217.

order_no
String
Conditional
123456789

Order's unique identifier received from the shop

test_mode
Integer
Mandatory
0

Denotes the processing mode of the transaction.

Possible values:

0 if "The transaction is in LIVE mode"
1 if "The transaction is in TEST mode and no real cashflow happens here"

date
String
Conditional
2026-08-21 08:10:28

Transaction date (incl. time)

Format: YYYY-MM-DD HH:MM:SS

txn_secret
String
Conditional
fd77014683544a21ed47d468fa24e27b

Transaction secret is a temporary identifier for the payment types with the redirect flow and it travels across the transaction, useful in verifying the payment result

due_date
String
Optional
2026-09-04

For credit transfers: Date by which the customer must settle the payment.
For SEPA Direct Debit: The date by which the customer must be debited by their bank. If this field is left empty, Novalnet will initiate the debit on the third working day after the transaction date.

3 - 14 for Direct Debit SEPA
> 7 for Invoice and Prepayment

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

invoice_ref
String
Optional
BNR-14-213257

The reference related to your customer's invoice of the order. The maximum length of this parameter is 50 characters, if you want to provide more than 50 characters then please use the custom object given below through the parameters input1..7 and inputval1..7

last_success_tid
Integer
Optional
14149400012624203

Upon successful execution of the verify payment data check, the previously used payment data's TID will also be returned here if found.
Refer the section verify payment data to know more details about the handling.

payment_data
Object

This objects contains the Customer's secured Payment data information
Hide child object

account_holder
String
Optional
Max Mustermann

Name of the bank account holder

iban
String
Conditional
DE2XXXXXXXXXXXXXX956

IBAN (International Bank Account Number) of the bank account holder

bic
String
Conditional
CMCIDEDDXXX

BIC (Bank Identifier Code) of the bank account holder

card_brand
String
Conditional
VISA

Credit/Debit Card brand

card_holder
String
Conditional
Max Mustermann

Credit/Debit Card holder

card_number
String
Conditional
XXXXXXXXXXXX0000

Masked Card number

card_expiry_month
Integer
Conditional
12

Credit/Debit Card Expiry month

card_expiry_year
Integer
Conditional
2020

Credit/Debit Card Expiry year

cc_3d
Integer
Conditional
1

This parameter indicates if you want to perform 3D Secure authentication on a transaction or not. When set to 1, the transaction will be processed as 3D Secure transaction.

paypal_account
String
Conditional
test@novalnet.de

Email address linked to the PayPal purchase account of the customer

paypal_transaction_id
String
Conditional
32G196671K367213E

Transaction ID from PayPal

last_four
String
Optional
1091

The Last four number of Credit Card

account_number
Integer
Mandatory
XXXXX6789

Account Number of the bank account holder.

routing_number
Integer
Mandatory
XXXXX0730

Routing Number of the bank account holder.

marker
String
Optional
DEF20140103987 A unique tag used in the APIs to group specific transactions across customers, projects for statistical overview or filtering in reporting. For example, if the transactions that were placed in the store with a particular offer need to be grouped separately, then passing this parameter with a value of "FESTIVALOFFER" can allow you to list these transactions distinctively. identifiers
Multi-Dimensional Array
The identifiers is used to tag and group transactions in a flexible way, similar to the marker parameter but with support for multiple categories. Each identifier consists of a type and a value, allowing transactions to be grouped or filtered across different dimensions (e.g., offers, customer segments, projects).
Hide child object
value
String
Conditional
FESTIVAL|B2B Defines the corresponding identifier within the selected type.

Ex: If type = "OFFER", then value could be "FESTIVAL".
Ex: If type = "CUSTOMER_TYPE", then value could be "B2B".

Note: Allowed characters include alphanumeric letters (A–Z, a–z, 0–9), underscores (_), hyphens (-), spaces, periods (.), and accented characters such as umlauts (ä, ö, ü). The maximum permitted length of this parameter is 70 characters.

bank_details
Object This object contains the bank details to which the customer has to transfer the transaction amount
Hide child object
bank_code
Integer
Conditional
74020100 Bank code bank_name
String
Conditional
Raiffeisenlandesbank O Zndl Sddeutschland Bank name bank_place
String
Conditional
Passau Place of the bank account_holder
String
Conditional
Max Mustermann Name of the bank account holder iban
String
Conditional
DE24300209002411761956 IBAN (International Bank Account Number) of the bank account holder bic
String
Conditional
CMCIDEDDXXX BIC (Bank Identifier Code) of the bank account holder qr_image
String
Conditional
https://nnt.ag/epcqr/15339600072003130.png This parameter provides a hosted link to a dynamically generated QR code for applicable Pay-By-Invoice transactions. The QR code is created for all pending, authorized, and successful transactions (including subscriptions and instalment renewals) when the transaction amount is greater than zero.

For marketplace transactions, a single QR code is generated for the total order amount. If the transaction amount or order number is modified, the QR code is automatically regenerated and updated on the same link to always reflect the latest transaction details.

fraud_check
Object This objects contains the Fraud check details, for example: Buergal score
Hide child object
trader_name
String
Mandatory
Mustermann GmbH Trader name belonging to this VAT ID trader_address
String
Mandatory
Musterstr, 2, 12345, Musterhausen Trader address belonging to this VAT ID buergel_score_value
String
Optional
0 The resultant CRIF Buergel Score value from the fraud check

partner_payment_reference
Integer
Conditional
999999919 The payment reference for the Multibanco payment type. Using this reference, the customer pays in online portal or in the Multibanco ATM to complete the purchase service_supplier_id
Integer
Conditional
11854 Service supplier ID from Multibanco hook_url
String
Conditional
https://www.demoshop.de/webhook Notification/Webhook URL to receive the information about the notification events that occurs for each transaction. To know more about the notification and events, refer this section. tid_payment
Integer
Optional
12997200005200690 The original payment TID which will be sent during the transaction response status_code
Integer
Mandatory
100 Status code for the transaction credit_reason_1
String
Optional
www.test.com The credit reason1 defines the text on the customer's proof of payment credit_reason_2
String
Optional
Test Product The credit reason2 defines the text on the customer's proof of payment credit_reason_3
String
Optional
ABC Company The credit reason3 defines the text on the customer's proof of payment order_date
String
Conditional
2021-06-10 Original purchase date, for which the cashback or transaction is being processed

Note: The format to be specified is "YYYY-MM-DD". order_amount
Integer
Conditional
2000 Original purchase amount, for which the cashback or transaction is being processed order_reference
String
Conditional
XXXYYYZZZ Original purchase reference or order number, for which the cashback or transaction is being processed credit_reason_4
String
Optional
INV-1234 The credit reason4 defines the text on the customer's proof of payment authorization
Object
Hide child object
auto_action
String
Conditional
CAPTURE|VOID It contains the action (CAPTURE/VOID) going to be carried out on the expiry of the authorization.Note: Merchant can customize these action on Novalnet Admin Portal.

mandate_ref
String
Optional
NN-12345678901234567 Unique mandate reference of the written SEPA mandate, this reference will be displayed in the end-customer's bank statement. If not provided, by default TID will be considered mandate_date
String
Optional
2026-08-21 Start date at which the end-customer allowed Novalnet or the merchant to book from his/her account. The date of signature of SEPA mandate. If not provided, by default the transaction date will be considered.

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

invoice_no
String
Optional
852963 Unique identifier invoice number from the shop partner_payment_url
String
Mandatory
https://pagar.wepayout.co/?hash=XXXXXX The payment reference for the Boleto payment type. It contains the bank slip URL. debit_reason_1..5
String
Optional
www.test.com The debit reason defines the text on the customer's proof of payment (e.g., bank statement records and similar).Note: Each debit reason can have a maximum of 27 characters, with an overall length of 140 characters for all five debit reasons. The debit reason is case-sensitive, allowing characters from a to z, A to Z, and 0 to 9. Only space and hyphens are allowed, while other special characters and symbols are taken as spaces.

merchant
Object

Parameter	Description
vendor Integer Mandatory 4	Your Merchant ID
project Integer Mandatory 14	Your Project ID

customer
Object

Parameter

Description

gender
String
Optional
u|m|f

Customer's gender

Possible values:

m if "Male"
f if "Female"
u if "Unknown"

first_name
String
Mandatory
Max

Firstname of the customer.

last_name
String
Mandatory
Mustermann

Lastname of the customer.

email
String
Mandatory
test@novanet.de

Customer's billing email address

billing
Object

This object contains the customer's billing information
Hide child object

house_no
String
Conditional
2

Customer's billing house extension

street
String
Mandatory
Musterstr

Customer's street name

Note: The house_no parameter mentioned above can also be passed along with the street parameter by using anyone of the following separators "/", "-", ".", "," and space

city
String
Mandatory
Musterhausen

Customer's city

zip
String
Mandatory
12345

Customer's postal code

country_code
String
Mandatory
DE

Customer's billing country. The two-character country ISO code as defined in ISO-3166-1 alpha-2

district
String
Conditional
Pankow

The customer's district from the billing information, which identifies a specific administrative region within a state or province.

Note: Allowed characters are alphanumeric, numbers, space, hyphen, apostrophe, period and other accented characters such as umlauts, Latin characters.

state
String
Conditional
Berlin

The customer's billing state identifies a specific region within a country. Novalnet currently supports this parameter in three formats:

ISO 3166-2 State Codes: Provide the state using the state code according to the ISO 3166-2 standard for seamless transmission during payment processing. For example, state codes (such as "BE" for Berlin) are typically 2 characters long.
Country Code Format: The state code in country code format for Germany is "DE-" followed by the 2-letter state code (e.g., "DE-BE" for Berlin, "DE-HH" for Hamburg).
Full State Names: Full state names can be provided using string characters with a maximum length of up to 50 characters (e.g., "Berlin", "Hamburg").

Note: Allowed characters are alphanumeric, numbers, space, hyphen, apostrophe, period and other accented characters such as umlauts, Latin characters.

customer_ip
String
Mandatory
127.0.0.1 Customer's IP address customer_no
String
Optional
12345 Customer's unique identifier from the shop birth_date
String
Optional
1992-06-10 Customer's date of birth. The format to be specified is "YYYY-MM-DD"

Note: Mandatory only for B2C for processing guaranteed and installment payments such as GUARANTEED_DIRECT_DEBIT_SEPA, GUARANTEED_INVOICE, INSTALMENT_DIRECT_DEBIT_SEPA, INSTALMENT_INVOICE

tel
String
Optional
+49 089 123456 Customer's telephone number mobile
String
Optional
+491747781423 Customer's mobile number fax
String
Optional
+49 89 654321 Customer's fax number shipping
Object This object contains the customer's shipping information
Hide child object
first_name
String
Optional
Max Customer's shipping firstname last_name
String
Optional
Mustermann Customer's shipping lastname email
String
Optional
test@novanet.de Customer's shipping email address company
String
Optional
ABC GmbH Organization name of the shipping address house_no
String
Optional
2 Customer's shipping house extension street
String
Optional
Musterstr Customer's shipping street name city
String
Optional
Musterhausen Customer's shipping city zip
String
Optional
12345 Customer's postal code country_code
String
Optional
DE Customer's shipping country. The two-character country ISO code as defined in ISO-3166-1 alpha-2 tel
String
Optional
+49 089 123456 Customer's shipping telephone number mobile
String
Optional
+491747781423 Customer's shipping mobile number state
String
Optional
Berlin The customer's shipping state identifies a specific region within a country. Novalnet currently supports this parameter in three formats:

ISO 3166-2 State Codes: Provide the state using the state code according to the ISO 3166-2 standard for seamless transmission during payment processing. For example, state codes (such as "BE" for Berlin) are typically 2 characters long.
Country Code Format: The state code in country code format for Germany is "DE-" followed by the 2-letter state code (e.g., "DE-BE" for Berlin, "DE-HH" for Hamburg).
Full State Names: Full state names can be provided using string characters with a maximum length of up to 50 characters (e.g., "Berlin", "Hamburg").

Note: Allowed characters are alphanumeric, numbers, space, hyphen, apostrophe, period and other accented characters such as umlauts, Latin characters. district
String
Optional
Pankow The customer's district from the shipping information, which identifies a specific administrative region within a state or province.

Note: Allowed characters are alphanumeric, numbers, space, hyphen, apostrophe, period and other accented characters such as umlauts, Latin characters.

vat_id
String
Optional
DE123456 Organization's VAT ID tax_id
String
Optional
123/123/123 The parameter represents the unique tax identification number assigned to a customer or company. This is essential for compliance with tax regulations and enables accurate identification of businesses in B2B transactions.Note: Allowed characters are alphanumeric, numbers, space, hyphen and period. reg_no
String
Optional
HRB1234 Organization's registration number session
String
Optional
fedgrgst5653653hdgfsvgdsf622627e Customer's session ID from the shop no_nc
Integer
Optional
1 This parameter will be returned, If you opted for no_nc option

subscription
Object

Parameter	Description
subs_id Integer Optional 12345678	A unique ID generated for the subscription in Novalnet
next_cycle_date String Mandatory 2026-09-20 08:10:28	The next recurring cycle date
amount Integer Conditional 522	The amount to be booked for the subscription (in minor units), e.g.:- Euro in Eurocents (5,22 € = 522).
tid Integer Conditional 12997200005200690	17 digit unique Novalnet transaction ID
payment_type String Conditional CREDITCARD	Transaction's Payment type (defined in Novalnet). Refer this section for the payment type details.
currency String Conditional EUR	The currency in which the transaction is being processed. The three-character currency code as defined in ISO-4217.
reason String Optional Reason	Reference value which is passed during refund/subscription cancel/chargeback/return debit process
status String Optional ACTIVE\|INACTIVE\|SUSPENDED\|PENDING	The current status of the subscription. The possible values are ACTIVE\|INACTIVE\|SUSPENDED\|PENDING.

instalment
Object

Parameter	Description
next_cycle_date String Conditional 2026-09-20 08:10:28	The next instalment cycle date
cycle_amount Integer Mandatory 2778	The instalment cycle amount
tid Integer Optional 12997200005200690	17 digit unique Novalnet transaction ID
cycles_executed Integer Optional 2	The number of instalment cycles executed at this point
pending_cycles Integer Optional 4	The number of instalment cycles remaining to be executed
currency String Optional EUR	The currency in which the transaction is being processed. The three-character currency code as defined in ISO-4217.
cycle_dates String Optional {"1":"2026-08-21 08:10:28","2":"2026-09-21 08:10:28","3":"2026-10-21 08:10:28"}	The instalment cycle dates

marketplace
Object

Parameter	Description
followup_booking String Optional SUCCESS\|FAILURE	Denotes the status about the affiliate's followup booking
tid Integer Optional 12997200005200690	17 digit unique Novalnet transaction ID
total_amount Integer Conditional 2500	The total amount booked for the marketplace order

invoicing
Object

Parameter	Description
token 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

custom
Object

Parameter	Description
input1..7 String Optional psp	Arbitrary key-value pairs that can be specified when booking and to be easily transferred back to the booking
inputval1..7 String Optional novalnet	Arbitrary key-value pairs that can be specified when booking and to be easily transferred back to the booking

collection
Object

Parameter	Description
amount Integer Conditional 522	The amount represents the cumulative value, including the principal claim and all associated fees or charges that have been cancelled
currency String Conditional EUR	The currency in which the transaction is being processed. The three-character currency code as defined in ISO-4217.
reference String Conditional Reference	Reference number for the collection process
status_text String Conditional successful	Current status of the collection process
date String Conditional 2020-06-10	The Date on which the case is submitted to the collection agency.
claim_amount Integer Conditional 522	Represent the principal amount that was cancelled.
claim_charges Integer Conditional 800	Claim charges represent either return debit or chargeback amount that was cancelled
claim_fee Integer Conditional 200	Charges cancelled for sending payment reminders via post, email, or other additional services.

reminder
Object

Parameter	Description
amount Integer Conditional 522	Amount represents the cumulative value that includes principal and relevant claim fees/charges.
currency String Conditional EUR	The currency in which the transaction is being processed. The three-character currency code as defined in ISO-4217.
date String Conditional 2020-06-10	Mentions the due date to settle a payment.
claim_amount Integer Conditional 522	Represent the principal amount that was cancelled.
claim_charges Integer Conditional 800	Claim charges represent either return debit or chargeback amount that was cancelled
claim_fee Integer Conditional 200	Charges cancelled for sending payment reminders via post, email, or other additional services.
due_date String Optional 2020-04-14	Reminder due date

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

// 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['transaction'] = [

	// The TID for which you need to get the details
    'tid' => '###NOVALNET_TID###', 
];

// Custom Data
$data['custom'] = [
	
	// Merchant's selected language
	'lang'      => 'EN',
];

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

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

CURL

curl --location --request POST 'https://payport.novalnet.de/v2/transaction/details' -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###"},"custom":{"lang":"EN"}}';

{
   "transaction":{
      "tid":###NOVALNET_TID###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

NODEJS

#!/usr/bin/node
// retrieves transaction details via the API

const https = require('https');
// data sent in the body of the request
const postData = JSON.stringify({
    "transaction": {
        "tid": "###NOVALNET_TID###"
    },
    "custom": {
        "lang": "EN"
    }
});

const options = {
  hostname: 'payport.novalnet.de',
  port: 443,
  path: '/v2/transaction/details',
  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###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

PYTHON

#!/usr/bin/python3
""" sends request for retrieving transaction details to API, version 2 """
# retrieves transaction details via the API

import http.client
import json

CONN = http.client.HTTPSConnection("payport.novalnet.de")
PAYLOAD = json.dumps({
    "transaction": {
        "tid": "###NOVALNET_TID###"
    },
    "custom": {
        "lang": "EN"
    }
})
HEADERS = {
    'Content-Type': 'application/json',
    'X-NN-Access-Key': '"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###"'

}
CONN.request("POST", "/v2/transaction/details", PAYLOAD, HEADERS)
RES = CONN.getresponse()
DATA = RES.read()
print(DATA.decode("utf-8"))

{
   "transaction":{
      "tid":###NOVALNET_TID###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

RUBY

#!/usr/bin/ruby
# retrieves transaction details 

require "uri"
require "json"
require "net/http"

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

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

request = Net::HTTP::Post.new(url)
request["X-NN-Access-Key"] = "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\""
request["Content-Type"] = "application/json"
request["Accept"] = "application/json"
request["Charset"] = "utf-8"
request.body = JSON.dump({
  "transaction": {
    "tid": "###NOVALNET_TID###"
  },
  "custom": {
    "lang": "EN"
  }
})

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

{
   "transaction":{
      "tid":###NOVALNET_TID###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

package main
// test script for retrieving transaction details
import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

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

  payload := strings.NewReader(`{
  "transaction": {
    "tid": "###NOVALNET_TID###"
  },
  "custom": {
    "lang": "EN"
  }
}`)

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

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

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

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

JAVA

//package transaction_details;
/* retrieves transaction details via the API */

/* 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 TransactionDetailsRequest {
  public void send_test_request() {
    Unirest.config().connectTimeout(1000).socketTimeout(2000);
    HttpResponse<string> response = Unirest.post("https://payport.novalnet.de/v2/transaction/details")
      .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  },\n  \"custom\": {\n    \"lang\": \"EN\"\n  }\n}")
      .asString();
    System.out.println(response.getBody());
  }
  public static void main(String[] args) {
    TransactionDetailsRequest requestClient = new TransactionDetailsRequest();
    requestClient.send_test_request();
  }

}</string>

{
   "transaction":{
      "tid":###NOVALNET_TID###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

CSHARP

using System;
using System.Net.Http;

namespace TransactionDetailsRequest 
{
  public class TransactionDetailsRequest {

    public string check_vat_id_request() {

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

      request.Headers.Add("Accept", "application/json");
      request.Headers.Add("Charset", "utf-8");

      request.Headers.Add("X-NN-Access-Key", "\"###YOUR_ENCODED_PAYMENT_ACCESS_KEY###\"");
      var content = new StringContent("{\n  \"transaction\": {\n    \"tid\": \"###NOVALNET_TID###\"\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 TransactionDetailsRequest();
      testRequest.check_vat_id_request(); 
    }

  }
}

{
   "transaction":{
      "tid":###NOVALNET_TID###
   }
}

{
   "customer":{
      "billing":{
         "city":"Musterhausen",
         "country_code":"DE",
         "house_no":"2",
         "street":"Musterstr",
         "zip":"12345"
	   },
      "customer_ip": "###CUSTOMER_IP###",
      "customer_no": "###CUSTOMER_NUMBER###",
      "email":"test@test.de",
      "first_name":"Max",
      "gender":"u",
      "last_name":"Mustermann"
	},
   "merchant":{
      "project":6120,
      "vendor":4
	},
   "result":{
      "status":"SUCCESS",
      "status_code":100,
      "status_text":"Successful"
	},
   "transaction":{
      "amount": ###TRANSACTION_AMOUNT###,
      "currency": "###TRANSACTION_CURRENCY###",
      "date": "###TRANSACTION_DATE###",
      "order_no": "###TRANSACTION_ORDER_NUMBER###",
      "payment_data":{
         "card_brand":"VISA",
         "card_expiry_month":2,
         "card_expiry_year":2022,
         "card_holder":"Max Mustermann",
         "card_number":"420000XXXXXX0000",
         "token":"R02cB22w22w00a02c-R22w22w22wNJV-V22w20uZ14o04eB18sBRZVVX14o22wR1"
      },
      "payment_type":"CREDITCARD",
      "status":"CONFIRMED",
      "status_code": 100,
      "test_mode": ###TEST_MODE###,
      "tid": ###NOVALNET_TID###
	}
}

Parameter	Description
type String Conditional OFFER\|CUSTOMER_TYPE	Defines the category or dimension under which the transaction should be grouped. Note: Only alphanumeric characters (A–Z, a–z, 0–9), underscores (_), and hyphens (-) are allowed. The maximum permitted length of this parameter is 70 characters.

Parameter	Description
bank_account Integer Conditional 208604985	Bank account number

Parameter	Description
vat_request_identifier String Mandatory ARPIAAAAWq2Fk-CV	VAT ID of the company

Parameter	Description
expiry_date String Conditional 2021-05-25	It contains the date on which the authorization will get expiryNote: Merchant can customize these date on Novalnet Admin Portal.

Parameter	Description
same_as_billing Integer Optional 1	Pass this parameter if the billing and the shipping address are identical. Also note that the entire shipping child object is optional