Skip to main content
API v2 is deprecated. This version will be discontinued on December 31, 2026. Please migrate to API v3 for new features, improved security, and continued support.

​
Changelog

Stay up to date with the latest changes to the FYATU API.

​
December 2024

​
v2.0.0 - API v2 Release

​
New
Complete API RedesignWe’ve launched API v2 with a completely redesigned architecture:
  • New Authentication: Business-ID + Bearer token authentication
  • RESTful Endpoints: Clean, intuitive endpoint structure
  • Improved Error Handling: Consistent error response format
  • Pagination: Standard pagination across all list endpoints
  • Webhooks: Real-time event notifications
​
New
Cardholder ManagementNew endpoints for managing cardholders:
  • POST /cardholders - Create cardholder
  • GET /cardholders - List cardholders with pagination
  • PATCH /cardholders/{id} - Update cardholder information
  • DELETE /cardholders/{id} - Remove cardholder and associated cards
​
New
Enhanced Card Operations
  • Freeze/unfreeze cards instantly
  • Update spending limits on the fly
  • View card transaction history
  • Wallet transactions endpoint for fund movements
​
New
Webhook SystemReal-time notifications for:
  • Card transactions (purchases, authorizations, reversals)
  • Monthly maintenance fees
  • Card unloading events
  • Card termination events
Includes webhook URL verification and simulation for testing.

​
Coming Soon

​
Q1 2025

​
Planned
VISA Card SupportIssue VISA virtual cards in addition to Mastercard.
​
Planned
Official SDKsOfficial SDKs for Node.js, Python, PHP, and Go.
​
Planned
Physical CardsIssue physical cards with custom branding.
​
Planned
Advanced AnalyticsAPI endpoints for spending analytics and reporting.

​
Migration Guide

​
Migrating from API v1

If you’re using API v1, here’s how to migrate:
1

Update Base URL

Change from /api/v1 to /api/v2
2

Update Authentication

Add the Business-ID header to all requests:
- Authorization: Bearer YOUR_API_KEY
+ Business-ID: BUS_your_business_id
+ Authorization: Bearer sk_live_your_api_key
3

Update Endpoint Paths

Endpoints have been reorganized:
v1v2
/status/account/status
/balance/account/balance
/cards/createPOST /cards
/cards/fundPOST /cards/{id}/fund
4

Update Response Handling

Response format is now consistent across all endpoints.
5

Set Up Webhooks

Configure webhooks for real-time notifications instead of polling.
API v1 will be deprecated on March 31, 2025. Please migrate to v2 before then.

​
Subscribe to Updates

Get notified about API changes:

Developer Newsletter

Subscribe to our developer newsletter for API updates