Allmhairiú ó Stripe

Clúdaíonn an treoir seo allmhairiú comhaid d'íocaíochtaí Stripe trí theimpléad allmhairithe: cad le heaspórtáil, conas an teimpléad a chur ar bun, agus cad a chruthaíonn an t-allmhairiú. Tá sonraí na hAPI le fáil sa chuid Allmhairí bainc & íocaíochtaí.

1. Easpórtáil an comhad íocaíochtaí ó Stripe

Sa deashbörð (dashboard) Stripe, oscail Payments → Export, roghnaigh an raon dátaí, coinnigh All columns, agus cuir na colúin mheiteashonraí a úsáideann tú san áireamh (easpórtálann Stripe gach eochair mheiteashonra mar cholúin dar ainm <key> (metadata), mar shampla orderNo (metadata)). Íoslódáil an comhad CSV. Oibríonn easpórtálacha beo agus i mód tástála araon.

Scipeáiltear sraitheanna nach ndearna gluaiseacht airgid ar an allmhairiú: iarratais ar íocaíocht a tharla a bheith teipthe, curtha ar ceal, nó a éilíonn modh íocaíochta fós, agus muirir nár gabhadh riamh.

2. Cruthaigh cuntas bainc do Stripe

Titeann gach allmhairiú ar chuntas bainc. Faoi Bank, brúigh New bank account, roghnaigh Type: Stripe (ní bhíonn IBAN ag cuntas Stripe), tabhair ainm air, mar shampla "Stripe", roghnaigh an t-airgeadra a ngearrann tú ann agus a chuntas in iarmhéid an mhórleabhair (ledger account). Feidhmíonn iarmhéid Stripe cosúil le cuntas bainc: tagann muirir isteach, imíonn táillí amach, agus aistríonn íocaíochtaí amach (payouts) an t-iarmhéid chuig do fhíorbhainc.

3. Cruthaigh an teimpléad allmhairithe

Faoi Bank → Import templates, brúigh New import template, roghnaigh an cineál Stripe, agus tabhair ainm air.

Fields. Is sraith gach colún den easpórtáil Stripe. Léiríonn an bosca Required in file go gcaithfidh an colún a bheith i láthair sa chomhad uaslódáilte; diúltaítear do chomhad in easnamh colúin riachtanaigh agus taispeántar na hainmneacha atá ar díthe. Tá na 19 colún Card … dí-roghnaithe de réir réamhshocraithe toisc go n-fhágann Stripe ar lár iad do roinnt cuntas.

Ledger account. Is féidir na sraitheanna a iompraíonn airgead - Amount, Fee, Amount Refunded - a shannadh do chuntas mórleabhair, ceann atá ann cheana nó ceann nua a cruthaíodh ón tsraith chéanna. Déantar gach gluaiseacht a ghintear ó réimse sannta a phostáil tráth an allmhairithe: déanann airgead isteach dochar (debit) do chuntas bainc Stripe agus creidmheas (credit) don chuntas sannta, déanann airgead amach a mhalairt, agus marcáiltear an t-idirbheart bainc mar mheaitseáilte leis an iontráil irise sin. Is é an socrú is gnách ná:

Réimse (Field)	Cuntas (Account)	Éifeacht (Effect)
Fee	cuntas caiteachais táillí PSP (6800 sa tsraith chaighdeánach)	Cuirtear gach táille Stripe sa leabhar mar chaitheamh
Amount	fág "Not posted"	Fanann muirir oscailte le haghaidh meaitseála sonrasc (féach céim 5)
Amount Refunded	fág "Not posted"	Déitear le haisíocaíochtaí trí nótaí creidmheasa (féach céim 5)

Create missing customers. Tic an rogha seo ar an tsraith Customer Email. Do gach ríomhphost sa chomhad nach bhfuil comhpháirtí (partner) ina leith fós, cruthaítear custaiméir: ainm ó Customer Description (an ríomhphost má tá sé báite), seoladh ó na colúin Card Address … nuair atá siad i láthair. Aithnítear comhpháirtithe atá ann cheana de réir ríomhphoist, ganaird ar chás litreach (case-insensitively), ionas nach gcruthaítear aon rud faoi dhó.

