eduardweb.
Payments (Stripe, PayPal, Netopia)Avansat#woocommerce#stripe#php#marketplace#payments

Split payments în WooCommerce cu Stripe Connect: De ce urăsc coșurile multi-vendor

De Ioan Manole, 9 nov. 2026 · 17 vizualizări · 3 like-uri

Postat 9 nov. 2026
php
add_action('woocommerce_payment_complete', 'dispatch_vendor_stripe_transfers', 10, 1);

function dispatch_vendor_stripe_transfers($order_id) {
    $order = wc_get_order($order_id);
    $charge_id = $order->get_transaction_id();
    
    // Grupăm sumele per vendor din items
    $vendor_totals = calculate_vendor_splits($order);
    $stripe = new \Stripe\StripeClient(get_option('stripe_secret_key'));

    foreach ($vendor_totals as $vendor_id => $split_data) {
        $connected_account_id = get_user_meta($vendor_id, '_stripe_connect_account_id', true);
        
        if (!$connected_account_id) {
            $order->add_order_note("Transfer eșuat: vendorul {$vendor_id} nu are cont Stripe conectat.");
            continue;
        }

        try {
            $transfer = $stripe->transfers->create([
                'amount' => $split_data['net_amount_cents'],
                'currency' => strtolower($order->get_currency()),
                'destination' => $connected_account_id,
                'source_transaction' => $charge_id,
                'metadata' => [
                    'order_id' => $order_id,
                    'vendor_id' => $vendor_id
                ]
            ]);
            
            $order->add_order_note("Transfer reușit: {$transfer->id} către {$connected_account_id}");
        } catch (\Exception $e) {
            $order->add_order_note("Eroare transfer Stripe: " . $e->getMessage());
        }
    }
}

Când un client pune în coș o cană de la Vendorul A și un tricou de la Vendorul B, WooCommerce devine rapid un coșmar financiar. Dacă vrei plăți împărțite automat la checkout fără să faci reconciliere manuală în Excel la sfârșit de lună, Stripe Connect e cam singura soluție viabilă la noi. Doar că implementarea standard din pluginurile populare crapă exact unde te doare mai tare.

Capcana arhitecturală: Destination Charges vs Separate Charges

Toată lumea începe cu Destination Charges pentru că sună curat în documentație. Banii pleacă direct către contul vendorului, iar tu (platforma) îți reții un application_fee_amount. Vendorul e merchant of record pe extrasul bancar al clientului, iar tu scapi de bătăi de cap fiscale.

Problema apare la secunda doi: Destination Charges funcționează exclusiv dacă toate produsele din coș aparțin unui singur vendor. Stripe nu permite împărțirea unui singur PaymentIntent către două conturi de destinație diferite în același timp. Dacă ai coș mixt, Destination Charges pică din start.

Ești forțat să treci pe Separate Charges and Transfers. Asta înseamnă că platforma ta încasează toți banii de la client (tu ești Merchant of Record în fața băncii), iar după ce plata are statusul succeeded, trimiți API calls separate de tip Transfer către fiecare vendor în parte. Trade-off-ul e masiv: tu ești 100% responsabil legal pentru dispute și chargeback-uri. Dacă un vendor livrează cărămizi în loc de telefoane, clientul deschide dispută pe contul tău de Stripe, nu pe al lui.

KYC și tipul de cont: Custom vs Express

La un marketplace cu 45 de producători locali și vreo 1.400 de comenzi pe lună, am făcut greșeala inițială să merg pe conturi Stripe Custom ca să păstrez UI-ul complet white-label în WooCommerce. A fost un dezastru operațional. Încărcau buletine neclare, trimiteau IBAN-uri de persoane fizice pentru SRL-uri și stăteam noi la suport să le explicăm de ce le blochează Stripe plățile.

Am rescris onboarding-ul pe Stripe Connect Express. Da, vendorul este redirecționat timp de 2 minute pe un link hosted de Stripe pentru verificare și își vede propriul dashboard minimal. În schimb, Stripe preia tot calvarul de conformitate, colectare de date fiscale și avertizări de cont blocat. Scăderea de fricțiune pe suport tehnic a fost de peste 70% după migrare.

Cum legi transferurile de comanda WooCommerce

Nu rula niciodată transferurile Stripe pe hook-ul woocommerce_checkout_order_processed. Dacă gateway-ul are delay la confirmare sau folosești 3D Secure asincron, comanda încă nu are fondurile confirmate.

Ascultă webhook-ul checkout.session.completed sau folosește hook-ul intern woocommerce_payment_complete. Iei ID-ul tranzacției (charge_id), spargi totalul pe vendori conform liniilor din comandă, scazi comisionul tău procentual sau fix, apoi execuți transferurile cu metadata setată pe ID-ul comenzii WC ca să poți face audit oricând.

Cum ați rezolvat voi problema refund-urilor pe coșuri mixte? Taxați comisionul de transfer înapoi de la vendor sau înghite platforma diferența la retur?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.