These docs are for v1.7. Click to read the latest docs for v2.1.

Digital Passport Kiosk - One universal link

Distribute your digital passports through a universal link.

Before you begin

The Digital Passport Kiosk APIs are useful when brands want to distribute a collection of digital passports from a single user interface for instance by displaying one QR code or sharing one link with customers.

Use case examples:

  • Your brand wants to distribute a pool of digital passports at a physical event.
  • Your brand distributes digital passports as a token of engagement via an online event or your content on social platforms.

📌

  • When a user scans the QR code or use the link, one digital passport of the collection is reserved for 15 minutes until it is claimed. If it is not claimed within this reservation time, the token is made collectable again for other users.
  • Only one digital passport can be claimed by a wallet. When a wallet uses the link again, the owner is redirected to the digital passport already claimed.

Let's start 🚀

Use the api/certificate/one2Many/v3.

InputMandatoryTypeDescription
label- tagStringOptional when campaignId is completed. Otherwise, mandatory.
campaignIdStringOptional when label or tag is completed. Otherwise, mandatory.
formatredirect, link, linkObject, contentFormat returned.

Result:

httpCodeParameters returned
linkObject - 200certificateId - Digital passport identification number.
passphrase - Digital passport passphrase.
deeplink - Deeplink to claim the digital passport.
link - 200deeplink to claim the digital passport.
redirect - 200Triggers a redirection to the claiming link of the digital passport.
400 → Missing query parameters.
→ No more digital passport available.
// linkObject return

{
    "method": "requestOwnership",
    "certificateId": 2069845,
    "passphrase": "z456wesa684p",
    "deeplink": "https://test.arianee.net/2069845,z456wesa684p"
}
// link return

https://test.arianee.net/2069845,z456wesa684p
// No more digital passport

{
    "message": "no certificate left from campaigns 63dcd9f3fb919e4d621ac206. Certificate must be part of the campaign ids and public tag."
}