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

1 Get Catalogue

Action

Using your clientID and clientSecret (which you obtained when you created an application), you will make a GET request using the endpoint and values below to retrieve a ProductId for each catalogue.


Method GET
Endpoint https://b2b-api.nedbank.co.za/apimarket/b2b-sb/nb-vas/catalogue
Request
Headers
Header Value Description
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.
URL query parameters
Param Value Description
categoryID <categoryID> Based on provided categoryID we can retrieve the ProductID of each catalogue.
Response JSON

Sample Response with no categoryID: 

                                                 
{
    "ProductTypes": [
        {
            "ProductCategories": [],
            "ID": "11329",
            "Code": "VC",
            "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/web/Vouchers.svg",
            "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/ios/Vouchers.png",
            "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/android/Vouchers.png",
            "Description": "Buy gift voucher",
            "ProductCount": 175,
            "AdditionalContent": "Buy gift voucher"
        },
        {
            "ProductCategories": [],
            "ID": "11339",
            "Code": "PP",
            "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/web/Prepaid.svg",
            "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/ios/Prepaidi.png",
            "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/android/Prepaid.png",
            "Description": "Buy Prepaid data, airtime or SMSs",
            "ProductCount": 331,
            "AdditionalContent": "Buy Prepaid data, airtime or SMSs"
        },
        {
            "ProductCategories": [],
            "ID": "11340",
            "Code": "ELEC",
            "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/web/Electricity_New.svg",
            "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/ios/Electricity.png",
            "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/android/Electricity.png",
            "Description": "Buy Electricity",
            "ProductCount": 2,
            "AdditionalContent": "Buy prepaid and claim free electricity"
        },
        {
            "ProductCategories": [],
            "ID": "11342",
            "Code": "LOTTO",
            "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/web/Lotto.svg",
            "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/ios/Lotto.png",
            "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/android/Lotto.png",
            "Description": "Play LOTTO or PowerBall",
            "ProductCount": 0,
            "AdditionalContent": "Play LOTTO or PowerBall"
        }
    ],
    "ErrorCode": 0,
    "ErrorDescription": "OK",
    "TxID": "7423bd95-4a00-44de-8dae-d944f17e8199"
}

Sample Response with categoryID: 

                                                 
{
  "ChildCategories": [
    {
      "Products": [
        {
          "ID": "9107a585-101b-4e01-08fc-08d91e710727",
          "Name": "1ForYou Own amount",
          "Code": "NA",
          "Price": "0",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 083 903 5274 or 084 193 5274.
Alternatively, the Nedbank contact centre on 0860 555 111.",
          "Status": "Active",
          "BillingType": "Variable",
          "Description": "1ForYou",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "2",
          "MaxAmount": "2500"
        },
        {
          "ID": "b7610988-de0e-4810-02d0-08d9250f5d47",
          "Name": "1ForYou R500",
          "Code": "NA",
          "Price": "500",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

[d]1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 021 674 7620.
Alternatively, the Nedbank contact centre on 0860 555 111.",
          "Status": "Active",
          "BillingType": "Fixed",
          "Description": "1ForYou R500",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "0",
          "MaxAmount": "0"
        },
        {
          "ID": "b0b21564-8f59-41f8-c374-08d92002c18a",
          "Name": "1ForYou R50",
          "Code": "NA",
          "Price": "50",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

[d]1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 021 674 7620.
Alternatively, the Nedbank contact centre on 0860 555 111.",
          "Status": "Active",
          "BillingType": "Fixed",
          "Description": "1ForYou R50",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "0",
          "MaxAmount": "0"
        },
        {
          "ID": "8378a060-5056-4e5d-5fcc-08d91eb21a65",
          "Name": "1ForYou R200",
          "Code": "NA",
          "Price": "200",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

[d]1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 021 674 7620.
Alternatively, the Nedbank contact centre on 0860 555 111.",
          "Status": "Active",
          "BillingType": "Fixed",
          "Description": "1ForYou R200",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "0",
          "MaxAmount": "0"
        },
        {
          "ID": "71ca8aa5-c3c4-454c-f6a1-08d91e6c3405",
          "Name": "1ForYou R20",
          "Code": "NA",
          "Price": "20",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

[d]1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 021 674 7620.
Alternatively, the Nedbank contact centre on 0860 555 111.",
          "Status": "Active",
          "BillingType": "Fixed",
          "Description": "1ForYou R20",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "0",
          "MaxAmount": "0"
        },
        {
          "ID": "76c0897f-f536-4638-cf27-08d91e71048c",
          "Name": "1ForYou R100",
          "Code": "NA",
          "Price": "100",
          "AverageSpend": "0",
          "Vendor": null,
          "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
          "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
          "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
          "AdditionalContent": "[h]Redemption instructions
[d]In order to redeem a \"1ForYou Voucher\", follow the steps below:
1. Go to 1foryou.com to view partners.
2. Pick a 1ForYou partner to pay or top-up.
3. Enter 1ForYou 16 digit pin and click on Pay or Deposit.

[h]Terms and conditions
[d]https://1foryou.com/terms/

[d]1ForYou is the digital payment solution for cash customers in South Africa. Get your cash online, make payments and top-up wallets. We use Industry-leading tech to make every sale, payment and redemption safe and secure. 
1ForYou voucher expires 3 years from the date of purchase.

[h]Need help?
[d]For support contact 1ForYou via email at support@flash.co.za or call 021 674 7620.
Alternatively, the Nedbank contact centre on 0860 555 111.1.",
          "Status": "Active",
          "BillingType": "Fixed",
          "Description": "1ForYou R100",
          "PublishedDate": "2020-08-14T00:00:00+02:00",
          "MinAmount": "0",
          "MaxAmount": "0"
        }
      ],
      "ID": "16595",
      "Code": "FLASH",
      "Name": "",
      "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/web/1ForYou.png",
      "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/ios/1ForYou.png",
      "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/vcc/android/1ForYou.png",
      "Description": "1ForYou voucher",
      "ProductCount": 6,
      "Type": "Brand"
    }
  ],
  "Category": {
    "Products": [],
    "ID": "11329",
    "Code": "VC",
    "Name": "",
    "WebIcon": "https://ww3.nedbank.co.za/content/dam/vas/web/Vouchers.svg",
    "IOSIcon": "https://ww3.nedbank.co.za/content/dam/vas/ios/Vouchers.png",
    "AndroidIcon": "https://ww3.nedbank.co.za/content/dam/vas/android/Vouchers.png",
    "Description": "Buy gift voucher",
    "ProductCount": 81,
    "Type": "Product Type"
  },
  "ErrorCode": 0,
  "ErrorDescription": "OK",
  "TxID": "a83b52e8-7ebd-4406-b2c2-6c633820639e"
}

You now have an ID thats under Products. Take note of it as you are going to use it in the next call.

Next step