Stripe Connect Marketplace Accounting Workflow

Q: Kak se obrabotvat vrashtaniyata, koito se plashtat v po-kasno plashtane?

Te pristigat kato red refund v opisateliya otchet na po-kasnoto plashtane i se sravnyavat obratno s purvonachalnoto plashtane chrez chargeid na po-rano sravnenoto plashtane. Vrashtaneto, sintezirovano ot iznos na plashtaniya na nivo plashtane, e samo priblizitelno v tozi sluchai, taka che opisateliya otchet e po-sigurniyat izhod.

Rakovoditel za praktitsi za otchitane na plashtaniya, taksi, prevodi, vrashtaniya, sporechni plashtaniya i rezervi v smetkovoden lishin na pazari, koito se sravnyava bez greshki.

Povecheto smetkovodni problemi pri pazarite (marketplaces) se delyat na edna edinstvena greshka: tretiraneto na bankovoto plashtane ot Stripe kato prihod. Plashtaneto e netniyat ostatak ot desetki otdelni ikonomicheski sabitiya, a otchitaneto mu kato edin tochen red za prihodi zalichava platformenata komisionna, zadalzhenieto kam prodavacha, kakto i vsyaka taksa i spor, skriti v nego. Pravilniyat raboten protses razlagya plashtaneto, predi neshto da popadne v sreshtnata smetka.

Tova rakovoditel prosledyava vsyaka kategoriya na balansovite transaktsii v Stripe do saotvetnoto im smetkovodno myasto: vzemaniya, prihodi ot komisionni, zadalzheniya kam prodavachi, razhodi za obrabotka i prehodni smetki. To izpolzva dokumentiraniteendpoints za import i plashtane na Nordlet kato mehanizam za otchitane, vklyuchva primer za plashtane i zavarshva s kontrolen spisak za sravnyavane, koyto mozhe da izpalnyavate predi vseki balans.

Opredelete modela na plashtanete v Connect, predi da proektirate kakvoto i da bilo

Smetkovodnite pravila ne mogat da badat napisani, dokato ne razberete koy model na plashtane izpolzva vseki potok. Modelat opredelya chii balans v Stripe nosi plashtaneto, koy poemat taksite i kade vrashtaniyata i sporovete popadnat parvo.

Model v Connect	Plashtaneto e suzdadeno na	Poema taksite na Stripe	Vrashtaniyata/sporovete namalyavat	Smetkovodni posledstviya
Direktni plashtaniya (Direct charges)	Svarzanna smetka	Konfigurirano za vsyaka strana	Balansa na svarzannata smetka	Platformata otchita svoyata taksa za obrabotka kato prihod; deynostta po plashtaniyata na prodavacha se namira predimno v sreshtnoto na svarzannata smetka
Tselevo-nasocheni plashtaniya (Destination charges)	Platforma, s nezabaven prevod kam edna svarzanna smetka	Platforma	Platforma	Platformata otchita vzemaniyata ot klienti i taksata na Stripe; dyalat na prodavacha e zadalzhenie, a ne prihod
Otdelni plashtaniya i prevodi (Separate charges and transfers)	Plashtane na platformata, sled tova edin ili poveche otdelni prevodi	Platforma	Platforma	Plashtaneto i prevodite na prodavacha sa otdelni sabitiya; zadalzhenieto kam prodavacha se sledi nezavisimo ot klientskoto plashtane

Vpatsvaneto na samia Stripe za kak rabotyat plashtaniyata v integratsiyata s Connect potvarzhdava, che za tselevo-nasochenite plashtaniya i otdelnite plashtaniya i prevodi balansat na platformata poema taksite za plashtane, vrashtaniyata i obratnite chargeback-ove. Za direktnite plashtaniya svarzannata smetka poluchava plashtaneto, a taksite mogat da badat debitirani ot vsyaka ot stranite.

Prakticheskoto pravilo: ne kazvaite „plashtaneto ot Stripe e prihod na prodavacha“ ili „prodavachyt plashta taksite“, osven ako ne ste zapisali modela na plashtane za vseki potok. Zapazete tozi model zaedno s vsyaka transaktsiya. Smesvaneto na direktni i tselevo-nasocheni plashtaniya pod edno pravilo za otchitane e nai-bavnyat nachin da se poddade greshno predstavyane kakto za prihodi, taka i za zadalzheniya.

