API Docs
Code Examples
Database
CLI Tools
Performance
Guides
Web Services
Dev Tools
Comprehensive APIs, SDKs, and tools to integrate payments seamlessly. From simple transactions to complex marketplace solutions, we've got you covered.
Choose your integration method and start accepting payments with just a few lines of code. Our flexible platform supports multiple integration approaches.
Sign up for free and get instant access to our sandbox environment
Explore our comprehensive guides and API references
Use our APIs to seamlessly enable secure transactions in your project.
Switch to live mode and start accepting real payments
Quick integration with pre-built UI
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": "125.21.64.254",
"customer_no": "1234",
"tel": "+49 089 123456",
"mobile": "+49 174 7781423",
"billing": {
"house_no": "2",
"street": "Musterstr",
"city": "Musterhausen",
"zip": "12345",
"country_code": "DE"
}
},
"transaction": {
"amount": "100",
"currency": "EUR",
"test_mode": "1",
"order_no": "789559",
"return_url": "YOUR_RETURN_URL",
"error_return_url": "YOUR_ERROR_RETURN_URL",
"hook_url": "YOUR_WEBHOOK_URL",
},
"hosted_page": {
"logo": "YOUR_LOGO_URL",
"hide_payments": [
"PRZELEWY24",
"DIRECT_DEBIT_ACH",
"BLIK"
],
"hide_blocks": [
"ADDRESS_FORM",
"SHOP_INFO",
"LANGUAGE_MENU",
"HEADER",
"TARIFF"
],
"skip_pages": [
"CONFIRMATION_PAGE",
"SUCCESS_PAGE",
"PAYMENT_PAGE"
]
},
"custom":{
"lang": "EN",
"input1": "your internal reference parameter name",
"inputval1": "your internal reference parameter value"
}
}'
Full control with server-side integration
curl --location --request POST 'https://payport.novalnet.de/v2/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": {
"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": "+491747781423",
"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",
"return_url": "YOUR_RETURN_URL",
"error_return_url": "YOUR_ERROR_RETURN_URL",
"hook_url": "HOOK_URL",
"due_date": "DUE_DATE",
"invoice_ref": "INVOICE_REF",
"mandate_ref": "MANDATE_REF",
"mandate_date": "MANDATE_DATE",
"create_token": "1",
"enforce_3d": "1",
"verify_payment_data": "1",
"invoice_no": "INVOICE_NO",
"transfer_type": "TRANSFER_TYPE",
"dynamic_descriptor": "www.yourshop.com",
"credit_reason_1": "CREDIT_REASON_1",
"credit_reason_2": "CREDIT_REASON_2",
"debit_reason_1": "DEBIT_REASON_1",
"debit_reason_2": "DEBIT_REASON_2",
"debit_reason_3": "DEBIT_REASON_3",
"debit_reason_4": "DEBIT_REASON_4",
"payment_data": {
"account_holder": "ACCOUNT_HOLDER",
"iban": "IBAN",
"bic": "BIC",
"pan_hash": "PAN_HASH",
"unique_id": "UNIQUE_ID",
"token": "TOKEN",
"wallet_token": "WALLET_TOKEN",
"account_number": "ACCOUNT_NUMBER",
"routing_number": "ROUTING_NUMBER"
}
},
"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": {
"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": "EN",
"input1": "{{input1}}",
"inputval1": "{{inputval1}}"
}
}'
Display hosted payment form in-app via WebView for smooth mobile checkout.
componentDidMount() {
const payment_access_key = 'YOUR_PAYMENT_ACCESS_KEY';
const encoded_data = base64.encode(payment_access_key);
const endpoint = 'https://payport.novalnet.de/v2/seamless/payment';
const headers = {
"Content-Type": "application/json",
"Charset": "utf8",
"Accept": "application/json",
"X-NN-Access-Key": encoded_data
};
const data = {};
data.merchant = {
"signature": "YOUR_API_SIGNATURE",
"tariff": "YOUR_TARIFF_ID"
};
data.customer = {
"first_name": "Max",
"last_name": "Mustermann",
"email": "test@novalnet.de",
"customer_no": "CUSTOMER_NUMBER",
"tel": "+49 089 123456",
"mobile": "+49 174 7781423",
"billing": {
"house_no": "2",
"street": "Musterstr",
"city": "Musterhausen",
"zip": "12345",
"country_code": "DE"
}
};
data.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"
};
data.hosted_page = {
"logo": "YOUR_SHOP_LOGO",
"display_payments": [
"CREDITCARD",
"DIRECT_DEBIT_SEPA",
"INVOICE",
"IDEAL",
"PAYPAL"
],
"hide_blocks": [
"ADDRESS_FORM",
"SHOP_INFO",
"LANGUAGE_MENU",
"HEADER",
"TARIFF"
],
"skip_pages": [
"CONFIRMATION_PAGE",
"SUCCESS_PAGE",
"PAYMENT_PAGE"
]
};
let request_data = {
method: 'POST',
body: JSON.stringify(data),
headers: headers
};
return fetch(endpoint, request_data)
.then(response => response.json())
.then((responseJson) => {
if (responseJson.result.redirect_url && responseJson.transaction.txn_secret) {
this.setState({
nnJsonData: responseJson
});
} else {
console.log('Failure message:' + responseJson.result.status_text);
}
})
.catch((error) => {
console.error(error);
});
}
Comprehensive APIs designed for every payment scenario. From simple transactions to complex marketplace solutions.
Complete payment lifecycle management with real-time processing
Comprehensive recurring billing and full subscription lifecycle management
Fetches detailed information about a specific resource using its unique identifier.
Deletes the selected payment token, preventing it from being used for any future payments or billing operations.
Create and manage affiliate accounts to track referrals and earn commissions.
Set up a webhook endpoint to automatically receive event data from the system as it happens.
Everything you need to integrate payments quickly. From SDKs and plugins to testing tools and documentation.
Test all endpoints directly in your browser with real-time responses
Launch API ExplorerComplete API collection for testing and development workflows
Everything you need to succeed with payments. From marketplace management to comprehensive support resources.
Build and publish your own integrations in our marketplace. Join our partner program and reach thousands of merchants.