Skip to content
← Back to activity

Solution skill

Marqeta: card declined despite a funded balance - reading the wrong balance

Version 3Sign in to save

Complete solution

Marqeta: card declined despite a funded balance - reading the wrong balance. available_balance is what can actually be spent, ledger_balance includes authorization holds that have not cleared, and pending_credits is money that arrived but is not usable yet. Use when hitting this exact issue with Marqeta. Not for unrelated errors or different features.

TL;DR

Availablebalance is what can actually be spent, ledgerbalance includes authorization holds that have not cleared, and pending_credits is money that arrived but is not usable yet.

The error

card declined despite a funded balance - reading the wrong balance

Fix

  1. Availablebalance is what can actually be spent, ledgerbalance includes authorization holds that have not cleared, and pending_credits is money that arrived but is not usable yet. Expected: you can confirm this matches your situation.

  2. Re-run the original operation and confirm the error is gone. Expected: no error, normal output.

When to use

  • You hit this exact error with Marqeta.
  • The symptom matches: card declined despite a funded balance - reading the wrong balance.

When NOT to use

  • A different error message from Marqeta; the cause here is specific to this error.
  • Unrelated Marqeta issues (different feature, different failure).
  • You need general documentation for the tool; check the official docs instead.

Compatibility

Reported against Marqeta. Source: https://github.com/cauldronup/cauldron/blob/HEAD/recipes/marqeta/README.md.

Variant phrasings

card declined despite a funded balance - reading the wrong balance

Why it happens

A Marqeta card is declined at authorization even though the account looks funded. There are three balances and only one is spendable.

Edge cases

  • If your error message differs even slightly, this is probably a different issue; search the exact text.
  • If the fix does not help, capture the full error output and check the source link for updates.

Source

https://github.com/cauldronup/cauldron/blob/HEAD/recipes/marqeta/README.md

Evidence

Source: A Marqeta card is declined at authorization even though the account looks funded. There are three balances and only one is spendable.

Verified resolution: [field notes]: availablebalance is what can actually be spent, ledgerbalance includes authorization holds that have not cleared, and pendingcredits is money that arrived but is not usable yet. An app that checks ledgerbalance authorizes payments the card then declines. Also remember a card payment is two events: an authorization that holds money and a separate clearing days later for a possibly different amount, so a ledger built by summing transactions double-counts. A declined transaction still appears in the listing with an amount but moved no money, so totals must filter on status.

Source URL: https://github.com/cauldronup/cauldron/blob/HEAD/recipes/marqeta/README.md

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_UqyRkl6osXFmHE5nEpw9vQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Marqeta: card declined despite a funded balance - reading the wrong balance <span>— Vectle</span></a>