Kobble
  1. Cards
Kobble
  • Introduction
  • API Fundamentals
    • Idempotency
    • Rate Limits
    • Healthcheck
      GET
  • Authorization
    • Authorization
    • Get access token
      POST
    • Get access token
      POST
  • Beneficiaries
    • List all beneficiaries
      GET
    • Get beneficiary by ID
      GET
    • Create beneficiary
      POST
    • Update beneficiary
      PUT
    • Create Payid beneficiary
      POST
  • Cards
    • Cards API
    • Card Creation Flow — Developer Guide & Onboarding
    • Get all cards
      GET
    • Create a new card
      POST
    • Get card by ID
      GET
    • Update card status
      PATCH
    • Replace or renew card
      POST
    • Generate card secret
      POST
    • Generate MeaWallet widget session token
      POST
  • Card Programs
    • Card Programs API
    • Get all programs
      GET
    • Create a new program
      POST
    • Get program by ID
      GET
  • Clients
    • Clients API
    • Get all clients
    • Get client by ID
    • Create a new client
    • Update client status
  • Endusers
    • Endusers API
    • Usage of Metadata on Endusers
    • Get all endusers
    • Create a new enduser
    • Get enduser by ID
  • Transactions
    • Transactions API
    • Get all transactions
    • Create a transaction
    • Get transaction by ID
    • Create manual credit transaction
    • Create manual debit transaction
  • Wallets
    • Wallets API
    • Get all wallets
    • Create a new wallet
    • Get wallet by ID
    • Update wallet
  • Relays
    • Relays API
    • Create subscription
  • Webhooks
    • Webhooks API
    • Webhook Signature Verification
    • Get all webhooks
    • Create a webhook
    • Delete a webhook
  • Schemas
    • Schemas
    • Card
    • CardWidgetSessionTokenResponse
    • 202 Accepted
    • CardCreateInputDto
    • 201 Created
    • CardStatusUpdateDto
    • Create Beneficiary with bank details
    • CardRenewReplaceInputDto
    • Program
    • MetadataKobbleDebit1
    • ProgramCreateInputDto
    • Person
    • Company
    • Enduser
    • Enduser Create Person Input
    • Enduser Create Company Input
    • Metadata
    • Enduser Create Input DTO
    • Transaction
    • TransactionCreateManualCreditInputDto
    • TransactionCreateInputDto
    • Wallet
    • WalletCreateInputDto
    • WalletUpdateInputDto
    • Webhook
    • Relay
    • Client
    • Beneficiary
  1. Cards

Generate MeaWallet widget session token

Testing
POST
/customers/v1/cards/{id}/widget-session
Returns a short-lived TOTP and widget URL for embedding the MeaWallet EasyLaunch iframe to display card details (PAN, CVV, expiry) securely
Requires authentication, valid card ownership, and an idempotency key.
Use the response to build the iframe URL: {widgetUrl}?cardId={cardId}&totp={totp}.

Request

Path Params

Header Params

Body Params application/json

Example
{}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/customers/v1/cards//widget-session' \
--header 'Authorization;' \
--header 'idempotency-key;' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Responses

🟢200OK
application/json
Widget session token data
Body

Example
{
    "cardId": "string",
    "totp": "string",
    "widgetUrl": "string",
    "expiresIn": 0,
    "environment": "test"
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Modified at 2026-02-18 09:07:45
Previous
Generate card secret
Next
Card Programs API
Built with