Type B1: Throwaway VA → Auto-Withdraw

Overview

Throwaway Auto-Withdraw onramps create short-lived NGN virtual accounts (25-minute TTL) that automatically convert deposits to USDC/USDT and send them to a specified on-chain address.

This is the recommended type for one-time transactions with guaranteed exchange rates.

Use Cases

One-time Purchases

User wants to buy a specific amount of USDC/USDT once

Rate Certainty

User needs a guaranteed exchange rate before transferring

Direct Wallet Payment

User wants funds sent directly to their wallet, not merchant balance

Time-sensitive Transactions

Transactions with strict timing requirements

Characteristics

Property	Value	Description
TTL	25 minutes	Virtual account expires after 25 minutes
FX Rate	Locked to rate_id	Guaranteed rate within validity window
VA Reuse	No	VA number not reused for 365 days
Rate Guarantee	Yes	Firm quote honored
Settlement	AUTO_WITHDRAW	Automatically sent to specified address
Destination	Per-onramp	Can differ for each onramp

FX Behavior

The onramp locks to a specific rate_id at creation:

Deposits arriving after the 25-minute window are flagged and require manual operations review. They do NOT automatically execute at the locked rate.

Settlement Configuration

Requires destination address and chain:

{
  "settlement": {
    "mode": "AUTO_WITHDRAW",
    "asset": "USDC",
    "chain": "BASE",
    "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }
}

Supported chains:

Chain	Network	Asset Support
`BASE`	Base mainnet	USDC, USDT
`ETH`	Ethereum mainnet	USDC, USDT
`POLYGON`	Polygon mainnet	USDC, USDT

The destination address is not permanently bound to the VA. Each new onramp can specify a different address, even for the same user.

Creating a Throwaway Auto-Withdraw Onramp

Step 1: Get Rate

curl --request GET \
  --url 'https://api.daya.xyz/v1/rates?from=NGN&to=USDC' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response:

{
  "rate_id": "rate_8x7k2mq9p",
  "from": "NGN",
  "to": "USDC",
  "rate": 1545.50,
  "expires_at": "2026-01-14T15:35:00Z"
}

Step 2: Create Onramp

curl --request POST \
  --url https://api.daya.xyz/v1/onramp \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "THROWAWAY",
    "user": {
      "email": "[email protected]"
    },
    "rate_id": "rate_8x7k2mq9p",
    "settlement": {
      "mode": "AUTO_WITHDRAW",
      "asset": "USDC",
      "chain": "BASE",
      "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
    }
  }'

Response:

