BankBot v3.2
config rev. 47
Configuration
Connection
Scopes
Document Types
Data Mapping
Retry Policy
Webhooks
Error Handling
Test Mode
Version History
Connection Settings
Configure the MCP endpoint, authentication, and OAuth parameters for the Mitek KYC integration.
MCP Endpoint
API Authentication
OAuth 2.0 Configuration
Permission Scopes
Manage which MCP capabilities BankBot can invoke. Some scopes require tier upgrades.
Current Tier: 1 3 of 5 scopes available
doc_upload
Upload identity documents (passport, ID card, proof of address) to the MCP verification pipeline.
Rate limit: 100 req/min Human confirm: No
data_provide
Submit structured applicant data (name, DOB, address, nationality) for identity correlation.
Rate limit: 200 req/min Human confirm: No
status_check
Query the current verification status and retrieve results for a given case ID.
Rate limit: 500 req/min Human confirm: No
full_kyc Requires Tier 2
Run a complete KYC verification flow end-to-end, including automated decisioning.
Rate limit: 20 req/min Human confirm: Yes Current: Tier 1
ubo_declare Requires Tier 2
Declare and verify Ultimate Beneficial Ownership structures for legal entity onboarding.
Rate limit: 10 req/min Human confirm: Yes Current: Tier 1
Document Types
Configure which document types are accepted for identity verification through the MCP pipeline.
Status Document Type Country Accepted Formats Max Size
Active Passport Romania (RO) PDF, JPEG, PNG 10 MB
Active National ID Card Romania (RO) PDF, JPEG, PNG 10 MB
Active Passport (Generic) EU Member States PDF, JPEG, PNG 15 MB
Active Proof of Address Romania (RO) PDF, JPEG 8 MB
Data Mapping
Map BankBot's internal field names to the Mitek MCP schema. These mappings determine how applicant data is translated.
BankBot Field MCP Field Type Required
customer.firstName → applicant.given_name string Yes
customer.lastName → applicant.family_name string Yes
customer.dob → applicant.date_of_birth ISO 8601 Yes
customer.cnp → applicant.national_id string Yes
customer.address.street → applicant.address.line1 string No
customer.address.city → applicant.address.city string No
customer.nationality → applicant.nationality ISO 3166-1 Yes
customer.email → applicant.contact.email string No
Retry Policy
Control how BankBot retries failed requests to the Mitek MCP endpoint.
Retry Configuration
5s60s
Circuit Breaker
Circuit Breaker Enabled
Consecutive failures before opening circuit
Seconds before half-open retry
Webhooks
Configure webhook endpoints to receive real-time notifications from the Mitek MCP platform.
Event URL Secret Last Triggered Status Actions
status_change https://api.ing.ro/kyc/webhook whsec_•••••k9m 2 min ago Active
{ "event": "status_change", "case_id": "KYC-2026-00847", "timestamp": "2026-03-21T14:32:00Z", "data": { "previous_status": "documents_received", "new_status": "under_review", "agent": "BankBot v3.2" } }
human_prompt_sent https://api.ing.ro/kyc/webhook whsec_•••••k9m 18 min ago Active
{ "event": "human_prompt_sent", "case_id": "KYC-2026-00847", "timestamp": "2026-03-21T14:14:00Z", "data": { "prompt_type": "document_quality", "message": "Passport scan is blurry, please re-upload.", "operator_id": "op_elena_m" } }
case_completed https://api.ing.ro/kyc/webhook whsec_•••••k9m 1 hour ago Active
{ "event": "case_completed", "case_id": "KYC-2026-00841", "timestamp": "2026-03-21T13:02:00Z", "data": { "result": "approved", "risk_score": 12, "verification_methods": ["document", "biometric", "data_match"], "processing_time_ms": 4230 } }
Error Handling
Define how BankBot responds to specific error codes from the Mitek MCP API.
Error Rules
400
Bad Request — malformed payload or missing required fields
Log + Alert Dev
No Retry
401
Unauthorized — invalid or expired API credentials
Refresh Token
Retry 1x
403
Forbidden — scope not authorized or tier insufficient
Log + Notify Admin
No Retry
408
Request Timeout — MCP server did not respond within deadline
Retry w/ Backoff
Retry 3x
429
Rate Limited — too many requests, check scope rate limits
Queue + Backoff
Retry after delay
500
Internal Server Error — MCP platform error
Retry w/ Backoff
Retry 3x
503
Service Unavailable — MCP under maintenance or circuit open
Circuit Breaker
Wait + Retry
Fallback Behavior
Send failed requests to DLQ for later inspection
Test Mode
Run test cases against the sandbox environment to validate your agent configuration end-to-end.
Sandbox Mode ON
All requests route to sandbox endpoint. No real KYC data is processed.
Test Execution
1
Connect to MCP sandbox endpoint
2
Upload test document (Romanian Passport — sample)
3
Submit test applicant data via data_provide scope
4
Check verification status via status_check scope
Request / Response Log
[14:28:01] INFO Test mode initialized — sandbox endpoint active
[14:28:01] INFO Agent: BankBot v3.2 | Config rev. 47
[14:28:01] READY Waiting for test execution...
Last 10 Test Runs
Run ID Timestamp Duration Steps Result
run_0047 2026-03-21 14:12:33 2.4s 4/4 Pass
run_0046 2026-03-21 13:58:11 2.1s 4/4 Pass
run_0045 2026-03-21 11:44:05 8.7s 2/4 Fail
run_0044 2026-03-21 11:30:22 2.3s 4/4 Pass
run_0043 2026-03-20 17:15:48 2.5s 4/4 Pass
run_0042 2026-03-20 16:02:31 12.1s 1/4 Fail
run_0041 2026-03-20 14:48:19 2.2s 4/4 Pass
run_0040 2026-03-20 13:11:55 2.6s 4/4 Pass
run_0039 2026-03-19 18:33:07 5.1s 3/4 Partial
run_0038 2026-03-19 16:20:44 2.3s 4/4 Pass
Version History
Track configuration changes. Each save creates a new revision that can be rolled back.
Rev. 47 Current
2026-03-21 14:10 · andrei.o@ing.ro
Updated retry policy: exponential backoff, circuit breaker threshold 5 → 5 (no change), recovery 60s → 30s
Rev. 46
2026-03-20 16:45 · elena.m@ing.ro
Added case_completed webhook event, updated webhook secret rotation
Rev. 45
2026-03-19 11:22 · andrei.o@ing.ro
Added EU Passport (generic) document type, increased max file size to 15 MB
Rev. 44
2026-03-18 09:30 · ciprian.d@ing.ro
Enabled PKCE for OAuth flow, updated token URL to v2 endpoint
Rev. 43
2026-03-17 14:55 · elena.m@ing.ro
Initial agent configuration — connection, scopes (doc_upload, data_provide, status_check), document types (RO passport, RO ID)