Wallet Links
Generate wallet-card links and exchange legacy booking-ticket references
Wallet Links
Customer Wallet Card Links
Returns install links for an active wallet-card design and the authenticated customer.
GET /wallet-card-links| Parameter | Type | Required | Description |
|---|---|---|---|
designName | string | Yes | Exact wallet-card design name configured in Tiquo |
curl "https://edge.tiquo.app/api/client/v1/wallet-card-links?designName=member-card" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9..."{
"success": true,
"data": {
"designName": "member-card",
"displayName": "Member Card",
"walletCardUrl": "https://cards.tiquo.app/org_123/member-card/customer_123",
"appleWalletUrl": "https://cards.tiquo.app/org_123/member-card/customer_123?type=apple",
"googleWalletUrl": "https://cards.tiquo.app/org_123/member-card/customer_123?type=google"
}
}displayName is omitted when the design has no separate display name.
Hosted Package
Use window.Tiquo.getWalletCardLinks({ designName }) or the data-tiquo-wallet-card attribute. The npm DOM Package does not currently expose a wallet-card helper.
const links = await window.Tiquo.getWalletCardLinks({
designName: 'member-card',
});Errors
| Status | Description |
|---|---|
400 | designName is missing |
401 | Missing, invalid, or expired access token |
403 | No customer profile is linked to the authenticated account |
404 | The named active wallet-card design does not exist |
500 | Internal server error |
Legacy Booking-Ticket Exchange
Deprecated migration endpoint
New integrations should use the signed wallet URLs returned on booking ticketing objects. This endpoint exists only for older unsigned ticket references.
POST /legacy-wallet-ticket-linkThe request accepts an owned booking number, up to 128 characters:
curl -X POST "https://edge.tiquo.app/api/client/v1/legacy-wallet-ticket-link" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9..." \
-H "Content-Type: application/json" \
-d '{"bookingNumber":"BK-001234"}'{
"success": true,
"data": {
"walletTicketUrl": "https://cards.tiquo.app/ticket/org_123/BK-001234"
}
}For privacy, missing, malformed, unowned, and unavailable tickets all return the same 404 Ticket unavailable response. This endpoint also applies request limits and can return 429; unexpected service failures return 503.