Tova rakovoditel predpolaga tselevo-nasocheni plashtaniya ili otdelni plashtaniya i prevodi, tursi se tozi nachin, zashtoto balansat na platformata nosi smetkovodnata tezhest i tam se izgrazhdat povecheto smetkovodni lishini na pazarite.

Kartiraite potoka ot sredstva, predi da importirate edinstven red

Predi da doprèsnete do import, nacertaite ednostranichna karta na transaktsiite za vseki potok:

Klientsko plashtane
  -> Stripe plashtane / balansova transaktsiya
  -> Taksa na Stripe
  -> Platformena taksa za obrabotka (komisionna)
  -> Prevod kam svarzanna smetka
  -> Vrashtane ili spor (ako e prilozhimo)
  -> Stripe plashtane
  -> Bankova postuplenie

Vsyaka strelka e otdelna balansova transaktsiya sas svoy ID, kategoriya, suma i dati. Tretiraite balansa na Stripe kato kliringova smetka, podobna na bankova: plashtaniyata vlizat, taksite i prevodite izlizat, a plashtaneto prenasya ostataka v istinskata banka. Dokumentatsiyata na Nordlet za bankovi i vnosni plashtaniya preporychva tochno tova tretirane za obiknovenata deynost na Stripe.

Izberete praviliya izhoden otchit na Stripe

Za avtomatizirani paketi za plashtaniya, izpolzvajte otcheta na Stripe Sravnyavane na plashtaniya, s opisani elementi (Payout reconciliation, itemized). Toi dava po edin red na balansova transaktsiya, grupira redovete po reporting_category, svarzva vseki edin s automatic_payout_id i predlaga obshti sumi za bruto, taksi i neto. Rakovoditelyat na Stripe za izbor na otcheti dokumentira tozi otchet i potvarzhdava charge_id, connected_account_id i destination_payment_id kato nalichni poleta na Connect.

Kade avtomatiziranite plashtaniya ne sa razresheni (nyakoi spogodbi za rachno plashtane), izpolzvajte otcheta za balans (Balance report) vmesto tova. Ne tretiraite obobshtenieto na plashtaniyata ot Dashboard kato dostatachno dokazatelstvo za otchitane. Obshtoto dokazva obshtata suma na paketa; samo opisateliya otchet obyasnyava komponentite.

Stripe preporychva klasifitsiraneto po reporting_category vmesto staroto pole type, a vseki red nosi ID source, koito se svarzva s osnovniya obekt. Obberete vnimanie na vremennoto ogranichenie: Stripe posochva, che dnite otcheti obiknoveno sa nalichni do obyad sledvashtiya den, a nezabavnite plashtaniya ne mogat da badat chisto razdeleni na individualni transaktsii, zatova se nuzhdayat ot otdelno sravnyavane na istoriyata na transaktsiite.

Klasifitsiraite vsyaka balansova transaktsiya po kategoriya

Izpolzvajte reporting_category kato osnoven klasifitsator, sled tova proverete source_id, charge_id i opisaniyata. Klasifikatsiyata, koyato ima znachenie:

