What is an Onramp?
An onramp defines how funds flow from a Nigerian bank transfer to stablecoin settlement. Each onramp specifies:- How NGN is received (virtual account)
- When deposits are valid (lifetime and expiry)
- Which FX rate applies
- Where converted funds are settled
Onramp Properties
Every onramp includes the following core properties:| Property | Description |
|---|---|
onramp_id | Unique identifier |
type | PERMANENT or TEMPORARY |
status | ACTIVE, EXPIRED, DISABLED, FLAGGED |
user.email | End-user identifier |
rate_id | Associated FX quote (temporary only) |
virtual_account | NGN bank account details |
expires_at | Expiry time (temporary only) |
settlement | How converted funds are delivered |
created_at | Creation timestamp |
Onramp Types
Daya supports two categories of onramps.Permanent Virtual Accounts
A permanent onramp uses a long-lived virtual account.- No expiry
- Can receive multiple deposits
- FX rate is determined at settlement time
- Typically tied to one destination address
Temporary Virtual Accounts
An temporary onramp uses a short-lived virtual account.- 25-minute validity window
- Bound to a specific
rate_id - Virtual account is never reused
- Deposits after expiry are FLAGGED
Rate Binding Semantics
| Onramp Type | FX Behavior |
|---|---|
| Temporary | Firm rate locked at onramp creation |
| Permanent | Floating rate at settlement time |
rate_id expires, it does not settle automatically.
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.Limits
Each merchant can create up to 1,000 onramps per day.Exceeding this limit may temporarily restrict onramp creation.