Payments / API Actions / Transaction Capture

Transaction Capture

In general, for some payments, the payment process will get completed in two steps:

Authorization

The payment details of the end-customer are verified, and the funds are reserved.
Transaction Capture

The reserved funds are transferred from the end-customer to your account.

By default, both the Authorization and Capture are handled all at once. However, some payments support separate authorization and capture processes. You can also capture the payment later for those payments, for example, after your inventory delivered the goods.

Supported Payments

Credit/Debit Cards
Direct Debit SEPA
SEPA Direct Debit with Payment Guarantee
Instalment by SEPA Direct Debit
SEPA Credit
Invoice
Prepayment
Invoice with Payment Guarantee
Instalment by invoice
PayPal
Apple Pay
Google Pay
EPC-QR-Pay

Credit/Debit cards, Apple Pay, Google Pay and PayPal payments only support multiple capture.

How does it work?

To Capture the transaction, you can use any one the following options

Manual Capture - Capture each payment manually through the /transaction/capture API or via the Novalnet Admin Portal. You can also partially capture an amount with a single partial capture request for card payments.
Automatic Capture - By default, transactions will get captured automatically after the Authorization. Also you can specify a delay (in days) between Authorization and the Automatic Capture.
Multiple Capture - This allows you to perform a multiple partial capture of the total authorized amount.

Manual Capture

To Capture the transaction, you can use any one the following options

a) Make an API call

Make a request to the /transaction/capture endpoint by specifying the following parameter(s) in the request:

tid	A unique transaction ID of the authorized transaction
amount	The partial amount that you need to capture should be smaller than the original authorised amount.

You will receive the response containing the result object.

b) Capture a Transaction in 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 Refund/Reversal/Change status tab
Then, in the Change status field select the Debit option and click on the OK button in the alert

Automatic Capture

You can capture the transaction automatically after certain time period (in days). Once we have processed your Capture request, we will send you a notification with event.type value as TRANSACTION_CAPTURE.
Capture delay time period can be configured only by our technical team. So, if you want to configure the Capture delay time period, please contact our technical team. To know more about this feature please contact our support team

Webhook

{
  "event": {
    "checksum": "7cc749f70d46c995065d68f22524ff86a0711e8648b595753ce5d0cfd35a59b4",
    "tid": ###NOVALNET_TID###,
    "type": "TRANSACTION_CAPTURE"
  },
  "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###",
    "order_no": "###TRANSACTION_ORDER_NUMBER###",
    "payment_type": "INVOICE",
	"invoice_no":"###INVOICE_NO###",
	"invoice_ref":"BNR-6120-###TRANSACTION_ORDER_NUMBER###",
    "status": "CONFIRMED",
    "status_code": 100,
    "test_mode": ###TEST_MODE###,
    "tid": ###NOVALNET_TID###
  },
  "custom" : {
    "input1": "###INPUT1###",
    "inputval1": "###INPUTVAL1###",
    "###INPUT1###": "###INPUTVAL1###"
  },
  "merchant": {
    "project": 6120,
    "project_name": "Developer Portal",
    "project_url": "https://developer.novalnet.de",
    "vendor": 4
  }
}

For more information please refer to the Webhook Notification.

Multiple Capture

This is necessary for some business models, where capture happens based on shipment. If an order has multiple items to ship, each shipment will map to a partial capture.
You will get notified through our webhook notification for each multiple capture transaction. In addition, please refer to the corresponding webhook notification below.

Multiple capture is disabled by default. To enable this feature, please contact our technical team.