Stripe deynost	Kategoriya na otchitane (`reporting_category`)	Smetkovodno talkuvane
Klientsko plashtane, kart ili lokalen metod za plashtane	`charge`	Finansirani ot klienta vzemaniya ili razplashtane na prodazhbi
Vrashtane	`refund`	Otmenvane na purvonachalnoto klientsko plashtane
Taksa za obrabotka, zadarzana ot Stripe	`fee`	Razhod za obrabotka na plashtaniya
Platformena taksa za obrabotka	`platform_earning`	Prihod ot komisionni
Varnashta se platformena taksa	`platform_earning_refund`	Namalyavane na prihoda ot komisionni
Prevod kam svarzanna smetka	`transfer`	Namalyavane na zadalzheniyata kam prodavacha
Otkazan prevod	`transfer_reversal`	Vozvrashtane ot svarzannata smetka
Otkaz na plashtane (chargeback)	`dispute`	Zaguba ot otkaz na plashtane; proverete obekta na izhodniya spor
Sporyt spechelen ili otkazan	`dispute_reversal`	Vozvrashtane na predi tova zaveden otkaz na plashtane
Plashtane kam banka	`payout`	Dvizhenie na pari v bankata, a ne prihod
Otmeneno plashtane	`payout_reversal`	Vrashtane na sredstva v balansa na Stripe
Zadarzhan rezerv	`connect_reserved_funds` / `risk_reserved_funds`	Ogranicheni sredstva, a ne razhod po podrazbirane
Sabirane na dulgoroshi otricatelni balansi	`connect_collection_transfer`	Sabitie za finansirane ili vrashtane, iziskvashto politika za risk

Edno preduprezhdenie za terminologiyata: staroto pole type na balansovite transaktsii izpolzva razlichni etiketi za sashtite sabitiya, sred koito sa payment, application_fee i adjustment. Dokumentatsiyata na Stripe za tipovete balansovi transaktsii izbroyava dvata rechnika. Ne smesvaite stoinost na type v pravilo za reporting_category i ne izmishlyavaite kategoriya kato dispute_loss, koyato Stripe ne iznasya. Ako iznosat nosi etiket, koyto ne poznavate, zapazete iznesenata stoinost i ya proverete sreshtu izhodniya obekt.

Otchitaite normalnata deynost na pazara v smetkovodnata lishina

Za platforma s tselevo-nasocheni plashtaniya ili otdelni plashtaniya i prevodi, kontseptualnite zapisi sa slednite.

Klientsko plashtane (parite na klienta vlizat v kliringoviya balans na Stripe):

Dr Stripe kliring                      Bruto klientsko plashtane
    Cr Torgovski vzemaniya             Bruto klientsko plashtane

Taksa za obrabotka v Stripe:

Dr Razhod za taksi v Stripe            Taksa na Stripe
    Cr Stripe kliring                  Taksa na Stripe

Ne vkarvajte taksata na Stripe v neto sreshtu prihoda, osven ako vasheto smetkovodno iziskvane izrichno ne go izziva i poddarzha netno predstavyane.

Platformena komisionna (vashiya prihod, izveden ot tova, koeto inache bi bilo dulgimo na prodavacha):

Dr Zadalzheniya kam prodavachi          Suma na komisionnata
    Cr Prihod ot komisionni            Suma na komisionnata

Prevod na prodavacha (razplashtane na dulgimi pari, a ne razhod):

Dr Zadalzheniya kam prodavachi          Suma na prevoda
    Cr Stripe kliring                  Suma na prevoda

Prevodat nikoga ne e avtomatichno razhod. Dyalat na prodavacha stava zadalzhenie, kogato plashtaneto se realizira, a prevodat pokriva tova zadalzhenie. Pravilata na Nordlet za otchitane na plashtaniya sledvat tova: redovete platform_earning se otchitat kam prihodi ot komisionni, dokato redovete transfer namalyavat zadalzheniyata kam prodavacha. Dokumentiranite default-ni klyuchove za otchitane sa settlements.commissionRevenue (default 5001), settlements.sellerPayable (default 4499), settlements.fees (default 6800) i settlements.suspense (default 4440), kato vseki ot tyah mozhe da se promenya za vsyaka kompaniya chrez pravilata za otchitane v API na Nordlet.

Obrabotvajte vrashtaniyata sreshtu purvonachalnata prodazhba, a ne kato svobodni bankovi elementi

Vrashtaneto se svarzva s purvonachalnoto plashtane ili faktura. Kontseptualno:

Dr Vrashtaniya / otmenuvaniya na prodazhbi    Suma na vrashtaneto
    Cr Torgovski vzemaniya                   Suma na vrashtaneto

