
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


