{"description":"API for managing virtual cards with Family Bank","endpoints":{"GET /api/v1/cards/:cardNumber/balance":{"description":"Get card balance","parameters":"cardNumber (path parameter)","response":"BalanceResponse"},"GET /api/v1/health":{"description":"Health check endpoint","response":"Service status information"},"GET /api/v1/token":{"description":"Get access token from Family Bank","response":"TokenResponse with access_token"},"POST /api/v1/cards":{"description":"Create a virtual card","request":"CardCreationRequest","response":"CardCreationResponse"},"POST /api/v1/cards/complete-flow":{"description":"Complete card creation and top-up flow","request":"CompleteCardFlowRequest","response":"CompleteCardFlowResponse"},"POST /api/v1/cards/topup":{"description":"Top up a card","request":"TopUpRequest","response":"TopUpResponse"}},"sample_requests":{"create_card":{"accountNumber":"687209864687","cardProgram":"PAN","customerName":"Ian Njehia","email":"collinsochieng003@gmail.com","idback":"base64_encoded_id_back","identificationNumber":"20564467","idfront":"base64_encoded_id_front","kraPin":"A017459948Z","mobileNumber":"254794940160","photo":"base64_encoded_photo","salutation":"Mr","sign":"base64_encoded_signature","sourceAdress":"string"},"top_up":{"accountReference":"687209864687","callBackURL":"https://webhook.site/ac379d2d-5d59-4134-ae92-a7700a64b0bc","cardNumber":"4592530180000228","mobileNumber":"254794940160","thirdPartyTransId":"12213310aa","transactionAmount":"100","transactionDesc":"test top up"}},"title":"Family Bank Card API","version":"1.0.0"}