Istinskoto otchitane zavisim ot tova dali prodazhbata e bila prietata, dali danakat tryabva da se otmeni i dali platformenata taksa za obrabotka e varna. Edno edinstveno vrashtane mozhe da dovede do otmenuvane na vzemane, otmenuvane na danak, vrashtane na taksa za obrabotka, otmenuvane na prevod ili namalyavane na zadalzheniyata kam prodavacha, kakto i posledstviye za taksata na Stripe, koeto tryabva da se proveri, vmesto da se predpolaga.

Vremennyat kapan: vrashtaneto chesto se plashta v po-kasno plashtane ot purvonachalnoto plashtane. Predpochitaite opisatelnite otcheti za sravnyavane na plashtaniya pred sintezirovano vrashtane ot iznos na nivo plashtane. Dokumentatsiyata na Nordlet preduprezhdava izrichno, che vrashtaneto, sintezirovano ot iznos na plashtaniya, e samo priblizitelno, kogato vrashtaneto se plashta po-kasno. Importirat na plashtaniya mozhe da prieme reda za vrashtane, da go sravni s purvonachalnata prodazhba i da otmeni vzemaniyata, kogato paketat se otchita.

Tretiraite sporovete otdelno ot vrashtaniyata

Sporat e pretenziya na przyateliya ili izdadelyalata banka, i Stripe mozhe da debetira kakto spornata suma, taka i taksata za spor predi reshenieto. Za tselevo-nasocheni plashtaniya i otdelni plashtaniya i prevodi, Stripe debetira balansa na platformata i za dvete, spored tehnite natsionalni pravila za vrashtaniya i sporeni plashtaniya. Platformata mozhe da opita da si vurne sredstvata chrez otmenuvane na prevoda kam prodavacha.

Izguben spor, ot gledna tochka na platformata:

Dr Zaguba ot chargeback / povisheni vzemaniya  Sporna suma
Dr Razhod za taksa za spor                     Taksa za spor
    Cr Stripe kliring                          Obshta suma

Ako prodavachyt poema zagubata i vazstanovyavaneto e potvardeno:

Dr Zadalzhenia kam prodavachi / smetka za vrazhtane  Vozvratima suma
    Cr Vazstanovyavane na chargeback                 Vozvratima suma

Ne zapiszvaite vrazhtane na prodavach samo zashtoto e bilo zaiaveno otmenuvane na prevod. Proverete dali otmenuvaneto e suzdadeno, uspeshno e i se pokazva v balansa na Stripe. Ako sporat e spechelen, Stripe vryshta spornata suma chrez red dispute_reversal; otmete zagubata ot chargeback i obrabotvajte otdelno vsyaka taksa za spor, koyto Stripe ne vryshta. Nordlet sravnyava redovete za chargeback, izpolzvaiki charge_id na predi tova sravneno plashtane, ot sashtiya fail ili ot po-ranen import.

Primer za obraboteno plashtane

Vzemete edin paket za avtomatizirano plashtane. Opisateliya otchet sadarzha:

Red charge: bruto 100.00, taksa na Stripe 3.20, neto 96.80
Red platform_earning: 15.00, komisionnata na platformata
Red transfer: 81.80 kam svarzaniya prodavach
Red refund ot po-rana prodazhba: bruto 20.00, plashtasht se v tozi paket
Red payout: obshtata suma na paketa, prenasiashta se v bankata

Sastav na plashtaneto, sledvaiki identichnostta na plashtaniyata na Stripe:

Bruto plashtaniya              100.00
- vrashtaniya                   20.00
- taksi na Stripe                3.20
- prevodi                       81.80
= neto do balansa na platformata -5.00

Redat platform_earning ne dvizhi pari vtor put. Toi posochva 15.00, koito ostavat v balansa na platformata, sled kato taksata i prevodat na prodavacha sa izleznali, taka che platformata da mozhe da otchita prihod ot komisionni, vmesto da go izveli.

Tuk prevodat na prodavacha plus vrashtaneto nadminavat netnata deynost po plashtaniyata, taka che paketat izliza s malko otricatelna suma i namalyava sledvashtoto plashtane ili izteglya ot balansa. Otcheteniyat zhurnal otmenya vhodyashtite vzemaniya za vrashtaneto, otchita 15.00 prihod ot komisionni, otchita 3.20 razhod za taksi, namalyava zadalzheniyata kam prodavacha s prevoda i zapisva otmenuvaneto na vrashtaneto. Bankoviyat red savpada s netoto, koeto stigat do smetkata. Nito edna edinstvena cifra ne se ravnyava na „prihod“, koeto e i telta.

