Boarding Passes, Rewards, and Tickets. All in one place!

Wallet Cards is an open platform for all companies developing Digital Card (Passbook) solutions aiming Android Users.

You just need to Register your company to get your API Key

ps: Auto-onboarding is currently under development. But still you can use Wallet Cards API for free with no limits!

Please just send an inquiry to [email protected] containing: Company Name, Contact Name (PIC), E-mail, Phone, Website

Wallet Cards follows Apple's (Passbook) Wallet Web Service API standards for registering a device for receiving push notifications. For more information, please visit Apple Wallet Web Service Reference

Wallet Cards uses a different Authorization header to ensure that the app is not mistakenly detected.

The Authorization header of Wallet Cards as below:

[Authorization] => WalletCards authToken (instead of [Authorization] => ApplePass authToken) as specified in the pass.

If your backend platform to manage Digital Wallet Cards (Passbook) already implemented for Apple Wallet Web Service API, you only need to take into account the specified Authorization header to flag the device is an Android Device and the Wallet App is the Wallet Cards.

The pushToken in the payload is similar to APN pushToken and you need to store it for your later use with the Wallet Cards push notification service.

You can easily detect the Wallet Cards app by the User-Agent. All requests from Wallet Cards always contain the User-Agent part as below:

[User-Agent] => WalletCards/<version> (Linux; U; <appVersion>; <deviceBrand> <deviceModel> Build/PPR1.180610.011)

Example:

[User-Agent] => WalletCards/2031 (Linux; U; 1.3.2; samsung SM-G975F Build/PPR1.180610.011)

Authentication
For authentication send your API Key in the HTTP Authorization header.

Authorization: <API Key>

API Endpoint
Sending push notifications consists in sending a POST request with a specific payload to the following App endpoint with the content type "application/json".

POST: https://api.walletcards.io/api/partners/push

Payload
[POST body content]

{
 "passTypeIdentifier": "pass.com.yourcompany.sample",
 "pushTokens":[
  "098f6bcd4621d373cade4e832627b4f6c4ca4238a0b923820dcc509a6f75849b",
  "fe01ce2a7fbac8fafaed7c982a04e229c81e728d9d4c2f636f067f89cc14862c"]
}

We provide Add to Wallet Cards badges in major languages that you can use to indicate your platform's support for the Wallet Cards App.

Some Examples:

Download Full Language Pack:

[ZIP] Click here to download full language package containing Add to Wallet Cards badges in all major languages.

Android Intents: (SOON)

Under development for future releases

Manual Method - If Wallet Cards not installed on the device:

GET https://play.google.com/store/apps/details?id=io.walletcards.android&referrer={encoded_pkpass_url} - HTTPS

OR

GET market://details?id=io.walletcards.android&referrer={encoded_pkpass_url} - HTTPS

Android Intents: (SOON)

Under development for future releases

Manual Method - If Wallet Cards already installed:

GET walletcards://import/{encoded_pkpass_url} - HTTPS