Create Personal Wallet

POST

http://localhost:8080/api/v3/wallets/register/personal

POST

/api/v3/wallets/register/personal

curl -X POST http://localhost:8080/api/v3/wallets/register/personal \
     -H "X-Device-Id: e2e-device-1a2b3c4d" \
     -H "Content-Type: application/json" \
     -d '{
  "dob": "1990-01-01",
  "otp": "123456",
  "gender": "FEMALE",
  "lastName": "Doe",
  "firstName": "Jane",
  "nationalId": "12345678",
  "phoneNumber": "254712345678",
  "acceptedTerms": true,
  "acceptedPrivacyPolicy": true
}'

201Wallet_Personal_Create Personal Wallet_example

{
  "code": 201,
  "data": {
    "walletId": "b1e7f6a0-9d2b-4a5b-9c3d-1a2b3c4d5e6f",
    "walletType": "PERSONAL",
    "authDetails": {
      "id": "f5c1d4e5-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
      "phone": "254712345678",
      "roles": [
        "PERSONAL_WALLET"
      ],
      "fullName": "Jane Doe",
      "expiresAt": 1758150000,
      "accessToken": "eyJhbGciOiJSUzI1NiJ9...",
      "permissions": [],
      "refreshToken": "eyJhbGciOiJSUzI1NiJ9..."
    }
  },
  "message": "Account created successfully"
}

Public (wallets/register/** whitelisted). Verifies the OTP, creates/updates the user, and creates a PERSONAL wallet (starts INACTIVE).

Request

This endpoint expects an object.

dobdateRequired

otpstringRequired

genderstringRequired

lastNamestringRequired

firstNamestringRequired

nationalIdstringRequired

phoneNumberstringRequired

acceptedTermsbooleanRequired

acceptedPrivacyPolicybooleanRequired

Response

Created

codeinteger

dataobject

messagestring

Headers

Request

Response