Payouts Methodology
A payout moves funds from a business balance to a wallet user. Each payout is recorded in the ledger as a two-sided transaction to keep financial records accurate and traceable.
How Payouts Work
When a payout is completed, the ledger records two entries:
- Debit: The payout amount is deducted from the business balance.
- Credit: The same amount is added to the wallet user’s available balance.
This ensures that every payout has a matching debit and credit entry in the ledger.
Payout Lifecycle
A payout moves through a clear set of statuses from creation to completion.
Pending
The payout has been accepted and is waiting to be processed.
Processing
The payout is being validated and posted to the ledger.
Completed
The business balance has been debited and the wallet user balance has been credited.
Failed
The payout could not be completed. No funds are credited to the wallet user.
Payout Traceability
Every payout is traceable using identifiers, ledger entries, and timestamps.
Payout ID
A unique identifier assigned to each payout transaction.
Reference ID
A client-provided reference used to connect the payout to an invoice, payment request, campaign, payroll batch, refund, or internal transaction.
Ledger Entries
Debit and credit entries showing the exact financial movement between the business balance and the wallet user balance.
Timestamps
Key dates and times that show when the payout was created, processed, completed, or failed.
Payout Controls and Compliance
Vrtx applies payout controls to protect business balances, users, and regulatory requirements.
Balance Check
The business must have enough available balance before a payout can be processed.
Recipient Eligibility
The recipient wallet must be eligible to receive funds, including any required KYC or wallet status checks.
Regulatory Limits
Wallet balance limits, transaction limits, and monthly volume limits are enforced where applicable.
Risk Controls
Transactions may be screened for suspicious activity, unusual behavior, or risk-related conditions.
Compliance controls are enforced by Vrtx
Payouts are processed only when balance, recipient eligibility, regulatory limits, and risk controls are satisfied.
Failed Payouts
If a payout cannot be processed, the payout status changes to Failed.
A failed payout does not credit the wallet user. The response includes an error code and recommended action so the issue can be reviewed and resolved.
Common reasons include:
- Insufficient business balance
- Ineligible or inactive recipient wallet
- Regulatory limit exceeded
- Compliance or risk control failure
- Invalid or incomplete payout details