Import i otchitane prez endpoint-a za plashtaniya na Nordlet

Za sravnyavane na nivo plashtane, izpolzvajte:

POST /v1/bank/settlements/import

sas Stripe dostavchika i opisateliya CSV. Nordlet grupirova redovete po automatic_payout_id, prevrashta vseki plashtane v paket za plashtane s obshti sumi za bruto, taksi i neto, propuska povtorni importi na veche otcheteteni plashtaniya, propuska redovete payout ot sastava na plashtaneto i avtomatichno sravnyava redovete za plashtania, vrashtaniya i sporedi, izpolzvaiki porachka, faktura, PaymentIntent, charge, source ili meta-danni. Stripe razdelya opisateliya otchet na edin fail za vsyaka sektsiya, taka che importiraite failovete za plashtania, vrashtania i taksi zaedno: redovete, prinadlezhashti na plashtane, koeto veche e importirano, no oshte ne e otcheteteno, se slivat v sushtestvuvashiya paket. Tova e raboten protses za import i otchitane, se dvizhi ot failove i endpoint-i za plashtania, a ne zhiv Stripe konektor; stranitsata s funktsii izbroyava kakvo pokrivat bankovite i plashtatelnite strani.

Sravnyavajte v slednata posledovatelnost: plashtaniyata kam fakturi, vrashtaniyata kam purvonachalni plashtaniya, sporovete kam purvonachalni plashtaniya, redovete za komisionni kam tretiraneto na komisionnite. Drazhte taksite na Stripe, korektsiite, rezervite i redovete za plashtania izvun sravnyavaneto na fakturite. Glosariat na Nordlet za sravnyavane na plashtaniya posochva, che redovete za taksi i korektsii po dizain ne mogat da se sravnyavat s fakturi; prenasochvajte neizsravnenite pari-nosiashti elementi kam prehodni smetki. Rachnata korektsiya izpolzva bank/settlements/match { lineId, invoiceId }, s null za invoiceId, za da otmenite sravnyavaneto.

Sled tova otchitaite edin balansiran paket:

POST /v1/bank/settlements/post

Tova suzdava edin balansiran zhurnal, plashta sravnenite fakturi, debetira smetkovodnata smetka na bankovata smetka za netnoto plashtane, debetira taksite, kreditira vzemaniyata za plashtaniyata, otmenya vzemaniyata za vrashtaniya i chargeback-ove, razdelya neizsravnenite pazarni plashtaniya mezhdu prihod ot komisionni i zadalzheniya kam prodavachi, kogato e podadeno commissionPercent, i izprashta neizsravnenite sumi kam prehodni smetki. Vsyaka kategoriya, koyato ne poznavava, sashto popada v prehodna smetka, a otgovorat posochva tazi kategoriya v preduprezhdenie, vmesto da gi poglashtava ticho.

Kontrolen spisak za sravnyavane

Izpalnyavajte tezi utvrazhdeniya predi vseki balans:

Nyama povtoryashti se balance_transaction_id
Nyama povtoryasht se paket za plashtane (provider, payout_id)
Sumata na redovete net se ravnyava na netoto na paketa
Netoto na paketa se ravnyava na bankovoto plashtane, spored vremeto i politikata za valuta
Vsyako vrashtane ima purvonachalno plashtane ili zapisano izkljuchenie
Vsyak spor ima referentsiya za spor ili plashtane
Vsyak prevod ima ID na svarzanna smetka
Vsyak red platform_earning ima opredeleno tretirane na komisionnite
Prehodnata smetka e nula ili napolno pregledana, vklyuchitelno vsyaka nepoznata kategoriya, posochena v preduprezhdenieto za otchitane
Zadalzheniyata kam prodavacha ne sa otricatelni bez otobren avans ili politika za vrashtane
Otchetenite paketi ne mogat ticho da se importiratili otchitat otnovo
Plashtane v druga valuta ot osnovnata valuta na kompaniyata se konvertira po kursa na data na plashtaneto, a razlikata sreshtu sobstvenia kurs na vsyaka faktura se otchita kato realizirana pechalba ili zaguba ot obmen; plashtane, koeto smesva valuti, se otmetva pri import

