Skip to main content
Returns a short URL that, when opened on the end-user’s mobile device, launches the Fluz App Clip (iOS) or Fluz app (Android) and adds the offer’s virtual card to Apple Pay / Google Pay. Typical flow:
  1. Developer creates a virtual-card offer for a user (existing API).
  2. Developer calls `getCardProvisioningUrl` with that offer id.
  3. Developer surfaces the returned URL to the user (QR code, SMS, email, in-app button — anything that ends up on the user’s mobile device).
  4. User opens the URL within `expiresAt`. The App Clip / app handles the wallet provisioning.
Each call returns a fresh, single-use URL. The URL is opaque — it carries no credentials in plaintext; user identity is exchanged server-side via a short-lived lookup record (5-minute TTL). Requires the `CREATE_VIRTUALCARD` scope. Possible errors:
  • `Arguments.INVALID` — offerId is not a valid UUID.
  • `VirtualCard.OFFER_NOT_FOUND` — offer doesn’t exist or is inactive.
  • `VirtualCard.OFFER_NOT_ACCESSIBLE` — account lacks campaign access for this offer.
  • `VirtualCard.OFFER_NOT_AVAILABLE` — offer was redeemed into a card that is no longer active.
  • `VirtualCard.OFFER_NOT_TOKENIZATION_ELIGIBLE` — offer’s card program does not support wallet provisioning.
  • `Auth.USER_REVOKED_DEVELOPER_ACCESS` — user has revoked OAuth access for this developer application.
  • `Auth.INVALID_SCOPE` — caller’s token does not have CREATE_VIRTUALCARD.
  • `Generic.EXTERNAL_SERVICE_ERROR` — transient downstream failure; retry is safe.

​
Arguments

​
GetCardProvisioningUrlInput!
required
No description provided in the schema yet.

​
Returns

CardProvisioningUrl!