Funding Lifecycle
Funding activity represents operational funding received and tracked through the Partner API lifecycle. Funding activity is associated with:- requests
- balances
- settlement eligibility
- fund multiple requests
- be partially allocated
- remain partially available
Funding Lifecycle States
RECEIVED
Funding was detected successfully. Operational validation may still be pending.DIRTY
Funding originated from a non-approved source. Dirty funding is operationally segregated and cannot participate in settlement or allocation.ELIGIBLE
Funding passed operational validation and may participate in request allocation. Eligible funding may be:- fully available
- partially allocated
- fully allocated
ALLOCATED
Funding was partially or fully assigned to operational requests. Allocated funding remains linked to the associated requests until settlement completion.CONSUMED
Funding was fully utilized through completed settlement flows. Consumed funding is no longer available operationally.Funding Validation
Funding validation verifies:- supported asset
- supported network
- operational compatibility
- approved funding source
Approved Funding Sources
Only approved funding sources are eligible for allocation. Funding received from non-approved sources:- remains visible operationally
- is excluded from settlement flows
- cannot participate in request matching
Partial Funding Support
Requests support partial funding. As a result:- multiple funding events may contribute to one request
- one funding event may contribute to multiple requests
Allocation Rules
Allocation occurs only after funding becomes:- request lifecycle
- available balances
- operational settlement requirements
Balance Visibility
Funding contributes to:- available balances
- allocated balances
- dirty balances
Operational Visibility
Partners may retrieve:- funding lifecycle states
- linked requests
- balance visibility
- operational allocation status
Precision Rules
| Asset | Precision |
|---|---|
| USTBL | Up to 6 decimals |
| USDT | Up to 2 decimals |
Error Scenarios
Funding may fail operational validation for reasons including:- unsupported asset
- unsupported network
- invalid funding source
- operational restrictions
- incompatible request lifecycle
Future Scope
The following capabilities are currently out of scope for V1:- manual funding reassignment
- partner-controlled allocation
- funding cancellation
- funding amendments
- webhook notifications
- advanced treasury visibility