Seller Payouts Setup for Marketplace 1C-Bitrix
Seller payouts are a financial operation: the platform transfers the seller's revenue minus commission. 1C-Bitrix has no built-in tools for this. We need to implement balance tracking, payout request and confirmation process, and optionally — automatic transfer via payment gateway API.
Seller Balance Tracking
Balance is formed from financial operations recorded at each event:
-
+ on sub-order payment confirmation:
amount = subtotal - commission -
— on confirmed payout:
amount = payout_amount -
— on customer refund:
amount = -refund_amount + refund_commission
Table mp_finance_log:
| Field | Type | Description |
|---|---|---|
| ID | int, AI | |
| VENDOR_ID | int | FK to seller |
| TYPE | varchar | sale / commission / payout / refund |
| AMOUNT | decimal(10,2) | Positive = income |
| REFERENCE_ID | int | ID of sub-order or payout request |
| STATUS | varchar | pending / confirmed / cancelled |
| CREATED_AT | datetime |
Current balance = SUM(AMOUNT) WHERE VENDOR_ID = X AND STATUS = 'confirmed'.
Payout Process
Manual payout (standard scenario for most marketplaces):
- Seller in personal account clicks "Request Payout", specifies amount (not exceeding available balance)
- Entry created in
mp_payout_requestswith statuspending - Platform manager sees request in administrative interface
- After actual transfer, manager confirms payout in system → status changes to
completed, seller balance decreases
Minimum payout threshold, frequency (not more than once per week) — configured in b_option.
Automatic payouts via payment APIs (Tinkoff, YuMoney, CloudPayments, QIWI B2B) — add complexity but eliminate manager's manual work. On auto-payout, system initiates transfer to seller's details by schedule (Bitrix agent, for example, on Fridays). Seller's payment details must be stored encrypted.
Tax Documents
Platform must generate financial documents with payouts: service invoices (for commission), sales reports. PDF document generation via tcpdf or template. Documents linked to payout and available for download by seller and admin.
Timeline
Balance tracking and manual payouts with interface — 1–2 weeks. Automatic payouts via specific gateway API — additional 1–2 weeks. Financial document generation — additional 3–5 days.