Skip to content

Web Provision

Web Push Provision card (Digital Wallet)
post/v1/cards/{card_token}/web_provision

Allow your cardholders to directly add payment cards to the device's digital wallet from a browser on the web. Currently only suported for Apple Pay.

This requires some additional setup and configuration. Please Contact Us or your Customer Success representative for more information.

Path Parameters
card_tokenstring
formatuuid
Body Parameters
digital_walletenum
optional
Accepts one of the following: "APPLE_PAY"

Name of digital wallet provider.

Hide ParametersShow Parameters
"APPLE_PAY"
Returns
jwsobject
optional

JWS object required for handoff to Apple's script.

Hide ParametersShow Parameters
headerobject
optional

JWS unprotected headers containing header parameters that aren't integrity-protected by the JWS signature.

Hide ParametersShow Parameters
kidstring
optional

The ID for the JWS Public Key of the key pair used to generate the signature.

payloadstring
optional

Base64url encoded JSON object containing the provisioning payload.

protectedstring
optional

Base64url encoded JWS protected headers containing the header parameters that are integrity-protected by the JWS signature.

signaturestring
optional

Base64url encoded signature of the JWS object.

statestring
optional

A unique identifier for the JWS object.

Request example Request
curl https://api.lithic.com/v1/cards/$CARD_TOKEN/web_provision \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{}'
200 Example
{
  "jws": {
    "header": {
      "kid": "8dc7aed4-29e3-41e4-9cdb-673a05e6615c"
    },
    "payload": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9",
    "protected": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9",
    "signature": "SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
  },
  "state": "3cc4c292-727b-4ca8-b9a8-f96c15485f4e"
}