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

9 Create Wallet

Action

This API will create a new wallet. If a wallet already exists then the customer will be asked by USSD push to provide consent to the TPP to access it by entering their MobiMoney PIN into USSD and accepting terms and conditions. If a wallet does not exist then the customer will be asked by USSD push to agree to wallet creation and set a PIN and allow TPP consent to access the wallet (with associated terms and conditions). Can be used by TPP (with USSD consent as mentioned). Note that the CallbackUrl must be passed as the String "NA". The AuthUrl in the response is a link to website which will be used for the Authorisation process. If a redirect is used,redirect_uri query parameter must be added to the url before the user is redirected so the TPP knows where to return the user to after Authorisation.Once the Authorisation is done the user will be redirected to the provided endpoint with CallabckId and Status.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/nb-wallet/wallets
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
                                
{
  "CallbackUrl": "NA",
  "ExternalUniqueId": "5adde3f1-5de6-465f-a211-a091db0be086",
  "FirstName": "Michael",
  "LastName": "Mauer",
  "IdentityNumber": "7803014567893",
  "Msisdn": "27731234567",
  "SourceOfFunds":"1058",
  "Industry":"1007",
  "Occupation":"1403",
  "OccupationOther":"OccupationOther"
}
                                
                                
Response JSON
                            
{
    "AuthUrl": "https://api-market.nedbank.co.za/apim02/sandbox/authenticator/wallet?callbackid=9836979c-4077-4fef-977b-ca271967b0e0",
    "CallbackId": "9836979c-4077-4fef-977b-ca271967b0e0",
    "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?callbackid=9836979c-4077-4fef-977b-ca271967b0e0&redirect_uri=https://yourapp.co.za/handle/auth':

                                
                https://yourapp.co.za/handle/auth?callbackid=9836979c-4077-4fef-977b-ca271967b0e0&status=SUCCESS