Partner Wallet And Billing helps approved partners fund connectivity orders and reconcile commercial activity.
Use it to review available balance, reserved balance, order captures, releases, credits, refunds, monthly commitment adjustments, and invoices.
Finance teams should use wallet, ledger, order, and invoice records together. No single view tells the whole story.
Wallet Balance
Wallet balance tracks partner funds in USD.
Available balance is the amount available for new orders. Reserved balance is the amount held for orders that have started but have not finished their final billing movement.
If available balance is too low, new order creation can stop until the wallet is funded or the commercial issue is resolved.
Reservations And Captures
An order can reserve funds before service preparation completes.
A capture records the final charge for a completed order. A release returns a reservation when the order does not complete or no longer needs the reserved amount.
Use the order ID and ledger entry ID together when reconciling a customer issue.
Credits And Refunds
Credits and refunds adjust the partner ledger according to the approved commercial and support outcome.
A credit can correct account balance. A refund can reverse an eligible order charge. Eligibility depends on order state, activation state, service use, support evidence, and the partner agreement.
Do not promise a refund before the order state and support evidence have been reviewed.
Monthly Commitments
Some partner agreements include a monthly commitment.
The billing area tracks the commitment, the amount already applied during the current month, and any estimated true-up. A true-up applies when the billing period closes below the agreed commitment.
Your commercial agreement controls the commitment amount and billing rules.
Invoices
Invoices summarize the billing period.
Each invoice includes the period, currency, gross activity summary, monthly commitment, true-up amount, total due, and status.
Invoice statuses are draft, issued, paid, and void.
Reconciliation
Reconcile finance records by matching:
- partner order ID
- Onyx order ID
- package ID
- ledger entry
- invoice period
- wallet movement
- support case when one exists
Use reconciliation to resolve duplicate charges, failed orders, refunds, credits, and monthly commitment questions.
Finance Access
Only approved finance, owner, or admin users should manage billing records.
Do not share wallet exports, invoices, or ledger details with users who do not need them for finance, support, compliance, or dispute handling.