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.
For more information, refer to the Rabo Banking Link manual for third parties.
Relevant scope(s) for oauth2 access code flow
Scope name | Description |
---|---|
bai.batchtransactiondetails.read | Allow read from Business Account Insight batch transaction details |
Make sure that you use the Authorization and Token URL as provided by the Authorization Services.
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 product.
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 |
Requests
The GET requests must contain a digital signature. You can generate this digital signature using the private key of your certificate. For the Sandbox environment, you can use an example certificate available in the Signing documentation.
To retrieve the transaction details of a specific batch for a payment account, your request must include both an account-id
and a batch-entry-reference
.
- Before making request to batch endpoint, you must obtain the
account-id
by using the Read Account List endpoint of the Business Account Insight - Accounts API. - You can obtain the
batch-entry-reference
by using the Read Transactions endpoint of the Business Account Insight - Transactions API. To view the expected errors, refer to the Errors page in the Business Account Insight (BAI) documentation.
GET https://api.rabobank.nl/openapi/payments/insight/accounts/Wp-xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0/batchDetails/OM1B000000645364
Request with next page:
GET https://api.rabobank.nl/openapi/payments/insight/accounts/Wp- xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0/batchDetails/ OM1B000000645364?pageNumber=2
To view the full list of parameters, go to
GET/accounts/\{account-id}/batchDetails/\{batch-entry-reference}
Response
In the response, you receive a list of transactions for a specific batch.
Each response is paginated with a maximum of 500 transactions per page. You can use the pageNumber
parameter to retrieve a next page of transactions for that batch.
The total number of transactions and the corresponding amount for the batch should match the booking returned by the Business Account Insight - Transactions API. Any rejections are booked as separate return bookings and are not be visible in this response.
{
"batchEntryReference": "OM1B000000645364",
"paymentInformationIdentification": "123456",
"numberOfTransactions": "550",
"authorisationUserName": "Alphanumeric 140",
"categoryPurposeCode": "SALA",
"batchAmount": {
"value": "55000",
"currency": "EUR"
},
"batchType": "CT",
"requestedExecutionDate": "2024-05-23T06:48:11.607486Z",
"next": "/accounts/hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA/batchDetails/OM1B000000645364?pageNumber=2",
"transactionDetails": [
{
"endToEndId": "90705030",
"transactionAmount": {
"amount": 5.12,
"currency": "EUR"
},
"remittanceInformationStructured": "23183510990000",
"remittanceInformationUnstructured": "Unstructured-02-IPIV4TC08C01-1844251",
"creditorAccount": {
"currency": "EUR",
"iban": "NL52RABO0125618484"
},
"creditorAgent": "RABONL2UXXX",
"creditorName": "Creditor Name",
"ultimateCreditor": "Ultimate Creditor",
"debtorAccount": {
"currency": "EUR",
"iban": "NL52RABO0125618484"
},
"debtorAgent": "RABONL2UXXX",
"debtorName": "Debtor Name",
"ultimateDebtor": "Ultimate Debtor"
}
]
}
Account-id
and batchEntryReference
scenario's present in the Sandbox environment:
IBAN | account-id | batchEntryReference | NoOfTransactions |
---|---|---|---|
NL52RABO0125618484 | Wp-xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0 | OM1B000000645366 | 250 |
NL80RABO1127000002 | hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA | OM1B000000645365 | 1500 |
NL80RABO1127000002 | hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA | OM1B000000645364 | 550 |