Accounts API v1.0.1 — Release Notes

🚀 Accounts API Update v1.0.1 is now live! 🎉

This release promotes two previously-preview endpoints to production — savings-account interest history and card payouts — adds account-ownership enforcement, fixes several card-payout contract issues, and broadens currency support.

✨ What's New

• 💸 GET /interest is live (savings-account interest history)
• 💳 POST /payout/card wired to the real handler
• 🔒 Account-ownership enforcement on user-scoped reads (403 added to spec)
• 🧾 Card-payout contract fixes (object shape, error codes)
• 💱 🇴🇲 OMR, 🇶🇦 QAR, 🇦🇪 AED, and 🇬🇹 GTQ currencies added
• 📚 Docs reorganised into clearer Recipients sections

💸 Savings-Account Interest History

GET /accounts/user/account/bakkt/{account_uuid}/interest is no longer a [PREVIEW] placeholder.

What's New

• Returns real interest history for the savings account
• Response is a bare interest-payment[] array as documented
• Status mapping:
  • APPLIED → POSTED
  • INFLIGHT → PENDING
  • REJECTED / VOIDED / FAILED → FAILED
• operation_type is MIDNIGHT (end-of-day accrual)

Security

• Endpoint enforces account ownership via the authenticated principal
• Requests for an account_uuid that does not belong to the caller return 403 Forbidden (newly documented in the OpenAPI spec)

💳 Card Payouts

POST /user/account/bakkt/{account_uuid}/payout/card now flows end-to-end through the linked-card payout pipeline.

What Changed

• Wired to the dedicated createPayoutToCard handler
• Backed by a new dedicated card-payout action (replaces the generic create-payment overload)
• Route, request schema, and OpenAPI summary updated (no more [PREVIEW])

🧾 Card-Payout Contract Fixes

• Card object is no longer nested in the response — top-level fields only
• Unknown-card responses now return the correct error code
• AccountNotClosable is now mapped to HTTP 400 on the close endpoint (was previously a 5xx-class response)

💱 New Currencies: 🇴🇲 OMR, 🇶🇦 QAR, 🇦🇪 AED & 🇬🇹 GTQ

• 🇴🇲 OMR and 🇶🇦 QAR are now supported
• 🇦🇪 AED is now available across the API
• 🇬🇹 GTQ (Guatemalan Quetzal) is now supported across the API

📚 Docs & Tooling

• Endpoints reorganised into clearer Recipients categories with improved paths
• exclusiveMinimum syntax in the spec fixed for stricter client generators

🙌 Let us know if you need help integrating these updates!