add_filter('wc_stripe_payment_intent_args', 'custom_stripe_split_payment_args', 10, 2);
function custom_stripe_split_payment_args($args, $order) {
// Generăm un transfer_group unic bazat pe ID-ul comenzii
$args['transfer_group'] = 'order_' . $order->get_id();
// Putem seta și metadata pentru a urmări comisioanele mai ușor în dashboard
$args['metadata']['platform_fee_percent'] = '10';
return $args;
}Am implementat recent split payments cu Stripe Connect pe un WooCommerce cu peste 150 de vendori activi și a fost un rollercoaster tehnic destul de violent. Dacă plănuiești un marketplace pe Woo, postarea asta o să-ți salveze vreo două săptămâni de debug și câteva mii de euro pierduți în tranzacții eșuate. Mergem direct la ce contează: arhitectură, API și capcanele din producție.
De ce crapă pluginurile „de-a gata”?
Când pornești un proiect de tip marketplace, primul instinct e să cumperi un plugin mare de multi-vendor (cum e WCFM sau YITH) și să bifezi integrarea lor cu Stripe. Sună bine pe foaie, dar în producție, la un volum de peste 50 de comenzi pe zi, încep să apară problemele.
Marea problemă cu aceste pluginuri este că folosesc implementări legacy sau generice. Nu gestionează corect fluxurile 3D Secure (SCA) când ai în coș produse de la doi vendori din țări diferite. Dacă platforma ta e înregistrată în România, cumpărătorul e din Franța, iar vendorul e din Germania, regulile de autentificare bancară devin extrem de stricte. Dacă pluginul nu trimite corect parametrii de tranzacție către Stripe, banca cumpărătorului va respinge plata aleatoriu. Clientul pierde banii temporar (sunt blocați), iar tu pierzi conversia.
Trade-off-ul pe care trebuie să-l înțelegi: Express vs. Custom
Când configurezi Stripe Connect, ai de ales între trei tipuri de conturi pentru vendori: Standard, Express și Custom.
Pentru un marketplace pe WooCommerce, Stripe Connect Express este compromisul ideal. Cu Standard, vendorii tăi sunt trimiși în interfața Stripe clasică, ceea ce distruge complet UX-ul de onboarding. Cu Custom, ai control total asupra designului, dar ești responsabil legal pentru KYC (Know Your Customer) și colectarea documentelor de identitate. Crede-mă, nu vrei să dezvolți manual formulare de upload pentru buletine și să te asiguri că sunt GDPR compliant.
La Express, Stripe se ocupă de tot onboarding-ul și de verificarea anti-spălare de bani (AML), iar tu controlezi fluxul banilor prin API.
Cum legi corect plățile în cod
Cea mai curată metodă de a face split în WooCommerce este să folosești arhitectura separate_charges_and_transfers. Practic, încasezi întreaga sumă pe contul tău de platformă (încasarea principală), iar apoi distribui sumele către vendori, reținându-ți comisionul (application fee).
Codul de mai jos arată cum poți intercepta crearea Payment Intent-ului în WooCommerce pentru a asocia tranzacția cu un transfer_group. Acest grup îți va permite ulterior să muți banii către conturile conectate ale vendorilor după ce plata este confirmată.