Overview
The Daya API is built around a small set of core concepts that work together to convert NGN bank transfers into stablecoins.Onramps
Configurations that define how NGN is received and settled
Deposits
Individual NGN bank transfers into an onramp
Rates
Firm FX quotes with defined validity windows
Settlement
How converted stablecoins are delivered
Onramps
An onramp defines how NGN is received and how converted funds are settled. Each onramp specifies:- A virtual account for receiving NGN
- The FX rate behavior
- The settlement destination
Onramp Types
Daya supports three onramp types:-
Permanent VA → Auto-withdraw
Long-lived virtual account that always settles to the same address. -
Temporary VA → Auto-withdraw
Short-lived virtual account for one-time deposits with automatic settlement. -
Temporary VA → Merchant balance
Short-lived virtual account that credits your Daya balance.
Onramps are immutable after creation.
Deposits
A deposit represents a single NGN bank transfer into an onramp. Each deposit follows a defined lifecycle from detection to settlement or review.Rates
A rate is a firm FX quote with a defined validity window.Rate Application
| Onramp Type | FX Rate Used | Behavior |
|---|---|---|
| Temporary VAs | Onramp rate_id | Locked at creation |
| Permanent VAs | Current rate | Determined at settlement |
Settlement Modes
Settlement defines where stablecoins are sent after conversion.Auto-withdraw
Stablecoins are automatically sent to a blockchain address.Merchant balance
Stablecoins are credited to your Daya balance for later withdrawal.Virtual Accounts (VAs)
Virtual accounts are Nigerian Naira bank account numbers used to receive deposits.VA Properties
| Property | Temporary VAs | Permanent VAs |
|---|---|---|
| Lifetime | 25 minutes | Indefinite |
| Reuse | Never reused | Fixed to one destination |
| Deposits | One automatic settlement | Multiple deposits |
| Expiry | Late deposits → FLAGGED | No expiry |
Temporary VA Lifecycle
- Created with the onramp
- Active for up to 25 minutes
- Expires after the window closes
- Late deposits are FLAGGED