Create partner Stripe. Tic an rogha seo ar an tsraith Fee. Cruthaíonn an tallmhairiú comhpháirtí soláthróra dar ainm Stripe uair amháin (athúsáidtear comhpháirtí atá ann cheana leis an ainm sin) agus taifeadann sé gach iontráil táille san iris le Stripe mar chomhpháirtí, ionas go dtaispeánann áirithintí táillí cé a íocadh.

Metadata fields. Cuir sraith amháin leis in aghaidh gach eochair mheiteashonraí a theastaíonn uait a léamh leis an allmhairiú, mar shampla orderNo. Is féidir dhá bhratach a shocrú ar na sraitheanna seo:

• Create or link invoices - marcálann sé an eochair a aithníonn ordú (céim 5). Ní féidir ach le sraith amháin é seo a iompar. Taispeántar ráta CBL do shonraí cruthaithe in aice leis, agus Catalog item roghnach: nuair a roghnaítear é, tagraíonn gach líne sonrasc a chruthaíonn an t-allmhairiú don táirge nó don tseirbhís sin, ionas go bpostáiltear ioncam chuig cuntas an ailt; tagann téacs na líne ón muirear fós.
• Company flag - marcálann sé eochair a luíonn a luach gur cuideachta é an ceannaitheoir (true, 1, yes, company, business nó b2b). Is comhpháirtithe de chineál cuideachta iad custaiméirí a cruthaítear ó mhúnraí den sórt sin; is daoine gach duine eile.

Sábháil an teimpléad.

4. Allmhairigh an comhad

Ar Bank, roghnaigh an cuntas bainc Stripe, an teimpléad, agus an comhad, ansin brúigh Import. Taispeánann an cnaipe rothlán (spinner) go dtí go mbeidh an t-allmhairiú críochnaithe; d'fhéadfadh comhad mór nóiméad a thógáil toisc go n-eisítear sonrasc ceann ar cheann. Tuairiscíonn an líne torthaí cén méid idirbheart a allmhairíodh, cén méid a bhí ann cheana, cén méid gluaiseachtaí a phostáladh, agus cén méid custaiméirí, sonrasc agus nótaí creidmheasa a cruthaíodh. Liostaíonn rabhaidh na horduithe nár pórtaíodh agus an fáth.

Tá sé sábháilte an comhad céanna a allmhairiú arís: aithnítear idirbhearta de réir ID muirir Stripe, custaiméirí de réir ríomhphoist, orduithe de réir a luacha meiteashonraí.

5. Cad a dhéanann "Create or link invoices"

Grúpáiltear muirir agus aisíocaíochtaí de réir luach na heochrach meiteashonraí roghnaithe (uimhir an ordaithe).

• Má tá sonrasc díolacháin don luach sin ann cheana - ordú díolacháin arb é an tagairt sheachtrach é an luach sin, nó sonrasc arb é a uimhir an luach sin - meaitseáiltear na muirir leis mar íocaíochtaí.
• Seachas sin, cruthaítear sonrasc díolacháin don chustaiméir: líne amháin in aghaidh an muirir, le téacs líne an muirir agus méid an muirir mar phraghas cuimsitheach CBL ag ráta CBL an teimpléid, dátaithe ar an gcéad muirear. Eisítear agus postáiltear é láithreach, agus meaitseáiltear na muirir leis, ionas go dtaispeántar mar a íocadh é. Taifeadtar ordú díolacháin le cainéal stripe leis an uimhir ordaithe, ionas go ndéanann an chéad allmhairiú eile nascadh in ionad a chruthú.
• Tiocfaidh gach aisíocaíocht sa ghrúpa chun bheith ina nóta creidmheasa eisithe i gcoinne an tsonrasc sin don mhéid aisíoctha, agus meaitseáiltear an t-idirbheart aisíocaíochta leis.

Scipeáiltear grúpaí gan ríomhphost custaiméara, le muirir in airgeadraí éagsúla, nó a bhfuil a sonrasc reatha fós ina dhréacht nó íoctha cheana féin, agus liostaítear iad sna rabhaidh. Fanann a gcuid idirbheart gan mheaitseáil faoi Bank → Transactions.

Tagann uimhreacha sonrasc ó shraith na bliana reatha fiú do mhuirir atá dátaithe i mblianta roimhe sin, ionas nach mbuaileann allmhairí stairiúla le huimhreacha atá ann cheana.

