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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Generate card secret

Card Programs API