Create Wallet

Description: Creates a new customer wallet with KYC verification.

Sample Request

Request Parameters

POST {baseUrl}/v1/new-customer/register

curl -X POST 'https://api.waas-provider.com/v1/new-customer/register'
  -H "x-Client-Id: your_client_id"
  -H "x-hash-key: sha256(clientSecret + payload)"
  -H "Content-Type: application/json"
  -d '{
      "emailAddress": "customer@example.com",
      "BVN": "12345678901",
      "NIN": "12345678901",
      "schemeId": "integration_scheme_id",
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }
'

Parameter	Type	Required	Description	Validation
emailAddress	string	Yes	Customer email	Valid email format
BVN	string	Yes	Bank Verification Number	11 digits
NIN	string	Yes	National ID Number	11 digits
schemeId	string	Yes	Integration scheme ID	Provided by WaaS
image	string	Yes	Customer photo	Base64, max 5MB
walletName	string	No	This is the account name that will be displayed upon name enquiry	Alpha numeric only

Sample Response

Sample Success Response

POST {baseUrl}/v1/new-customer/register

{
  "status": true,
  "responseDescription": "Approved or Completed Successfully",
  "responseCode": "00",
  "result": {
    "walletNumber": "9025920886",
    "walletName": "John Doe Adebayo",
    "macChecksum": "abc123def456ghi789jkl012",
    "walletTier": "Tier 1",
    "walletBalance": "0.00"
  }
}