IBEx.Fi IBAN Deployment Flow

1. KYC Verification Flow

📋

Get KYC Iframe

POST /v1.1/auth/iframe
Returns chatbotURL + sessionId

🖼️

Redirect to Iframe

Build URL with sessionId
User completes KYC verification

✅

KYC Status

Poll or WebSocket
Wait for ky = "5" (ACCEPTED)

2. IBAN Creation Flow

💼

Create IBAN Operation

POST /v1.1/safes/operations
MONERIUM_CREATE_IBAN

🔐

Sign Operation

PUT /v1.1/safes/operations
MONERIUM_CREATE_IBAN (signMessage)
navigator.credentials.get()
User signs with passkey

✍️

Finalize Creation

PUT /v1.1/safes/operations
Submit credential

⏳

Wait for Execution

Bundler submits to blockchain
Operation status: EXECUTED

3. IBAN Retrieval Flow

📊

Track Status

GET /v1.1/ibexsafe/userdata/external/{id}
Check iban.status

🏦

Get IBAN

iban.status = "VERIFIED"
IBAN + BIC available

📋 Data to Store

chatbotURL : KYC iframe base URL
sessionId : KYC session identifier
ky : KYC status (0-5, 55)
iban.iban : IBAN number (when VERIFIED)
iban.bic : Bank BIC code
iban.status : IBAN status (PENDING, VERIFIED)

🔧 Endpoints

1. KYC Verification Flow
POST /v1.1/auth/iframe : Get KYC iframe URL
2. IBAN Creation Flow
POST /v1.1/safes/operations : Create IBAN operation
PUT /v1.1/safes/operations : Finalize IBAN creation
3. IBAN Retrieval Flow
GET /v1.1/ibexsafe/userdata/external/{id} : Get userData with IBAN

⚙️ Technical Details

KYC via external iframe service
Safe message signing for IBAN
ERC-4337 Account Abstraction
Gasless transactions (bundler/paymaster)
Real-time updates via WebSocket
Monerium IBAN provider

← Back to Deploy IBAN Guide