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

12 Pin Change

Action

This API will send a USSD push to the customers registered phone asking them to enter their ID Number and old pin and new pin.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/nb-wallet/wallets/<WALLET_ID>/pin-changes
Note Replace <WALLET_ID>that you get at time of creating wallet
Request
Headers
Header Value Description
Content-Type application/json The data type being sent to the endpoint.
Authorization Bearer <ACCESS_TOKEN> Replace <ACCESS_TOKEN> with the access token you received from the Light Token step.
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
                                
{
    "IdentityNumber": "7803014567893"
}
                                    
                                         
Response JSON
                            
{
    "AuthUrl": "https://api-market.nedbank.co.za/apim02/sandbox/authenticator/wallet-pin-change?callbackid=18cd758b-4817-47d9-aaf9-25b038dc7940",
    "CallbackId": "18cd758b-4817-47d9-aaf9-25b038dc7940",
    "Status": "PENDING"
}
                        
                        

NOTE : The callbackId will be needed to poll for the result on the next operation

Authorisation Response status

The redirect_uri is an optional query parameter.If it is passed to the AuthUrl that is retrieved in the response then the process will redirect the user to the url provided in the 'redirect_uri' parameter. A CallbackId and status will be appended to the redirect url, as in the sample below. Let’s assume your AuthUrl was 'https://api-market.nedbank.co.za/apim02/sandbox/authenticator/wallet-pin-change?callbackid=18cd758b-4817-47d9-aaf9-25b038dc7940&redirect_uri=https://yourapp.co.za/handle/auth':

                                
                https://yourapp.co.za/handle/auth?callbackid=18cd758b-4817-47d9-aaf9-25b038dc7940&status=SUCCESS