Cards

Push-provision card

POSThttps://api.firstleeward.com/v0/cards/:id/push-provisioning

Generates the credentials needed to add a card to a digital wallet directly from your app, without the cardholder entering card details. Pass the result to the wallet SDK to complete provisioning. Each call returns fresh, single-use credentials.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Idempotency-Keystring

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Path Parameters

idstring<uuid>required

Body

application/json

providerstringrequired

Digital wallet the card is being added to

walletAccountIdstringrequired

Wallet account identifier obtained from the Google TapAndPay client on the device

deviceIdstringrequired

Stable device hardware identifier obtained from the Google TapAndPay client

Response

200Push provisioning credentials. The shape is determined by `provider`.

providerstringrequired

opcstringrequired

Opaque payment credential to pass to the Google TapAndPay push tokenization request

last4stringrequired

Last 4 digits of the card number

404Card not found

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

detailobject | nullrequired