GuidesAPI ReferenceChangelog
Log In
Changelog
Back to All

01 May 2026

about 6 hours ago

⚠️ Deprecations

  1. In the Accounts API, accountDetails.balances is now deprecated in favor of balancesV2. This new field can support both fiat and blockchain-based balances. More on that below in the "New APIs" section!
    1. Target removal date: June 1, 2026

🚀 New APIs

  1. Select Mural Accounts can now hold FDIC-insured, USD fiat balances in addition to existing on-chain stablecoin balances. Please reach out to [email protected] for more information.
  2. New Payin Status Webhook Event: payin_status_changed. Subscribe to payin lifecycle changes instead of polling GET /payins/{id} — see here for more information on this new event category.
  3. The Payin model in the Payins API now contains more metadata about your Payin — payinRail, settlementStrategy, sourceAmount, settlementDetails, fees, and senderMetadata — see details here.
  4. Introducing Sandbox Simulation Endpoints — because we know testing your integration in a staging environment can be difficult. We plan on building this out over the next month:
    1. Ability to simulate ACH, Wire, SPEI, CVU, and PIX Payins to your Mural Accounts in our sandbox environment — see here for API reference.

🌐 New Routes

  1. USD payouts to external blockchain wallets from USD — customers can now send USD fiat balances to third-party blockchain wallet destinations, either via inline wallet addresses or a blockchain payout method. Supports payouts to Ethereum and Solana blockchains. Reach out to [email protected] if you are interested in this functionality.
    1. Note: this is only supported for payouts that originate from a USD fiat balance (see New APIs above)

⭐ Enhancements

  1. The Mural Account response now includes a new balances field, balancesV2. This field supports both fiat and blockchain balances, and you should use this field going forward.
    1. Note: we have started to return fiat and blockchain balances as strings to avoid precision loss.
  2. COP Payins via PSE Links can now onramp onto USDT/Polygon and USDC/Ethereum.
  3. Mural account wallet provisioning latency reduced — time-to-provision your Mural account after KYC gets approved was reduced from 60 seconds to 14 seconds.
  4. Create Payout Request API now throws PayoutComplianceValidationFailedError, which will indicate if additional information is required in the payout request — see here for details.
  5. Added expiresInSeconds parameter to the Create Payin endpoint for COP PSE link creation — check it out here.
  6. Postal-code validation for Chile, Argentina, and a universal format check.
  7. Encrypted PDFs are now rejected at the KYC upload boundary with a surfaced error.
  8. Blockchain mismatch error now includes both expected and provided values.

🐛 Bug Fixes

  1. Fixed an issue resulting in out-of-date USD fiat balances associated with Mural Accounts that held USD balances.
  2. Payout Requests involving fiat payouts — initiatedAt now properly set on PENDING → COMPLETED transitions.
  3. Fixed race condition blocking compliance review completion for Individual Light Tier compliance reviews.
  4. Fixed an issue where the GET /tos-link endpoint for child-org would return an expired TOS link.