Sravnyavajte na tri niva: red (vsyaka transaktsiya ima zapazen ID, kategoriya, suma, valuta, izhod), plashtane (opisatelnite neto se ravnyavat na plashtaneto na Stripe i bankovoto postuplenie) i smetkovodna lishina (otcheteniyat zhurnal balansira i proizvezhda zhelanite pozitsii za prihodi, taksi, vzemaniya, zadalzheniya kam prodavachi i prehodni smetki). Spetsialno za balansite na prodavachite, proverete dali nachalnite zadalzheniya kam prodavacha plus noviya dyal na prodavacha, minus prevodite i validnite otmenuvaniya, se ravnyavat na krainite zadalzheniya kam prodavacha.

Povtaryashtata se greshka vuv vseki smetkovoden lishin na pazari e sashtata, s koyato zapochna: srivaneto na strukturirovano plashtane v edna edinstvena cifra. Drazhte komponentite otdelno, zakrepyajte vseki edin kam stabilen identifikator v Stripe i ostavete prehodnata smetka da drazhi vsichko, koeto oshte ne mozhete da obyasnite. Chistiyat balans e tova, na koeto ouditort shte se doveri.

FAQ

Dali plashtaneto ot Stripe e prihod na platformata?

Ne. Plashtaneto e netnoto ot plashtaniya, vrashtaniya, taksi za obrabotka, prevodi kam prodavachi, sporove i korektsii, koito se sluchvat da se plashtat v sashtiya paket. Otchitanyeto mu kato edin tochen red za prihodi zalichava zadalzheniyata kam prodavacha i razhoda za obrabotka v nego. Za pazar na agenti, prihodat e komisionnata, koyato redovete platform_earning identifikirat.

Sreshtu koi otchet na Stripe tryabva da sravnyavam?

Otchet sreshtu sravnyavane na plashtaniya, s opisani elementi (Payout reconciliation, itemized), zashtoto toi dava po edin red na balansova transaktsiya s reporting_category, automatic_payout_id i obshti sumi za bruto, taksi i neto. Obshtoto otchitane na plashtaniyata v Dashboard dokazva samo obshtata suma na paketa. Kade avtomatiziranite plashtaniya ne sa razresheni, izpolzvajte otcheta za balans (Balance report) vmesto tova.

Dali prevod kam prodavach tryabva da se otchita kato razhod?

Ne. Dyalat na prodavacha stava zadalzhenie v momenta, v koito klientskoto plashtane se realizira, a prevodat pokriva tova zadalzhenie. Otchitanyeto na prevodite kato razhod duplo broi razhoda i ostava zadalzheniyata kam prodavacha postoyanno presmetnati prekomerno.

Kakvo se sluchva s red v Stripe, chiyto kategoriya vnosyat ne razpoznava?

Toi otchita v prehodnata smetka za plashtaniya, po podrazbirane 4440, a otgovorat na otchitanyeto vrashta preduprezhdenie, posochvashto kategorite, koito otidoha tam. Rezervite i neobiknovenite korektsii obiknoveno popadnat po tozi nachin, koeto e umisleno: parite ostavat vidimi i zhurnalat ostava balansiran, dokade nyakoi ne reshi kade im e myastoto.

Kak se obrabotvat vrashtaniyata, koito se plashtat v po-kasno plashtane?

Te pristigat kato red refund v opisateliya otchet na po-kasnoto plashtane i se sravnyavat obratno s purvonachalnoto plashtane chrez charge_id na po-rano sravnenoto plashtane. Vrashtaneto, sintezirovano ot iznos na plashtaniya na nivo plashtane, e samo priblizitelno v tozi sluchai, taka che opisateliya otchet e po-sigurniyat izhod.