{
  "onramp_id": "onramp_3j5k8n2q",
  "type": "THROWAWAY",
  "status": "ACTIVE",
  "rate_id": "rate_8x7k2mq9p",
  "payment_reference": "DAYA-3J5K8N2Q",
  "virtual_account": {
    "account_number": "9876543210",
    "account_name": "Daya - [email protected]",
    "bank_name": "Wema Bank",
    "bank_code": "035"
  },
  "expires_at": "2026-01-14T15:30:00Z",
  "settlement": {
    "mode": "AUTO_WITHDRAW",
    "asset": "USDC",
    "chain": "BASE",
    "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  },
  "created_at": "2026-01-14T15:05:12Z"
}

User Experience

Display to users:

Complete Your Payment

Guaranteed rate: 1 USDC = 1545.50 NGN

Transfer NGN to:

Bank:	Wema Bank
Account Number:	9876543210
Account Name:	Daya - [email protected]
Reference:	DAYA-3J5K8N2Q

⏰ Complete within 25 minutes

Expires at: 15:30:00

USDC will be sent to: 0x742d…5f0bEb

Show a countdown timer to create urgency. Users must transfer within 25 minutes.

Lifecycle

State changes:

ACTIVE: Can receive deposits (within 25-minute window)
EXPIRED: TTL elapsed, deposits are flagged
DISABLED: Manually disabled before expiry
FLAGGED: Risk or compliance issue

Late Deposit Handling

Deposits arriving after expiry are flagged:

Scenario	Outcome	Status	Reason
Deposit at 15:20 (before expiry)	✅ Success	`SETTLED`	Within validity
Deposit at 15:35 (after expiry)	❌ Flagged	`FLAGGED`	`"Deposit after onramp expiry"`
Deposit at 15:40 (rate expired)	❌ Flagged	`FLAGGED`	`"Deposit after rate expiry"`

Late deposits do not execute at the locked rate. They require manual operations review.

Deposit Flow

Happy path:

User transfers NGN

User sends NGN to virtual account within 25 minutes

Deposit detected

Status: PENDING_FXWebhook: deposit.created

FX executed

NGN converted to USDC at locked rateStatus: PENDING_WITHDRAWAL

Risk check

Risk engine evaluates withdrawal (address screening, limits)

On-chain broadcast

USDC transaction broadcast to specified chain (e.g., BASE)

Settlement

Transaction confirms on-chainStatus: SETTLEDWebhook: deposit.settled

Duration: Typically 2-5 minutes from NGN receipt to on-chain confirmation.

When to Use

✅ Use Throwaway Auto-Withdraw When
❌ Avoid When

User needs guaranteed exchange rate
One-time transaction
User wants funds directly in their wallet
Transaction has tight timing
Minimal on-chain settlement delay acceptable

Comparison with Other Types

Feature	B1: Auto-Withdraw	B2: Merchant Balance	A: Permanent
Expiry	25 minutes	25 minutes	Never
FX Rate	Locked	Locked	Current rate
Settlement	On-chain	Merchant balance	On-chain
Destination	Per-onramp	N/A	Fixed
Best for	One-time, direct payment	Aggregation	Recurring

Best Practices

Always show countdown timer

Display remaining time prominently. Users must understand the urgency.

function getTimeRemaining(expiresAt) {
  const total = Date.parse(expiresAt) - Date.parse(new Date());
  const minutes = Math.floor((total / 1000 / 60) % 60);
  const seconds = Math.floor((total / 1000) % 60);
  return { total, minutes, seconds };
}

Validate destination address

Verify the address is valid for the specified chain before creating the onramp.

Request fresh rate each time

Don’t reuse old rate_id values. Request a new rate immediately before onramp creation.

Handle expired onramp errors

If user returns after expiry, create a new onramp with a fresh rate.

Show tx_hash to users

Display the on-chain transaction hash so users can track their funds on block explorers.

Limits

Subject to standard limits:

Per-onramp: Max $1,000 per deposit
Per-merchant daily: Max $10,000
System-wide daily: Max $100,000

See Limits & Risk for details.

Error Scenarios

Rate Expired
Invalid Address
Limit Exceeded

Error:

{
  "error": {
    "code": "rate_expired",
    "message": "The specified rate_id has expired"
  }
}

Fix: Request a fresh rate via GET /v1/rates and retry.

Error:

{
  "error": {
    "code": "invalid_address",
    "message": "destination_address is not valid for chain BASE"
  }
}

Fix: Verify the address format matches the specified chain.

Error:

{
  "error": {
    "code": "limit_exceeded",
    "message": "Merchant daily limit of $10,000 exceeded"
  }
}

Fix: Wait until the next day or contact support to increase limits.

Next Steps

Throwaway Merchant Balance

Credit to merchant balance instead of on-chain

Create Onramp API

Full API reference

Edge Cases

Handle late deposits and failures

Webhooks

Set up real-time notifications

Getting Started

Core Concepts

Onramp Types

Lifecycle & Statuses

Limits & Risk

Type B1: Throwaway VA → Auto-Withdraw

Overview

Use Cases

One-time Purchases

Rate Certainty

Direct Wallet Payment

Time-sensitive Transactions

Characteristics

FX Behavior

Settlement Configuration

Creating a Throwaway Auto-Withdraw Onramp

Step 1: Get Rate

Step 2: Create Onramp

User Experience

Complete Your Payment

Lifecycle

Late Deposit Handling

Deposit Flow

When to Use

Comparison with Other Types

Best Practices

Limits

Error Scenarios

Next Steps

Throwaway Merchant Balance

Create Onramp API

Edge Cases

Webhooks

Getting Started

Core Concepts

Onramp Types

Lifecycle & Statuses

Limits & Risk

​Overview

​Use Cases

One-time Purchases

Rate Certainty

Direct Wallet Payment

Time-sensitive Transactions

​Characteristics

​FX Behavior

​Settlement Configuration

​Creating a Throwaway Auto-Withdraw Onramp

​Step 1: Get Rate

​Step 2: Create Onramp

​User Experience

​Complete Your Payment

​Lifecycle

​Late Deposit Handling

​Deposit Flow

​When to Use

​Comparison with Other Types

​Best Practices

​Limits

​Error Scenarios

​Next Steps

Throwaway Merchant Balance

Create Onramp API

Edge Cases

Webhooks

Overview

Use Cases

Characteristics

FX Behavior

Settlement Configuration

Creating a Throwaway Auto-Withdraw Onramp

Step 1: Get Rate

Step 2: Create Onramp

User Experience

Complete Your Payment

Lifecycle

Late Deposit Handling

Deposit Flow

When to Use

Comparison with Other Types

Best Practices

Limits

Error Scenarios

Next Steps