
Q1 2025 Changelog
This update includes new features, updates, and key fixes designed to make your integrations with the Chimoney API more seamless.
New Features
We’ve added the following endpoints:
Get Country States/Regions
GET /v0.2.4/info/country-states-regions
Returns a list of states or regions for a given country (for example “California” for the US). Useful for address validation.
Bank Search
GET /v0.2.4/info/bank-search
Search for banks in a specific country with pagination support. Supports international banks.
Get Beneficiary Rules by Country
GET /v0.2.4/info/beneficiary-rules/{countryCode}
Fetch validation rules required for beneficiaries in supported countries (US, Mexico, Peru, Canada).
Beneficiary Route
We’ve introduced a dedicated Beneficiary Route to make managing payees easier:
List Beneficiaries
GET /v0.2.4/beneficiary - View all beneficiaries linked to an account.
Create Bank Beneficiary
POST /v0.2.4/beneficiary/bank - Add a new bank beneficiary directly via the API.
Updates
-
Improved examples and field descriptions for sub-accounts and multi-currency wallet creation (
firstName,meta,id). -
Clarified required fields in the multi-currency wallet
/createand/listendpoints. -
Removed
subAccountas a required field in the Multi-currency wallet transfer documentation. -
Users can now create and manage beneficiaries under sub-accounts.
-
Sender’s bank details are now returned in the response when a payment is initiated.
-
We enforced stricter validation rules across the API, including a minimum of two characters for bank search queries, ISO country code validation for all address fields, and clearer error messages for bank-related operations.
Fixes
- Improved error messages now include more specific authentication failure codes, improved redemption failure details (such as
valueInUSD,amount, and wallet currency), and clearer error responses for invalid bank lookups. - Fixed duplicate wallet funding alerts triggered during admin actions.
Ready to try the new features? Visit Chimoney API docs or explore them via Swagger.
Check out these other posts

Why 2025 Is The Year AI Agents Get Their Own Wallets (And Passports)

