Skip to content

Create Customer Wallet

Create customer's wallet endpoint creates a wallet the same way create wallet does. It uses the customer's phone number to create a wallet. Once the method is executed, a virtual account is created, this will serve as the customer's wallet identification.

Request Body

Note

Serialize the request body, then encrypt (AES encryption) it using the provided key. The encryption requires a secret key and IV key which will be provided by the sterling team. Pass the encrypted string as the value of "Data" in the new request body. 

EncryptedReq {
  "Data": "string"
}

curl -X POST https://pass.sterling.ng/OneBankWalletV3/api/Wallet/CreateWalletCustomer
-H 'Content-Type: application/json'

{
  "firstname": "",
  "lastname": "",
  "mobile": "",
  "DOB": "",
  "Gender": "",
  "CURRENCYCODE": "",
  "AccountTier": ""
}

{
  "message": "",
  "response": "",
  "responsedata": ,
  "data": {
    "firstname": "",
    "lastname": "",
    "email": 
    "mobile": "",
    "AccountTier": ,
    "VIRTUALACCT":
  }
}

{
  "message": "",
  "response": "",
  "responsedata": ,
  "data": {
    "firstname": "",
    "lastname": "",
    "email": 
    "mobile": "",
    "AcctTier": ,
    "VIRTUALACCT":
  }
}

Request Parameters

Parameter Type Description
firstname string *required The customer’s first name
lastname string *required The customer’s last name
mobile string *required The customer’s mobile number
DOB string *required The customer’s date of birth, using the following format YYYY/MM/DD e.g., 2021-01-26
Gender string *required The customer’s gender i.e., M for Male or F fo Female
CURRENCYCODE string*required The users's wallet code which can be in Naira, Dollar, Pound or Euro i.e, NGN, USD ...
AccountTier string *required Wallet account tier, e.g Tier 1, 2 or 3

Response Parameters

Parameter Type Description
message string Response message
response string Response code
firstname string The customer’s first name
lastname string The customer’s last name
mobile string The customer’s mobile number
DOB string The customer’s date of birth, using the following format YYYY/MM/DD e.g., 2021-01-26
Gender string The customer’s gender i.e., M for Male or F fo Female
CURRENCYCODE string The users's wallet code which can be in Naira, Dollar, Pound or Euro i.e, NGN, USD ...
AccountTier string Wallet account tier, e.g Tier 1, 2 or 3
VIRTUALACCT string Virtual account number