Changelog
A summary of features, improvements, and fixes shipped in each Settlra API version. Breaking changes are highlighted and come with migration guides where applicable.
v0.5.0
Latest2025-06-15- NewBulk Payouts API — upload CSV or JSON arrays of up to 1,000 payouts in a single request.
- NewNew batch endpoints: POST /v1/batches, GET /v1/batches/:id, GET /v1/batches/:id/payouts.
- NewPer-payout webhook events fired for every row in a batch, enabling granular tracking.
- NewBatch status counters: total, completed, failed, pending — updated in real time.
- ImprovedPayout list endpoint now supports filtering by batch_id.
v0.4.0
2025-05-20- NewWebhooks management API — create, list, update, and delete webhook endpoints programmatically.
- NewBeneficiaries CRUD API — save recipients and reference them by ID when creating payouts.
- NewWebhook signature verification helpers added to the Node.js and Python SDKs.
- ImprovedWebhook delivery now retries up to 5 times with exponential backoff.
- ImprovedBeneficiary search supports fuzzy matching on name, phone, and nickname.
v0.3.0
2025-04-10- NewAirtel Uganda support — network slug: airtel_uganda. Full payout and quote coverage.
- NewImproved FX pricing engine — tighter spreads and more frequent rate refreshes.
- NewGET /v1/networks endpoint lists all supported networks and their current status.
- ImprovedQuote TTL extended to 5 minutes (previously 3 minutes).
- FixedFixed edge case where UGX amounts were truncated to the wrong number of decimal places.
v0.2.0
2025-03-01- NewMulti-factor authentication (MFA) support for dashboard and API key operations.
- NewAudit logs API — query a tamper-evident log of all account actions.
- NewAdmin API — manage team members and their permission levels.
- ImprovedAPI rate limits raised to 200 requests per minute (up from 60).
- ImprovedError responses now include a machine-readable error_code field alongside the message.
v0.1.0
Initial release2025-01-15- NewMTN Uganda payout support — send USDC, recipient receives UGX via mobile money.
- NewQuotes API — lock exchange rates for up to 3 minutes before initiating a payout.
- NewPayouts API — create payouts, poll status, and list history.
- NewIdempotency keys — safe retry support for all mutating endpoints.
- NewSandbox environment with test phone numbers and simulated payout lifecycle.
- NewNode.js SDK (@settlra/node) — v1.0.0 published to npm.