Funds Transfer

The Funds Transfer payment type allows the transfer of funds between accounts from marketplace to affiliate or from affiliate to the marketplace. This payment method ensures flexibility to debit your affiliate’s account with charges for orders completed or credit their account with an affiliate bonus when needed. Funds Transfers at Novalnet occur only for simple one-time transactions.

Payment TypeFUNDS_TRANSFER
Supported CountriesInternational
Supported CurrenciesEUR
Authorization No
Transaction Refund No
Tokenization No
Recurring No
Transmission of the customer number No

Methods of Funds Transfer

Novalnet handles Funds Transfers in two possible ways. You can choose one based on your business case.

  • Classic Affiliate
  • Marketplace

The parameter transaction.transfer_type can be DEBIT or CREDIT, so specify the transfer type.

  • DEBIT - Debited from affiliate or submerchant and credited to Marketplace
  • CREDIT - Debited from Marketplace and Credited to affiliate or submerchant

If this parameter is not passed, the transfer type will be DEBIT by default.

Read the api reference to learn more about parameters.

Classic Affiliate

Here is a typical request of Funds transfer using submerchant id in the object that you can take a look for your understanding.

Request
{
    "merchant": {
        "signature": "n7ibc7ob5t|doU3HJVoym7MQ44qonbobljblnmdli0p|qJEH3gNbeWJfIHah||f7cpn7pc",
        "tariff": "7075",
        "submerchant_id": 2261
    },
    "transaction": {
        "payment_type": "FUNDS_TRANSFER",
        "transfer_type": "DEBIT",
        "amount": 100,
        "currency": "EUR",
        "test_mode": 1
    },
    "custom": {
        "lang": "EN"
    }
}

After the request is sent to the server, a Transaction ID called a TID is created for that particular request. When the transaction succeeds, the TID is sent as a response to the system. In the event of a payment decline, the function returns an error message quoting the reason for the error.

Below is a sample response for the earlier request

Response
{
     "result": {       
        "status": "SUCCESS",
        "status_code": 100,
        "status_text": "Successful"
    },
    "transaction": {
        "amount": 100,
        "currency": "EUR",
        "date": "2023-06-16 12:30:15",
        "payment_type": "FUNDS_TRANSFER",
        "status": "CONFIRMED",
        "status_code": 100,
        "test_mode": 1,
        "tid": ###NOVALNET_TID###,
        "transfer_type":"DEBIT"
    }
}

Marketplace

Here is a typical request where the marketplace can handle Funds Transfer to Multiple affiliates with marketplace.tx_split in the object that you can take a look at for your understanding.

Request
{
    "merchant": {
        "signature": "n7ibc7ob5t|doU3HJVoym7MQ44qonbobljblnmdli0p|qJEH3gNbeWJfIHah||f7cpn7pc",
        "tariff": "7075"
    },
    "transaction": {
        "payment_type": "FUNDS_TRANSFER",
        "transfer_type": "DEBIT",
        "amount": 0,
        "currency": "EUR",
        "test_mode": 1
    },
    "marketplace": {
        "tx_split": {
            "2261": 2500,
            "2271": 3200
        }
    },
    "custom": {
        "lang": "EN"
    }
}

After the request is sent to the server, a Transaction ID called a TID is created for that particular request. When the transaction succeeds, the TID is sent as a response to the system. In the event of a payment decline, the function returns an error message quoting the reason for the error.

Below is a sample response for the earlier request

Response
{
     "result": {       
        "status": "SUCCESS",
        "status_code": 100,
        "status_text": "Successful"
    },
    "transaction": {
        "amount": 0,
        "currency": "EUR",
        "date": "2023-06-16 12:30:15",
        "payment_type": "FUNDS_TRANSFER",
        "status": "CONFIRMED",
        "status_code": 100,
        "test_mode": 1,
        "tid": ###NOVALNET_TID###,
        "transfer_type":"DEBIT"
    }
}

How do you wish to integrate Funds Transfer?

Setup Funds Transfer payment integration in your webshop using Direct API method. Previously, you must have enabled the Funds Transfer payment method in the Novalnet Admin Portal