Payments / API Actions / Transaction Update

Transaction Update

This action allows you to change the following parameters:

Authorised Amount - can be updated before the payment is captured.
Due Date - can be updated before the payment is captured.
Payment Data - can be updated both before and after the payment is captured.

In addition you can also update the order details using this feature to sync the webshop's transaction details with Novalnet. The details includes: Order Number, Customer Number and Invoice Reference

If the payment was processed using tokenization (create_token = 1) and the end customer's bank details were updated via this /transaction/update action, the updated bank information will automatically be used for all future tokenization transactions once the update is successful.

Supported Payment Methods

Novalnet will support the amount and due date (if applicable) update for the following Payments.

Direct Debit SEPA
SEPA Direct Debit with Payment Guarantee
Instalment by SEPA Direct Debit
Invoice
Invoice with Payment Guarantee
Prepayment

Novalnet will support order details update for all the available Payments in Novalnet

Novalnet will support payment data update for Direct Debit SEPA, Direct Debit SEPA with payment guarantee and Instalment by Direct Debit SEPA payments.

How does it work?

To Update the transaction, you can use anyone the following option

Execute an API call
Update a transaction in the Novalnet Admin Portal

Execute an API call

Make a request to the /transaction/update endpoint by specifying the tid (A unique transaction ID of the authorized transaction), amount (Amount which need to be updated), due_date (Due date which need to be updated), order_no (Order Number which need to be updated), invoice_ref (Invoice Reference which need to be updated).

tid	A unique transaction ID of the authorized transaction
amount	The amount has to be specified here
due_date	The Due date has to be specified here
order_no	The Order Number has to be specified here
invoice_ref	The Invoice Reference has to be specified here
payment_data	The customer's payment data object has to be specified here.

You will receive the response containing the result object.

Update a transaction in the Novalnet Admin Portal

Log in to your Novalnet Admin Portal
Go to the menu Search, search for the TID to be changed and open the detail window of the respective transaction
Select the Transaction details tab
Then, in the Order amount/Order duedate (if applicable) field specify the amount and click on the Change amount (or) Change amount / due date option and click on the Ok button in the alert

UPDATE Notification

Once we have processed your UPDATE request, we will send you a notification with event.type value as TRANSACTION_UPDATE

Webhook

{
   "event" : {   
		"checksum": "380c0aa1b7d69a2c9c112b7a4f8de678c196ea4b97687f4b415f8e72809c7330",
		"tid": ###NOVALNET_TID###,
		"type": "TRANSACTION_UPDATE"
   },
   "result": {
        "status": "SUCCESS",
        "status_code": 100,
        "status_text": "Successful"
    },
    "customer":{
      "first_name":"Max",
      "last_name":"Mustermann",
      "email":"test@test.de",
      "customer_ip":"###CUSTOMER_IP###",
      "customer_no":"###CUSTOMER_NUMBER###",
      "tel":"+49 089 123456",
      "mobile":"+49 174 7781423",
      "gender":"u",
      "no_nc":1,
      "billing":{
         "street":"Musterstr",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "house_no":"2",
         "company":"ABC GmbH"
      },
      "shipping":{
         "same_as_billing":1,
         "first_name":"Max",
         "last_name":"Mustermann",
         "email":"test@test.de",
         "street":"Musterstr",
         "house_no":"2",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "tel":"+49 089 123456",
         "company":"ABC GmbH",
         "mobile":"+49 174 7781423"
      }
   },
  "transaction": {
	"amount": ###TRANSACTION_AMOUNT###,
	"currency": "###TRANSACTION_CURRENCY###",
	"due_date": "###DUE_DATE###",
	"order_no": "###TRANSACTION_ORDER_NUMBER###",
	"payment_type": "DIRECT_DEBIT_SEPA",
	"status": "ON_HOLD",
	"status_code": 99,
	"test_mode": ###TEST_MODE###,
	"tid": ###NOVALNET_TID###,
	"update_type": "AMOUNT"
  },
	"merchant":{
      "project": 6120,
      "project_name": "Developer Portal",
      "project_url": "https://developer.novalnet.de",
      "vendor": 4
	}
}

{
   "event" : {   
		"checksum": "380c0aa1b7d69a2c9c112b7a4f8de678c196ea4b97687f4b415f8e72809c7330",
		"tid": ###NOVALNET_TID###,
		"type": "TRANSACTION_UPDATE"
   },
   "result": {
        "status": "SUCCESS",
        "status_code": 100,
        "status_text": "Successful"
    },
    "customer":{
      "first_name":"Max",
      "last_name":"Mustermann",
      "email":"test@test.de",
      "customer_ip":"###CUSTOMER_IP###",
      "customer_no":"###CUSTOMER_NUMBER###",
      "tel":"+49 089 123456",
      "mobile":"+49 174 7781423",
      "gender":"u",
      "no_nc":1,
      "billing":{
         "street":"Musterstr",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "house_no":"2",
         "company":"ABC GmbH"
      },
      "shipping":{
         "same_as_billing":1,
         "first_name":"Max",
         "last_name":"Mustermann",
         "email":"test@test.de",
         "street":"Musterstr",
         "house_no":"2",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "tel":"+49 089 123456",
         "company":"ABC GmbH",
         "mobile":"+49 174 7781423"
      }
   },
    "transaction": {
        "amount": 500,
        "bank_details": {
		  "account_holder": "Novalnet AG",
		  "bank_name": "Raiffeisenlandesbank OÖ Zndl Süddeutschland",
		  "bank_place": "Passau",
		  "bic": "RZOODE77050",
		  "iban": "DE22740201500000000042"
		},
        "currency": "EUR",
        "due_date": "2020-04-25",
        "invoice_ref": "BNR-6120-###TRANSACTION_ORDER_NUMBER###",
        "order_no": "45678",
        "payment_type": "INVOICE",
        "status": "PENDING",
        "status_code": 100,
		"test_mode": ###TEST_MODE###,
        "tid": ###NOVALNET_TID###,
		"update_type": "DUE_DATE"
    },
	"merchant":{
      "project": 6120,
      "project_name": "Developer Portal",
      "project_url": "https://developer.novalnet.de",
      "vendor": 4
	}
}

