/card/reprioritizeAccount Scenarios

This guide will walk through some example scenarios of a customer re-prioritizing accounts for a card. In each scenario the customer will have three accounts: Checking A, Checking B, and Checking C. The below table shows the starting account priority:

Account NamePriorityNotes
Checking A1Checking A is the primary account on the card
Checking B2
Checking C3

Scenario 1 - Set priority of Checking B to 1.

  • Checking B will move from priority 2 to priority 1
  • Checking A will "slide down" one position
  • Checking B will be marked as the primaryAccountId for the card

The new account priority after a successful call to /card/reprioritizeAccount will be:

Account NamePriorityNotes
Checking B1Checking B is the primary account on the card
Checking A2
Checking C3

Scenario 2 - Set priority of Checking C to 1.

Building on the ending account priority from scenario 1, let's say the customer now wants to set Checking C as priority 1. This means:

  • Checking C will move from priority 3 to priority 1
  • Checking B and Checking A will each "slide down" one position
  • Checking C will be marked as the primaryAccountId for the card
    The new account priority after a successful call to /card/reprioritizeAccount will be:
Account NamePriorityNotes
Checking C1Checking C is the primary account on the card
Checking B2
Checking A3

Scenario 3 - Set priority of Checking B to 3.

Building on the ending account priority from scenario 2, let's say the customer now wants to set Checking B as priority 3. This means:

  • Checking B will change priorities from 2 to 3
  • Checking A will "slide up" one position
  • Checking C remains the primaryAccountId for the card
    The new account priority after a successful call to /card/reprioritizeAccount will be:
Account NamePriorityNotes
Checking C1Checking C is the primary account on the card
Checking A2
Checking B3