Skip to content

Create Customer Wallet

This endpoint creates a customer wallet by using the CustomerId of an existing customer. Once the method is executed, a virtual account will be 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/CreateWalletWithCustomerId
-H 'Content-Type: application/json'

{
  "customerId": "",
  "CURRENCYCODE": "",
  "AccountTier": ""
}

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

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

Request Parameters

Parameter Type Description
customerId string *required The customer’s identification number
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