Sorry, you need to enable JavaScript to visit this website.

2 Request Account Consent ID

Action

Using the Accounts access token you received in the previous call, proceed to make a account consent call to receive a Consent ID using the endpoint and values below.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/open-banking/v3.1/aisp/account-access-consents
Request
Headers
Header Value Description
Content-Type application/json The data type being sent to the endpoint
x-fapi-financial-id OB/2017/001 Financial ID
x-fapi-interaction-id Random value.Must be unique for every call. Interaction ID
Authorization Bearer <ACCESS_TOKEN> The access token you received from the previous call. Replace <ACCESS_TOKEN> with the access token you received.
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.

Body JSON
                            
{
  "Data": {
    "Permissions": [
      "ReadAccountsDetail",
      "ReadBalances",
      "ReadProducts",   
      "ReadTransactionsCredits",
      "ReadTransactionsDebits",
      "ReadTransactionsDetail"
    ],
    "ExpirationDateTime": "2024-10-26T00:00:00.000Z",
    "TransactionFromDateTime": "2022-05-03T00:00:00.000Z",
    "TransactionToDateTime": "2022-12-03T00:00:00.000Z"
  },
  "Risk": {}
}
                            
                            
Response JSON
                    
{
    "Data": {
        "ConsentId": "01HDQXHCK9795TMXMRQC4Z1AZ9",
        "Status": "AwaitingAuthorisation",
        "CreationDateTime": "2023-10-27T06:35:54.348Z",
        "StatusUpdateDateTime": "2023-10-27T06:35:54.349Z",
        "Permissions": [
            "ReadAccountsDetail",
            "ReadBalances",
            "ReadProducts",
            "ReadTransactionsCredits",
            "ReadTransactionsDebits",
            "ReadTransactionsDetail"
        ],
        "ExpirationDateTime": "2024-10-26T00:00:00.000Z",
        "TransactionFromDateTime": "2022-05-03T00:00:00.000Z",
        "TransactionToDateTime": "2022-12-03T00:00:00.000Z"
    },
    "Risk": {},
    "Links": {
        "Self": "https://api.nedbank.co.za/apimarket/sandbox/open-banking/v3.1/aisp/account-access-consents/01HDQXHCK9795TMXMRQC4Z1AZ9",
        "SCARedirectURL": "https://api.nedbank.co.za/apimarket/sandbox/nboauth/oauth20/authorize?response_type=code&scope=openid%2Caccounts&redirect_uri=https%3A%2F%2Fgoogle.com&client_id=100abe8e-9eb0-4efe-93ac-e8976e0b47bf&intentid=01HDQXHCK9795TMXMRQC4Z1AZ9&itype=accounts&state=123"
    },
    "Meta": {
        "TotalPages": 1,
        "InstructionIdentification": "123"
    }
}          
                    
                    

You now have a ConsentId. Take note of it as you are going to use it in the next call.