Vendor Finance, Escrow & Disputes
Escrow protection, upfront percentage holds, milestone releases, instant payouts, disputes, and client reviews. (48 articles)
Escrow Wallet: Balance vs Pending Release
Explain the difference between released wallet balance and funds still held for escrow.
Client-Approved Instant Release: Acceptance Gate
Explain the client acceptance and approval gate around instant release.
Instant Release Approval Tokens and 72-Hour Expiry
Explain single-use approval tokens and expiry in the instant-release flow.
Final Escrow Release After Client Satisfaction
Explain the remaining escrow release after a client marks a booking satisfied.
Proportional Fees and Double-Release Protection
Explain fee application per release slice and atomic release invariants.
Vendor Withdrawable Balance and Pending Withdrawal Reservation
Explain how pending withdrawals reduce currently withdrawable wallet balance.
Vendor Withdrawal Validation, Limits and Fraud Flags
Document the enforced payout rules before a withdrawal request is created.
Vendor Withdrawal Admin Lifecycle, Ledger and Payment Proof
Explain the request, approval/rejection, paid state and audit trail for vendor withdrawals.
AML & KYC Financial Compliance: Record Retention Standards (7 Years)
Documentation on BursaPay's compliance with Anti-Money Laundering (AML) and Counter-Terrorist Financing (CTF) mandates, including 7-year record retention.
Admin Dispute Arbitration: Evidence Assessment, Binding Rulings & Escrow Splits
How BursaPay administrative arbitrators evaluate disputed bookings, enforce final binding rulings, and disburse split escrow funds to parties.
Ambassador Commission Split: Tracking Referral Bonuses on Marketplace Bookings
How campus ambassadors earn recurring commissions when vendors they onboarded complete marketplace bookings, and tracking payouts in the Ambassador Portal.
Anti-Fraud Engine: Detecting Rapid Multi-Withdrawals & Near-Full Balance Draws
Technical details of BursaPay's heuristic withdrawal risk scoring (multiple recent rejections, high velocity, >95% balance draws) and automated admin flags.
Bank Account Verification: Paystack Recipient Code Creation & Account Validation
Technical deep dive into Paystack Transfer Recipient code generation (<code>RCP_xxxx</code>) when vendors link Nigerian bank accounts at /vendor/payout/.
Bank Chargebacks & Dispute Claims: Mitigating Fraudulent Chargeback Inquiries
How BursaPay defends vendors against credit/debit card chargebacks submitted to issuing banks, providing proof of delivery to protect vendor earnings.
Blacklisting Fraudulent Clients: Protecting Vendors from Serial Disputers
How BursaPay identifies, flags, and permanently blacklists abusive or fraudulent buyers who initiate bad-faith disputes and unwarranted chargebacks.
BursaPay Escrow Architecture: How Tri-Party Escrow Protects Vendors & Clients
Comprehensive architectural overview of BursaPay's tri-party escrow system, guaranteeing payment security for vendors while providing delivery assurance for buyers.
Currency Handling: Naira Settlement, FX Conversion & Cross-Border Card Payments
How BursaPay handles cross-border card transactions (USD/GBP/EUR), Paystack dynamic currency conversion, and instant settlement in Nigerian Naira (NGN).
Dispute Appeal Pathways: Requesting Super-Admin Re-Evaluation of Closed Rulings
How to file a formal appeal within 7 calendar days of an arbitration determination if new, undeniable evidence of contract fulfillment emerges.
Dispute Resolution Center: Reviewing Client Claims, Evidence & Counter-Evidence
Navigating the Dispute Resolution Center: reviewing client claims, uploading counter-evidence (chat logs, deliverable timestamps, raw files), and submitting rebuttals.
Double-Entry Accounting Sync: Escrow Liabilities, Wallet Credits & Platform Revenue
How BursaPay implements double-entry general ledger syncing (finance.ledger_engine) across escrow liabilities, vendor wallets, and platform revenue.
Emergency Financial Freeze: Admin Protocol for Suspected Platform Collusion
Administrative protocol for executing an emergency platform financial freeze on accounts suspected of money laundering, stolen card testing, or collusion.
End-of-Year Vendor Financial Summary: Generating Annual 1099/Tax Reports
How vendors can generate and download comprehensive annual revenue summaries, expense reports, and tax certificates at the conclusion of each financial year.
Escrow & Financial Alerts: Email Notifications, In-App Badges & Webhooks
How BursaPay dispatches financial alerts (payment received, instant release authorized, withdrawal paid) across email, SMS, and in-app notification centers.
Escrow Auto-Release Timers: Expiry Actions, Client Inaction & Default Resolution
How BursaPay protects vendors from client ghosting: automated 72-hour review countdown timers and default satisfaction escrow release.
Escrow Wallet Breakdown: Available Balance vs. Pending Escrow Release
Understanding the distinction between Withdrawable Balance (cleared funds ready for payout) and Pending Escrow (funds in progress) in the EscrowWallet model.
Escrow Wallet Lockout: Causes, Compliance Holds & Unlocking Requirements
Understanding temporary wallet lockouts: triggers (KYC document expiry, suspicious activity, open dispute thresholds), and the compliance resolution process.
Handling Payout Bank Account Reversals & NIBSS Transfer Error Codes
How BursaPay handles failed interbank transfers (NIBSS error codes, invalid account numbers, bank downtime) and automated wallet balance reversals.
Instant Escrow Release Engine: Eligibility, Pre-Authorization & Token Validation
How verified high-trust vendors utilize the Instant Escrow Release engine (InstantReleaseApproval model) with secure one-time authorization tokens.
Marketplace Disputes: Permissible Grounds, Disputed Amounts & Freeze Actions
Permissible grounds for raising a dispute via MarketplaceDispute model (non-delivery, poor quality, scope breach) and automatic escrow freeze mechanisms.
Marketplace Transaction States: Initiated, Success, Failed, Abandoned, Reversed
Technical examination of MarketplaceTransaction status codes, Paystack webhooks, and state recovery mechanisms for abandoned checkout carts.
Mathematical Breakdown: Vendor-Absorbed vs. Client Gross-Up Calculations
Detailed mathematical breakdown showing how BursaPay calculates exact checkout gross-up amounts when vendors toggle fee bearing options.
Mitigating Disputes: Crafting Airtight Service Specifications & Revision Limits
Best practices for preventing client disputes: writing clear deliverable bullet points, setting strict revision caps, and confirming intake briefs upfront.
Monthly Financial Statements: Reconciling Gross Bookings, Fees & Net Withdrawals
How to generate and interpret monthly vendor financial reconciliation statements, auditing gross order intake, platform fee deductions, and net payouts.
Mutual Dispute Settlements: Negotiating Partial Refunds & Split Escrow Settlements
How vendors and clients can negotiate mutual compromise settlements via resolve_dispute_api, splitting escrow funds without requiring admin arbitration.
Partial Escrow Releases: Milestone Progress Draws & Net Payout Computations
How the _do_partial_escrow_release() engine disburses milestone progress draws while maintaining remaining funds in escrow until final completion.
Payment History Portal: Filtering Transactions, Invoices & CSV/Excel Exports
How to use the Payment History portal (/vendor/payment-history/) to search, filter by date range, download receipts, and export CSV/Excel accounting data.
Paystack Transaction Fees: 1.5% + ₦100 Breakdown & ₦2,000 Cap Rules
Detailed mechanics of payment gateway processing fees: 1.5% + ₦100 flat fee (waived under ₦2,500) and the statutory maximum ₦2,000 cap.
Platform Commission Fee Tier Structure: 5%, 4%, 3.5%, and 3% Sliding Rates
Technical breakdown of BursaPay's progressive sliding platform fee structure, reducing from 5% for standard gigs down to 3% for large volume orders.
Platform Profit Distribution Engine: How BursaPay Allocates Net Commissions
Deep dive into the distribute_vendor_profit() utility, allocating net platform commissions among founders after deducting ambassador referral splits.
Premium Subscription Billing Invoices: Viewing Receipts, Renewal Dates & Charges
How to access and download official billing invoices for monthly (₦3,000) or yearly (₦25,000) BursaPay Premium subscription renewals.
Refund Processing Timelines: Bank Turnarounds, Gateway Debits & Notifications
Understanding refund settlement turnaround times: instant BursaPay Escrow reversals vs. commercial bank card refund processing timelines (1 to 5 business days).
Standard Escrow Release: Client Satisfaction Confirmation & Immediate Ledger Credit
Step-by-step walkthrough of the standard escrow release pipeline when a client clicks 'Mark Booking Satisfied' (/booking/<id>/satisfied/).
Submitting a Withdrawal Request: Payout Accounts, Min Thresholds & Validations
How to submit a bank withdrawal request (/vendor/wallet/), selecting verified bank details and passing automated pre-flight balance validations.
Unclaimed Escrow Balances & Dormant Wallet Handling Regulations
Regulations governing dormant vendor wallets and abandoned escrow funds: notification schedules, dormancy thresholds (12 months), and asset custody.
Vendor Withdrawal Ledger: Tracking Balance Before, Balance After & Audit Notes
Technical examination of the VendorWithdrawalLedger model, recording immutable balance_before and balance_after audit snapshots on every disbursement.
Withdrawal Lifecycle: Pending Review, Approved, Paid & Rejected States
Lifecycle states of vendor withdrawals: pending compliance review, approved by finance, paid via Paystack Transfer API, or rejected with reason code.
Withdrawal Thresholds: Minimum (₦1,000), Daily (₦500,000) & Weekly (₦2,000,000) Limits
Understanding BursaPay withdrawal limits: default daily cap of ₦500,000 and weekly limit of ₦2,000,000, and requesting elevated limits.
Withholding Tax (WHT) & Financial Statements for Corporate Tax Filings
How registered corporate vendors generate annual Withholding Tax (WHT) credit statements and financial summaries for FIRS and State IRS filings.