Skip to main content

Cards

The cards page is presented differently based on the user's account membership settings, so let's review the GraphQL queries first.

GraphQL queries​

With account access​

The following query works if the user can access the account (canViewAccount: true).

Retrieve all the account cards using the root cards query field and an accountId filter:

query {
cards(filters: {accountId: $CURRENT_ACCOUNT_ID}) {
# ....
}
}

No account access​

The following query works if the user doesn't have view access to the account (canViewAccount: false).

Retrive cards attached only to their membership:

query {
accountMembership(id: $CURRENT_ACCOUNT_MEMBERSHIP_ID) {
cards {
# ...
}
}
}

Card list views​

The view of the card list changes based on how many cards are displayed.

No cards​

If the query returns no cards, provide a way for users to add a card. No other content is needed in the body of the page.

Screenshot of the cards page when query returns zero cards

Single card​

If the query returns a single card, the body of the page should include the following content:

  • Tabs for virtual cards, physical cards, mobile payments, and transactions
  • Large image of the card with all card details (such as cardholder name, card number)
  • Card's spending limit
  • Remaining amount available to be spent over the next 30 days

Screenshot of the cards page when query returns one card

Multiple cards​

If the query returns multiple cards, the body of the page should include the following content in a list format:

  • Button to add a new card
  • Filters for status and format
  • List of cards
    • Small image of the card
    • Full name and card format
    • Card name
    • Spending limit (remaining balance over total spending limit)

Screenshot of the cards page when query returns multiple cards

🚀 Any questions? Help improve this project and the docs by opening a GitHub discussion.