Sub-Wallets

As a SasaPay WAAS merchant, you can are able to create sub-wallets for your customers.

❗ Note: Maximum of 2 wallets is allowed for the customer. Main wallet and the sub-wallet.

Endpoint: https://sandbox.sasapay.app/api/v2/waas/sub-wallets/

Request Parameters

Field	Type	Description	Example
merchantCode	String	Unique code assigned to the merchant	"600980"
accountNumber	String	Customer's Main account number	"1234"
mobileNumber	String	Customers's mobile number	"2547***0"
subwalletType	String	Type of sub-wallet to create	Personal or Business
walletName	String	Name of the wallet	"Shop Wallet"
purpose	String	Purpose of the wallet can either	"Collection"
physicalAddress	String	Physical address of the merchant	"Nairobi, Kenya"
natureOfBusiness	String	Nature of the business	"Retail shop"
estimatedMonthlyTransactionAmount	String	Estimated amount of transactions per month	"500000"
estimatedMonthlyTransactionCount	String	Estimated number of transactions per month	"1000"

Sample request

Headers
    Key: Authorization
    Value: Bearer cFJZcjZ6anEwaThMMXp6d1FETUxwWkIzeVBDa2hNc2M6UmYyMkJmWm9nMHFRR2xWOQ==
Body:
   {
  "merchantCode": "600980",
  "accountNumber":"123456",
  "mobileNumber": "2547******0",
  "subwalletType": "Personal",
  "walletName": "Shop Wallet",
  "purpose": "Collection",
  "physicalAddress": "Nairobi,Kenya",
  "natureOfBusiness": "Retail shop",
  "estimatedMonthlyTransactionAmount": "500000",
  "estimatedMonthlyTransactionCount": "1000"
}

Response Parameters

Field	Type	Description	Example
responseCode	Numeric	This is a numeric status code that indicates the status of the response. 0 means success and any other code means an error occurred or the request failed.Please refer to the response codes table above.	0
message	String	This is the response message sent by the system when the payload is received on the endpoint.	“Customer registered successfully”
data	JSON Object	An object containing the details of the registered customer	“data”
merchantCode	Numeric	A unique number assigned to an organization/merchant registered with ViewTech, through which payment is received (can be Paybill or Till number)	“2****8
accountNumber	Numeric	Subwallet account number	“812345”
displayName	String	customer name	“Doe”
accountStatus	String	status of the created account	“ACTIVE”
accountBalance	Numeric	customer balance in the wallet	“0”

Sample Response

{
    "status": true,
    "responseCode": "0",
    "message": "Subwallet created successfully",
    "data": {
        "merchantCode": "2**2",
        "accountNumber": "254705*****8",
        "displayName": "John Doe",
        "accountStatus": "ACTIVE",
        "accountBalance": 0
    }
}