Community FAQs
Common questions asked in the community
Last updated
Was this helpful?
Common questions asked in the community
Last updated
Was this helpful?
We collated a list of some of the most common questions community members are asking. We'll grow this list with your support
If you have a question that isn't covered by these FAQs, post it on the Slack channel 💬
And if you find the solution to an error or a bug, write it down, post it in the Slack channel or record a quick video. Chances are other developers are having the same issue, and you might save them a lot of time.
You can create API keys for your account by logging into the Investec Online Portal. Navigate to "Manage" -> “Investec Developer” -> "Individual Connections" to access your API credentials and create API key(s) for your Private Banking account.
Check out How to get your API key for more details.
The authentication process involves obtaining an access token using the OAuth 2.0 Authorisation Framework. You'll need to make a request to the authentication endpoint with your client credentials to receive the access token.
Check out How to authenticate for more details.
The API provides several endpoints, such as "Get Accounts," "Get Account Balance," and "Get Account Transactions," which allow you to retrieve account details, balances, and transaction information. These endpoints support HTTP methods like GET and POST.
Check out How to get your transaction history for more details.
You can use the "Get Accounts" endpoint (GET /za/pb/v1/accounts) to obtain a list of accounts associated with a profile. This endpoint requires the authorisation bearer token.
Check out How to get your transaction history for more details.
You can use the "Get Account Balance" endpoint (GET /za/pb/v1/accounts/{accountId}/balance) to retrieve the balance of a specific account. Replace {accountId} with the actual account ID.
Check out How to get your transaction history for more details.
You can use the "Get Account Transactions" endpoint (GET /za/pb/v1/accounts/{accountId}/transactions) to fetch transactions for a specific account. You can provide optional query parameters such as fromDate, toDate, and transactionType to filter the transactions.
Check out How to get your transaction history for more details.
The Posted Order of a transaction may start out listed as 0 and then change to the correct number once it has settled. To be safe, ignore transactions while their Posted Order =0.
transactionDate is the date that you swiped your card or issued a payment. postingDate is the date that the amount was deducted from your balance.
Transfer Multiple v2
Endpoint: ‘POST /za/pb/v1/accounts/{acountId}/transfermultiple’
Method: POST
Description: Allows you to transfer funds to one or multiple accounts.
Request body: The request body should include an array of transfer objects specifying the beneficiary account, amount, and reference details.\
Pay Multiple:
Endpoint: ‘POST /za/pb/v1/accounts/{accountId}/paymutiple’
Method: POST
Description: Enables you to pay funds to one or multiple beneficiaries.
Request Body: The request body should include an array of payment objectives specifying the beneficiary, amount, and reference details. \
To initiate transfers and payments, make a HTTP POST request to the respective endpoints mentioned above. Ensure that you include the necessary authorisation and authentication headers, and the Bearer token obtained through the OAuth process, to authenticate your API request.
View the Investec Developer Docs for more details.
Currently, the API does not support direct creation of beneficiaries. To create a beneficiary, use the Investec Online Portal or other standard methods provided by Investec.
Once you have created a beneficiary, make at least one payment to that beneficiary using Investec Online before initiating a payment via the API. This ensures that the beneficiary is properly set up and ready to receive payments via the API.
No, limits are set up as per online banking. You must have made a payment to the beneficiary via Investec Online before making a payment to a beneficiary via the API.
Check out How to make a payment for more details.
Login to the Investec Online Portal and navigate to Investec Developer. Navigate to the desired card on your profile and ensure that you have enabled it by toggling the button below the card. Click on the card to open up the Online IDE.
Check out How to activate your card for more details.
You can use the beforeTransaction method in the main.js file to intercept the authorization object before it is approved by Investec. Within this method, you can apply logic to either approve or decline the transaction based on the authorization data or external data sources.
Check out How to add code to your card for more details.
Yes, you can apply conditional logic within the beforeTransaction method to approve or decline a transaction based on specific criteria. For example, you can check the transaction amount, beneficiary details, or other factors to determine the appropriate action.
Check out How to add code to your card for more details.
You can use the afterTransaction method to perform actions or communicate with external resources after processing the transaction. For example, you could set up email notifications every time you swipe your card.
The beforeTransaction method has a limited window of 2 seconds to execute, so it's important to ensure your code is efficient and responds within that timeframe. However, the afterTransaction method provides a larger window of 15 seconds for post-transaction actions.
Environment variables can be defined and saved in the env.json file. These variables can then be accessed within the main.js file using process.env.variableName. This allows you to securely store and reference sensitive information or configuration details.
You can differentiate between simulated transactions and production transactions by checking the transaction reference. In the afterTransaction method, you can compare transaction.reference with a specific value (e.g., "simulation") to identify simulated transactions.
Check out How to simulate a transaction for more details.
💡 It's always recommended to consult the official documentation provided by Investec for detailed instructions and specific technical guidance