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" }