{
  "event": {
    "checksum": "c97478a5831a37dcd366d4f5c3cecacb11482a868fcce4f75b5f7a5a17729e52",
    "tid": ###NOVALNET_TID###,
    "type": "TRANSACTION_UPDATE"
  },
  "customer":{
      "first_name":"Max",
      "last_name":"Mustermann",
      "email":"test@test.de",
      "customer_ip":"###CUSTOMER_IP###",
      "customer_no":"###CUSTOMER_NUMBER###",
      "tel":"+49 089 123456",
      "mobile":"+49 174 7781423",
      "gender":"u",
      "no_nc":1,
      "billing":{
         "street":"Musterstr",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "house_no":"2",
         "company":"ABC GmbH"
      },
      "shipping":{
         "same_as_billing":1,
         "first_name":"Max",
         "last_name":"Mustermann",
         "email":"test@test.de",
         "street":"Musterstr",
         "house_no":"2",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "tel":"+49 089 123456",
         "company":"ABC GmbH",
         "mobile":"+49 174 7781423"
      }
   },
  "result": {
    "status": "SUCCESS",
    "status_code": 100,
    "status_text": "Successful"
  },
  "transaction": {
    "amount": ###TRANSACTION_AMOUNT###,
    "bank_details": {
      "account_holder": "Novalnet AG",
      "bank_name": "Raiffeisenlandesbank OÖ Zndl Süddeutschland",
      "bank_place": "Passau",
      "bic": "RZOODE77050",
      "iban": "DE22740201500000000042"
    },
    "currency": "###TRANSACTION_CURRENCY###",
    "due_date": "###DUE_DATE###",
    "invoice_ref": "BNR-6120-###TRANSACTION_ORDER_NUMBER###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "payment_type": "GUARANTEED_INVOICE",
    "status": "CONFIRMED",
    "status_code": 100,
    "test_mode": ###TEST_MODE###,
    "tid": ###NOVALNET_TID###,
    "update_type": "STATUS"
  },
  "custom" : {
    "input1": "###INPUT1###",
    "inputval1": "###INPUTVAL1###",
    "###INPUT1###": "###INPUTVAL1###"
  },
  "merchant": {
    "project": 6120,
    "project_name": "Developer Portal",
    "project_url": "https://developer.novalnet.de",
    "vendor": 4
  }
}

{
   "event" : {   
		"checksum": "380c0aa1b7d69a2c9c112b7a4f8de678c196ea4b97687f4b415f8e72809c7330",
		"tid": ###NOVALNET_TID###,
		"type": "TRANSACTION_UPDATE"
   },
   "result": {
        "status": "SUCCESS",
        "status_code": 100,
        "status_text": "Successful"
    },
    "customer":{
      "first_name":"Max",
      "last_name":"Mustermann",
      "email":"test@test.de",
      "customer_ip":"###CUSTOMER_IP###",
      "customer_no":"###CUSTOMER_NUMBER###",
      "tel":"+49 089 123456",
      "mobile":"+49 174 7781423",
      "gender":"u",
      "no_nc":1,
      "billing":{
         "street":"Musterstr",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "house_no":"2",
         "company":"ABC GmbH"
      },
      "shipping":{
         "same_as_billing":1,
         "first_name":"Max",
         "last_name":"Mustermann",
         "email":"test@test.de",
         "street":"Musterstr",
         "house_no":"2",
         "city":"Musterhausen",
         "zip":"12345",
         "country_code":"DE",
         "tel":"+49 089 123456",
         "company":"ABC GmbH",
         "mobile":"+49 174 7781423"
      }
   },
    "transaction": {
		"amount": ###TRANSACTION_AMOUNT###,
		"currency": "###TRANSACTION_CURRENCY###",
		"due_date": "###DUE_DATE###",
		"order_no": "###TRANSACTION_ORDER_NUMBER###",
		"payment_type": "DIRECT_DEBIT_SEPA",
		"payment_data":{
			"iban":"###IBAN####",
			"account_holder":"###ACCOUNT_HOLDER###"
		},
		"status": "ON_HOLD",
		"status_code": 99,
		"test_mode": ###TEST_MODE###,
		"tid": ###NOVALNET_TID###,
		"update_type": "PAYMENT_DATA"
	  },
	"merchant":{
      "project": 6120,
      "project_name": "Developer Portal",
      "project_url": "https://developer.novalnet.de",
      "vendor": 4
	}
}

For more information please refer to the Webhook Notification.