6. Na sé réimse roghnacha ag bun an teimpléid

Fágann an chuid is mó de chuideachtaí na sé cinn go léir folamh agus oibríonn an t-allmhairiú go díreach mar an gcéanna. Tá siad ann do dhá staid chúng: gur mhaith leat áirithintí cárta a taifeadadh mar dhoiciméid, nó go mbailíonn tú airgead a bhaineann go páirteach le duine éigin eile.

Cén fáth a bhfuil na biachláir thiteacha (dropdowns) folamh

Liostaíonn na trí biachlár tite "operation type" na cineálacha oibríochta a chruthaigh do chuideachta faoi Account → Operation types. Mura bhfuil aon cheann cruthaithe agat, níl aon rud sa bhiachlár tite. Ní locht é sin; cruthaigh cineál oibríochta ar dtús, nó fág an réimse folamh.

Liostaíonn an biachlár tite Lender metadata field na hainmneacha colúin mheiteashonraí a chlóscríobh tú sa liosta Metadata fields níos airde sa fhoirm chéanna seo. Cuir réimse meiteashonraí leis an sin ar dtús agus feicfear anseo é.

Lipéad aisíocaíochta páirteacha (Partial refund label) agus Lipéad aisíocaíochta iomláine (Full refund label)

Nuair a chruthaíonn an t-allmhairiú nóta creidmheasa d'aisíocaíocht, tugann siad seo an focal a phriontáiltear ag barr PDF an nóta creidmheasa sin.

Staid (Situation)	Focal a úsáidtear (Word used)	Réamhshocrú (Default)
Tá an aisíocaíocht níos lú ná iomlán an tsonrasc	Lipéad aisíocaíochta páirteacha	DEPOZITAS
Is ionann an aisíocaíocht agus iomlán an tsonrasc	Lipéad aisíocaíochta iomláine	ANULIAVIMAS

Ná athraigh iad ach má phriontaíonn do chuideachta focail éagsúla ar dhoiciméid den sórt sin. Ní théann siad i bhfeidhm ar an uimhriú ná ar an gcuntasaíocht.

Cineál oibríochta údaraithe (Authorization operation type)

Is éard atá in údarú cárta ná airgead curtha in áirithe ar chárta custaiméara nár thóg tú fós. San easpórtáil Stripe tá Captured socraithe go false ag na sraitheanna seo. Déanann an t-allmhairiú neamhaird díobh de ghnáth, toisc nár ghluais aon airgead.

Líon an réimse seo agus tiocfaidh gach sraith den sórt sin chun bheith ina dhoiciméad díolacháin eisithe, ag baint úsáide as an gcineál oibríochta seo agus an tsraith doiciméad a n-imíonn an cineál oibríochta sin air. Fág folamh é agus scipeáiltear na sraitheanna sin, agus taispeánann toradh an allmhairithe an rabhadh "authorization(s) skipped: template has no authorization operation type".

Mura bhfuil a fhios agat cheana féin nach mór do do ghnó áirithintí a thaispeáint mar dhoiciméid, fág folamh é.

Cineál oibríochta payout, Cineál oibríochta coimisiúin agus Réimse meiteashonraí iasachtóra (Lender metadata field)

Scipeáil an chuid seo go hiomlán mura mbailíonn do ghnó airgead a bhaineann le duine éigin eile - margadh (marketplace) ag íoc díoltóirí, nó ardán ag íoc iasachtóirí. Ní líonann siad seo isteach riamh i siopa gnách.

Inisíonn Stripe an scéal seo i gcomhad amháin. Deir an easpórtáil payments cad a d'íoc gach custaiméir. Deir easpórtáil transfers leithleach cé mhéad díobh a chuir tú ar aghaidh chuig an bpáirtí eile. Teastaíonn an dá cheann ón allmhairiú chun oibriú amach cad a choinnigh tú.

Ar Bank taispeánann an fhoirm allmhairithe bosca comhaid Stripe transfers export nuair a bhíonn teimpléad Stripe amháin ar a laghad ann; roghnaigh an comhad aistrithe ann in aice leis an gcomhad íocaíochtaí. Tríd an API is é an réimse transfersCsv de bank/statements/import é.

