Product Overview
The Batch Transaction Details API provides detailed transaction information for Credit Transfer and Direct Debit batches of a payment account. This enables you to enhance the audit and accounting processes of your clients by receiving detailed insights into batch transactions.
To use this API, you must subscribe to the Business Account Insight API. This is required to obtain the unique batch reference needed to retrieve batch transaction details using this API.
Prerequisites
To ensure a smooth start with the Batch Transaction Details API, your business should meet the following conditions:
- High degree of automation.
- Professional IT environment and good infrastructure.
- Permanently available security expertise to use Accounts & Payments APIs and safeguarding its security.
- An EV SSL certificate for transport .
- An EV SSL signing certificate for signing messages.
- An active Rabobank business account.
How to connect with the Batch Transaction Details API
The API can be used in three ways, depending on your use case.
The options below explain each approach:
- If your solution is targeting Audit firms, then your approach is Audit Reporting.
- If you execute API requests from your own account, then you are a Direct Connector.
- If you execute API requests on behalf of your customers (Rabo account holders), then you are a Third Party.
More information: Rabo Banking Link manual for third parties, Rabo Banking Link manual for direct connectors
Audit Reporting:
- Subscribe your application to Batch Transaction Details (and Business Account Insight).
- Use the OAuth scope:
bai.batchtransactiondetails-audit.read.
Direct Connector:
- Subscribe your application to Batch Transaction Details (and Business Account Insight).
- Use the OAuth scope:
bai.batchtransactiondetails.read.
Third Party:
- Subscribe your application to Batch Transaction Details (and Business Account Insight).
- Use the OAuth scope:
bai.batchtransactiondetails.read.
Authentication & Authorization
The APIs use token-based authentication, which consists of 2 things:
- Consent granted by the account holder.
- Access token, with the integrated consent.
To set this up use the Authorization Services API.
With the /authorize endpoint the account holder is requested to give consent for a certain API (scope). After consent, an authorization code is returned. This authorization code should be used in the /token call to retrieve an access token. This access token is a Bearer token that you use in the Authorization header of each request.
Read more Oauth PSD2 and Premium.
Relevant scope for oauth2 access code flow
| Scope name | Description |
|---|---|
| bai.batchtransactiondetails.read | Allow read from Business Account Insight batch transaction details for Direct Connectors and Third Parties. |
| bai.batchtransactiondetails-audit.read | Allow read from Business Account Insight batch transaction details for Audit Reporting. |
Consent required for Third Parties and Direct Connectors:
- Third Party
- Performing actions on behalf of your customers (Rabo account holders)
- The account holder must provide consent to the third party to Rabobank on behalf of their organisation for the specified account(s) and scopes (provide access to specific actions). This consent is continuous.
- Direct Connector
- Performing actions on/from your own account
- You must provide consent for technical reasons for the specified account(s) and scopes (provide access to specific actions). This is a one time action.
Make sure that you use the Authorization and Token URL as provided by the Authorization Services.
Audit Reporting - authorizations on consent-user level
Required user level authorizations for the user that signs the consent and where to set those in Rabo Business Banking is described here
Rate Limiting
A default rate limit plan is set for all APIs. The rate limit can be shared or individual (defined per operation). The table below describes the rate limiting for this Batch Transaction Details
| Operation | Type | Limit (API calls / s) | Counts towards shared limit |
|---|---|---|---|
GET /accounts/{account-id}/batch-details/{batch-entry-reference} | Shared | 6 | Yes |
| All (premium) Oauth calls | Shared | 6 | Yes |
Looking for your Feedback
We want to know your thoughts on this new product. Contact us to share your feedback!