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 "Authorization: Bearer {{accessToken}}" \
     -H "X-Device-Id: e2e-device-1a2b3c4d" \
     -H "Content-Type: application/json" \
     -d '{
  "firstName": "Jane",
  "lastName": "Doe",
  "phoneNumber": "254712345678",
  "nationalId": "12345678",
  "gender": "FEMALE",
  "dob": "1990-01-01",
  "acceptedTerms": true,
  "acceptedPrivacyPolicy": true,
  "otp": "123456"
}'

201Wallet_createPersonalWallet_example

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

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

Request

This endpoint expects an object.

firstNamestringOptional

lastNamestringOptional

phoneNumberstringOptionalformat: "utc-millisec"

nationalIdstringOptionalformat: "utc-millisec"

genderstringOptional

dobdateOptional

acceptedTermsbooleanOptional

acceptedPrivacyPolicybooleanOptional

otpstringOptionalformat: "color"

Response

201 Created

codeintegerOptional

messagestringOptional

dataobjectOptional

Headers

Request

Response