Funded Payouts

While most payouts settle instantly against your pre-funded USD balance, certain cryptocurrency or dedicated settlement routings price the transfer and require you to fund the payout from your own non-custodial wallet.

Avvio holds no keys to these funds and cannot execute the transfer on your behalf. You will know a payout requires external funding because the creation response returns:

{
  "requiresFunding": true
}

1. Retrieve Funding Instructions

Call GET /payments/organizations/{orgId}/payouts/{payoutId}/funding:

GET /payments/organizations/{orgId}/payouts/payout_98124b89/funding

Response:

{
  "payoutId": "payout_98124b89",
  "amount": "200.00",
  "currency": "USDC",
  "depositAddress": "0x71C...492",
  "network": "base",
  "expiresAt": "2026-08-17T09:15:00.000Z"
}

🚧

Respect expiresAt

The pricing and exchange rate lock expire strictly at expiresAt. Sending on-chain funds against expired deposit instructions can result in unmatchable transfers.

2. Confirm Funding

Once you broadcast the transaction from your registered wallet, notify Avvio with the transaction hash:

POST /payments/organizations/{orgId}/payouts/payout_98124b89/funding/confirm
Idempotency-Key: 5a81e921-bc01-447a-9a11-0982716a5b42
Content-Type: application/json

{
  "transactionHash": "0x98a123...45f"
}

Avvio verifies the blockchain state before recording the deposit. The transaction must:

1. Exist on the designated network.
2. Have successfully confirmed.
3. Have transferred at least the required token amount to the exact depositAddress.

Confirmation Error Handling

Solana Funding Rail

On Solana rails, confirmation signatures are validated on syntactic shape rather than real-time chain inspection. If a signature is submitted for a wrong transaction, the payout remains pending. Treat any Solana payout still pending after its expiresAt as unfunded.