Generate MeaWallet widget session token

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/customers/v1/cards//widget-session' \
--header 'Idempotency-Key;' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{}'

Responses

🟢201Created

application/json

Widget session created. NOTE: the wire status is 201 (the handler has no @HttpCode override); previously documented as 200.

Bodyapplication/json

Example

{
    "cardId": "string",
    "totp": "string",
    "widgetUrl": "string",
    "expiresIn": 0,
    "environment": "test"
}

🟢202Accepted

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Modified at 2026-09-15 01:24:19

Generate card secret

Card Programs API