Skip to main content
PUT
Update Linked Wallet Priority

Overview

Update the charging priority of card-linked internal wallets. Priority determines which wallet is charged first during card transactions. Lower priority numbers are charged before higher numbers (priority 1 is charged before priority 2). How Priority Works:
  1. Transaction is initiated
  2. Platform attempts to charge wallet with priority 1
  3. If insufficient balance or failure, moves to priority 2
  4. Process continues until transaction succeeds or all wallets exhausted

Authentication

string
required
Your public API client key
string
required
Bearer token for authentication

Request Body

array
required
Array of wallet priority updates

Response

boolean
Whether priority update was successful

Code Examples

Use Cases

Reorder All Wallets

Swap Two Wallet Priorities

Move Wallet to Top Priority

Important Notes

Update All Wallets: You must provide priority values for ALL linked wallets, not just the ones you want to change. Omitted wallets may lose their linked status.
Unique Priorities: Each wallet must have a unique priority value. Duplicate priorities will result in a validation error.
Sequential Numbering: While not required, it’s recommended to use sequential numbering (1, 2, 3…) for clarity and consistency.

Best Practices

Maintain Sequential Order

Validate Before Update