Nuair a bhíonn an dá chomhad i láthair:

Réimse (Field)	Cad a dhéanann sé (What it does)
Payout operation type	Do gach aistriú chuig an bpáirtí eile, scríobhtar iontráil mhórleabhair amháin don mhéid aistrithe. Tagann na cuntais dochair agus creidmheasa ón gcineál oibríochta seo. Má fhágtear folamh é, úsáideann an iontráil na rialacha postála iníoctha díoltóra agus iníoctha soláthróra ina ionad.
Commission operation type	An chuid a choinníonn tú, arna ríomh mar mhéid an muirir lúide an táille Stripe lúide an méid a aistríodh amach, agus scríobhtar é amháin nuair a bhíonn sé sin níos mó ná nialas. Tagann cuntais ón gcineál oibríochta seo, murach sin ó na rialacha postála iníoctha díoltóra agus ioncaim choimisiúin.
Lender metadata field	Ainm an cholúin mheiteashonraí Stripe a shealbhaíonn cé a chuaigh an t-airgead chuige. Cruthaítear comhpháirtí leis an luach sin, nó athúsáidtear é má tá sé ann, agus socraítear é ar an dá iontráil thuas. Má fhágtear folamh é, nó sraith gan an luach, tugann sé an rabhadh "lender not identified" agus scríobhtar an iontráil gan chomhpháirtí.

Má tá an dá réimse cineál oibríochta folamh, ní scríobhtar aon iontrálacha aistrithe nó coimisiúin ar chor ar bith, cibé rud eile atá socraithe.

7. Íocaíochtaí amach chuig do bhanc

Níl aon sraitheanna payout ag an easpórtáil íocaíochtaí, mar sin déantar an t-airgead a sheolann Stripe chuig d'fhíorbhainc a chur sa leabhar ón tuarascáil payout ina ionad. Sa deashbörð Stripe, oscail Reports → Payouts → Payout reconciliation, itemized, íoslódáil é, agus allmhairigh é faoi Bank → Settlements ar do fhíorbhainc, ansin postáil gach payout.

I gcás gach líne payout a chuir an t-allmhairiú seo muirear, táille nó aisíocaíocht cheana féin ar chuntas bainc Stripe, aistríonn an postáil glanmhéid na líne ó chuntas bainc Stripe go dtí an fíorbhainc. Ní chuirtear táillí agus íocaíochtaí sonrasc sa leabhar an dara huair. Déantar línte a d'íoc Stripe amach nach bhfaca an t-allmhairiú seo riamh a chur sa leabhar mar a thuairiscítear i Allmhairí bainc & íocaíochtaí.

Taispeánann gach payout Difference to imported payments: an méid a ghluais an payout lúide an méid a shealbhaíonn cuntas bainc Stripe do na muirir agus na haisíocaíochtaí céanna. Ciallaíonn nialas go nglanann an payout cuntas Stripe. Líne le difríocht, nó le gluaiseacht ar an gcuntas Stripe atá gan phostáil fós, áirítear in Lines to check. Ní choinníonn an easpórtáil íocaíochtaí ach an t-iomlán aisíoctha in aghaidh an muirir, mar sin déantar gach líne aisíocaíochta de mhuirear amháin a chur i gcomparáid le chéile i gcoinne an iomláin sin.

Má postáladh payout sular allmhairíodh an comhad íocaíochtaí, scipeáiltear muirir, táillí agus aisíocaíochtaí an payout sin ag an allmhairiú agus ainmnítear é sna rabhaidh.

8. Cá háit le breathnú ina dhiaidh sin

• Bank → Transactions - gach gluaiseacht allmhairithe; nascann na cinn a mheaitseáiltear leis an sonrasc nó leis an iontráil irise.
• Invoices - sonraisc agus nótaí creidmheasa cruthaithe, leis an uimhir ordaithe sna nótaí.
• Partners - custaiméirí cruthaithe.
• Ledger → Journal - na postálacha le haghaidh táillí, íocaíochtaí agus sonrasc.

Billeáil (Billing)

Comhaid suas le 10 MB agus 50,000 gluaiseacht. Comhairtear gach 10 ngluaiseacht allmhairithe mar iarratas API amháin.