← दस्तावेज़ / मार्गदर्शिकाएँ
Stripe से आयात करना
Stripe से भुगतान निर्यात करें, एक आयात टेम्पलेट सेट अप करें, और Nordlet को शुल्क, ग्राहक, चालान और रिफंड की प्रविष्टियाँ करने दें।
यह मार्गदर्शिका आयात टेम्पलेट के माध्यम से Stripe भुगतानों के फ़ाइल आयात को कवर करती है: क्या निर्यात करना है, टेम्पलेट कैसे सेट अप करना है, और आयात से क्या बनता है। एपीआई विवरण बैंक और भुगतान आयात (Bank & payment imports) में हैं।
1. Stripe से भुगतान फ़ाइल निर्यात करें
Stripe डैशबोर्ड में Payments → Export खोलें, तिथि सीमा चुनें, All columns को वैसे ही रहने दें, और अपने द्वारा उपयोग किए जाने वाले मेटाडाटा कॉलम को शामिल करें (Stripe प्रत्येक मेटाडाटा कुंजी को <key> (metadata) नाम से एक कॉलम के रूप में निर्यात करता है, उदाहरण के लिए orderNo (metadata))। CSV डाउनलोड करें। लाइव और टेस्ट-मोड दोनों निर्यात काम करते हैं।
आयात करते समय उन पंक्तियों को छोड़ दिया जाता है जिनसे कोई धन नहीं स्थानांतरित हुआ: भुगतान के ऐसे प्रयास जो विफल रहे, रद्द कर दिए गए, या जिनके लिए अभी भी भुगतान विधि की आवश्यकता है, और ऐसे शुल्क जिन्हें कभी कैप्चर नहीं किया गया।
2. Stripe के लिए बैंक खाता बनाएँ
प्रत्येक आयात एक बैंक खाते में जमा होता है। Bank के अंतर्गत New bank account दबाएं, Type: Stripe चुनें (Stripe खाते का कोई IBAN नहीं होता है), इसे उदाहरण के लिए "Stripe" नाम दें, वह मुद्रा चुनें जिसमें आप शुल्क लेते हैं और उसका बहीखाता (ledger account) चुनें। Stripe का बैलेंस बैंक खाते की तरह काम करता है: शुल्क आते हैं, शुल्क बाहर जाते हैं, और पेआउट (payout) बैलेंस को आपके असली बैंक में ले जाते हैं।
3. आयात टेम्पलेट बनाएँ
Bank → Import templates के अंतर्गत New import template दबाएं, प्रकार Stripe चुनें, और इसे एक नाम दें।
फ़ील्ड (Fields)। Stripe निर्यात का प्रत्येक कॉलम एक पंक्ति है। Required in file बॉक्स यह बताता है कि अपलोड की गई फ़ाइल में वह कॉलम मौजूद होना चाहिए; आवश्यक कॉलम के बिना फ़ाइल को अस्वीकार कर दिया जाता है और गायब नामों को दिखाया जाता है। 19 Card … कॉलम डिफ़ॉल्ट रूप से अनटिक होते हैं क्योंकि Stripe कुछ खातों के लिए उन्हें छोड़ देता है।
बहीखाता (Ledger account)। जिन पंक्तियों में धन होता है - Amount, Fee, Amount Refunded - उन्हें किसी बहीखाते (ledger account) को असाइन किया जा सकता है, या तो किसी मौजूदा खाते को या उसी पंक्ति से बनाए गए नए खाते को। असाइन किए गए फ़ील्ड से उत्पन्न प्रत्येक गतिविधि को आयात के समय पोस्ट किया जाता है: धन आने पर Stripe बैंक खाते को डेबिट और असाइन किए गए खाते को क्रेडिट किया जाता है, धन जाने पर इसके विपरीत होता है, और बैंक लेनदेन को उस जर्नल प्रविष्टि (journal entry) से मिलान (matched) हुआ चिह्नित किया जाता है। सामान्य सेटअप यह है:
| फ़ील्ड | खाता | प्रभाव |
|---|---|---|
Fee |
एक PSP शुल्क व्यय खाता (मानक चार्ट में 6800) | प्रत्येक Stripe शुल्क को व्यय के रूप में दर्ज किया जाता है |
Amount |
"Not posted" छोड़ें | चालान मिलान के लिए शुल्क खुले रहते हैं (चरण 5 देखें) |
Amount Refunded |
"Not posted" छोड़ें | रिफंड क्रेडिट नोट के माध्यम से संभाले जाते हैं (चरण 5 देखें) |
गायब ग्राहकों को बनाएँ (Create missing customers)। इसे Customer Email पंक्ति पर टिक करें। फ़ाइल में मौजूद प्रत्येक ईमेल जिसके लिए अभी तक कोई पार्टनर नहीं है, उसके लिए एक ग्राहक बनाया जाता है: Customer Description से नाम (खाली होने पर ईमेल), मौजूद होने पर Card Address … कॉलम से पता। मौजूदा पार्टनर ईमेल द्वारा, केस-इनसेंसिटिव तरीके से पहचाने जाते हैं, इसलिए कुछ भी दो बार नहीं बनाया जाता है।
पार्टनर Stripe बनाएँ (Create partner Stripe)। इसे Fee पंक्ति पर टिक करें। आयात एक बार Stripe नाम का एक आपूर्तिकर्ता पार्टनर बनाता है (उस नाम के मौजूदा पार्टनर का पुन उपयोग किया जाता है) और पार्टनर के रूप में Stripe के साथ जर्नल में प्रत्येक शुल्क प्रविष्टि को दर्ज करता है, ताकि शुल्क बुकिंग से पता चले कि किसे भुगतान किया गया था।
मेटाडाटा फ़ील्ड (Metadata fields)। प्रत्येक मेटाडाटा कुंजी के लिए एक पंक्ति जोड़ें जिसे आप आयात द्वारा पढ़ना चाहते हैं, उदाहरण के लिए orderNo। इन पंक्तियों पर दो फ़्लैग सेट किए जा सकते हैं:
- चालान बनाएँ या लिंक करें (Create or link invoices) - उस कुंजी को चिह्नित करता है जो एक ऑर्डर की पहचान करती है (चरण 5)। केवल एक पंक्ति इसे ले जा सकती है। बनाए गए चालानों के लिए एक वैट (VAT) दर इसके बगल में दिखाई देती है, और एक वैकल्पिक कैटलॉग आइटम (Catalog item): चुने जाने पर, आयात द्वारा बनाई गई प्रत्येक चालान पंक्ति उस उत्पाद या सेवा का संदर्भ देती है, जिससे राजस्व आइटम के खाते में पोस्ट हो जाता है; पंक्ति का पाठ अभी भी चार्ज से आता है।
- कंपनी फ़्लैग (Company flag) - ऐसी कुंजी को चिह्नित करता है जिसका मूल्य यह बताता है कि खरीदार एक कंपनी है (
true,1,yes,company,businessयाb2b)। ऐसे शुल्कों से बनाए गए ग्राहक कंपनी प्रकार के पार्टनर होते हैं; बाकी सभी व्यक्ति होते हैं।
टेम्पलेट सहेजें।
4. फ़ाइल आयात करें
Bank पर Stripe बैंक खाता, टेम्पलेट और फ़ाइल चुनें, फिर Import दबाएं। आयात समाप्त होने तक बटन एक स्पिनर दिखाता है; एक बड़ी फ़ाइल में कुछ मिनट लग सकते हैं क्योंकि चालान एक-एक करके जारी किए जाते हैं। परिणाम पंक्ति यह रिपोर्ट करती है कि कितने लेनदेन आयात किए गए, कितने पहले से मौजूद थे, कितनी गतिविधियाँ पोस्ट की गईं, और कितने ग्राहक, चालान और क्रेडिट नोट बनाए गए। चेतावनियाँ उन ऑर्डर को सूचीबद्ध करती हैं जिन्हें संसाधित नहीं किया जा सका और क्यों।
वही फ़ाइल दोबारा आयात करना सुरक्षित है: लेनदेन Stripe चार्ज आईडी द्वारा, ग्राहक ईमेल द्वारा, ऑर्डर उनके मेटाडाटा मूल्य द्वारा पहचाने जाते हैं।
5. "चालान बनाएँ या लिंक करें" क्या करता है
चार्ज और रिफंड को चुने गए मेटाडाटा कुंजी (ऑर्डर संख्या) के मूल्य के आधार पर समूहीकृत किया जाता है।
- यदि उस मूल्य के लिए बिक्री चालान पहले से मौजूद है - एक बिक्री ऑर्डर जिसका बाहरी संदर्भ वह मूल्य है, या एक चालान जिसकी संख्या वह मूल्य है - तो शुल्कों का भुगतान के रूप में उनसे मिलान किया जाता है।
- अन्यथा ग्राहक के लिए एक बिक्री चालान बनाया जाता है: प्रति चार्ज एक पंक्ति, चार्ज के पंक्ति पाठ और टेम्पलेट की वैट दर पर वैट-सहित मूल्य के रूप में चार्ज राशि के साथ, पहले चार्ज की तारीख पर। इसे तुरंत जारी और पोस्ट किया जाता है, और शुल्कों का इससे मिलान किया जाता है, ताकि यह भुगतान किए गए के रूप में दिखाई दे। चैनल
stripeवाला एक बिक्री ऑर्डर ऑर्डर संख्या के साथ दर्ज किया जाता है, ताकि अगला आयात बनाने के बजाय लिंक करे। - समूह में प्रत्येक रिफंड रिफंड की गई राशि के लिए उस चालान के विरुद्ध जारी किया गया एक क्रेडिट नोट बन जाता है, और रिफंड लेनदेन का इससे मिलान किया जाता है।
ग्राहक ईमेल के बिना, अलग-अलग मुद्राओं में शुल्कों वाले, या जिनका मौजूदा चालान अभी भी ड्राफ्ट है या पहले से भुगतान किया गया है, ऐसे समूहों को छोड़ दिया जाता है और चेतावनियों में सूचीबद्ध किया जाता है। उनके लेनदेन Bank → Transactions पर बेमेल रहते हैं।
चालान संख्याएँ पहले के वर्षों में तारीख वाले शुल्कों के लिए भी वर्तमान वर्ष की श्रृंखला से आती हैं, इसलिए ऐतिहासिक आयात मौजूदा संख्याओं से नहीं टकराते हैं।
6. टेम्पलेट के नीचे छह वैकल्पिक फ़ील्ड
अधिकांश कंपनियाँ सभी छह को खाली छोड़ती हैं और आयात बिल्कुल वैसे ही काम करता है जैसा अपेक्षित है। वे दो सीमित स्थितियों के लिए मौजूद हैं: आप कार्ड आरक्षणों को दस्तावेजों के रूप में दर्ज करना चाहते हैं, या आप ऐसा धन एकत्र करते हैं जो आंशिक रूप से किसी और का है।
ड्रॉपडाउन खाली क्यों दिखते हैं
तीन "ऑपरेशन प्रकार" ड्रॉपडाउन उन ऑपरेशन प्रकारों को सूचीबद्ध करते हैं जिन्हें आपकी कंपनी ने Account → Operation types के अंतर्गत बनाया है। यदि आपने कोई नहीं बनाया है, तो ड्रॉपडाउन में कुछ भी नहीं है। यह कोई त्रुटि नहीं है; पहले एक ऑपरेशन प्रकार बनाएँ, या फ़ील्ड को खाली छोड़ दें।
ऋणदाता मेटाडाटा फ़ील्ड (Lender metadata field) ड्रॉपडाउन उन मेटाडाटा कॉलम नामों को सूचीबद्ध करता है जिन्हें आपने इसी फॉर्म में ऊपर Metadata fields सूची में टाइप किया था। वहाँ पहले एक मेटाडाटा फ़ील्ड जोड़ें और यह यहाँ दिखाई देगा।
आंशिक रिफंड लेबल और पूर्ण रिफंड लेबल (Partial refund label and Full refund label)
जब आयात किसी रिफंड के लिए क्रेडिट नोट बनाता है, तो ये उस क्रेडिट नोट के PDF के शीर्ष पर मुद्रित शब्द देते हैं।
| स्थिति | प्रयुक्त शब्द | डिफ़ॉल्ट |
|---|---|---|
| रिफंड चालान कुल से कम है | आंशिक रिफंड लेबल | DEPOZITAS |
| रिफंड चालान कुल के बराबर है | पूर्ण रिफंड लेबल | ANULIAVIMAS |
उन्हें केवल तभी बदलें जब आपकी कंपनी ऐसे दस्तावेजों पर अलग शब्द प्रिंट करती है। वे क्रमांकन को प्रभावित नहीं करते हैं और लेखांकन (accounting) को प्रभावित नहीं करते हैं।
प्राधिकरण ऑपरेशन प्रकार (Authorization operation type)
कार्ड प्राधिकरण ग्राहक के कार्ड पर आरक्षित धन है जिसे आपने अभी तक नहीं लिया है। Stripe निर्यात में इन पंक्तियों में Captured को false पर सेट किया गया है। आयात आम तौर पर उन्हें अनदेखा करता है, क्योंकि कोई धन स्थानांतरित नहीं हुआ था।
इस फ़ील्ड को भरें और ऐसी प्रत्येक पंक्ति इस ऑपरेशन प्रकार और उस दस्तावेज़ श्रृंखला का उपयोग करके एक जारी किया गया बिक्री दस्तावेज़ बन जाती है जिसकी ओर वह ऑपरेशन प्रकार इंगित करता है। इसे खाली छोड़ दें और उन पंक्तियों को छोड़ दिया जाता है, और आयात परिणाम चेतावनी दिखाता है "authorization(s) skipped: template has no authorization operation type"।
यदि आप पहले से नहीं जानते हैं कि आपके व्यवसाय को आरक्षणों को दस्तावेजों के रूप में दिखाना चाहिए, तो इसे खाली छोड़ दें।
पेआउट ऑपरेशन प्रकार, कमीशन ऑपरेशन प्रकार और ऋणदाता मेटाडाटा फ़ील्ड
इस भाग को पूरी तरह से छोड़ दें जब तक कि आपका व्यवसाय ऐसा धन एकत्र नहीं करता है जो किसी और का है - विक्रेताओं को भुगतान करने वाला एक मार्केटप्लेस, या ऋणदाताओं को भुगतान करने वाला एक प्लेटफॉर्म। एक साधारण दुकान इन्हें कभी नहीं भरती है।
Stripe इस कहानी को दो फ़ाइलों में बताता है। भुगतान (payments) निर्यात बताता है कि प्रत्येक ग्राहक ने क्या भुगतान किया। एक अलग स्थानांतरण (transfers) निर्यात बताता है कि इसमें से कितना आपने दूसरे पक्ष को भेजा। आयात को यह पता लगाने के लिए दोनों की आवश्यकता होती है कि आपने क्या रखा।
Bank पर आयात फॉर्म कम से कम एक Stripe टेम्पलेट मौजूद होने पर Stripe transfers export फ़ाइल बॉक्स दिखाता है; भुगतान फ़ाइल के बगल में वहाँ स्थानांतरण फ़ाइल चुनें। एपीआई के माध्यम से यह bank/statements/import का transfersCsv फ़ील्ड है।
जब दोनों फ़ाइलें मौजूद होती हैं:
| फ़ील्ड | यह क्या करता है |
|---|---|
| पेआउट ऑपरेशन प्रकार | दूसरे पक्ष को प्रत्येक स्थानांतरण के लिए, स्थानांतरित राशि के लिए एक बहीखाता प्रविष्टि (ledger entry) लिखी जाती है। डेबिट और क्रेडिट खाते इस ऑपरेशन प्रकार से आते हैं। खाली छोड़े जाने पर, प्रविष्टि इसके बजाय विक्रेता-देय और आपूर्तिकर्ता-देय पोस्टिंग नियमों का उपयोग करती है। |
| कमीशन ऑपरेशन प्रकार | वह हिस्सा जो आप अपने पास रखते हैं, जिसकी गणना चार्ज राशि में से Stripe शुल्क घटाकर और फिर स्थानांतरित राशि घटाकर की जाती है, और इसे तभी लिखा जाता है जब यह शून्य से अधिक हो। खाते इस ऑपरेशन प्रकार से आते हैं, अन्यथा विक्रेता-देय और कमीशन-राजस्व पोस्टिंग नियमों से आते हैं। |
| ऋणदाता मेटाडाटा फ़ील्ड | Stripe मेटाडाटा कॉलम का नाम जो यह रखता है कि धन किसके पास गया। उस मूल्य वाला एक पार्टनर बनाया जाता है, या यदि यह मौजूद है तो पुन उपयोग किया जाता है, और ऊपर दी गई दोनों प्रविष्टियों पर सेट किया जाता है। खाली छोड़ दिया जाना, या मूल्य के बिना एक पंक्ति, "lender not identified" चेतावनी देती है और प्रविष्टि बिना पार्टनर के लिखी जाती है। |
यदि दोनों ऑपरेशन प्रकार फ़ील्ड खाली हैं, तो कोई भी स्थानांतरण या कमीशन प्रविष्टियाँ बिल्कुल नहीं लिखी जाती हैं, भले ही कुछ और भी सेट हो।
7. आपके बैंक में पेआउट
भुगतान निर्यात में कोई पेआउट पंक्तियाँ नहीं होती हैं, इसलिए Stripe द्वारा आपके वास्तविक बैंक को भेजे जाने वाले धन को इसके बजाय पेआउट रिपोर्ट से बुक किया जाता है। Stripe डैशबोर्ड में Reports → Payouts → Payout reconciliation, itemized खोलें, इसे डाउनलोड करें, और इसे Bank → Settlements के अंतर्गत अपने वास्तविक बैंक खाते पर आयात करें, फिर प्रत्येक पेआउट को पोस्ट करें।
प्रत्येक पेआउट पंक्ति जिसके चार्ज, शुल्क या रिफंड को इस आयात ने पहले ही Stripe बैंक खाते पर रख दिया है, पोस्टिंग उस पंक्ति की शुद्ध राशि को Stripe बैंक खाते से वास्तविक बैंक खाते में ले जाती है। शुल्क और चालान भुगतानों को दूसरी बार बुक नहीं किया जाता है। जिन पंक्तियों का Stripe ने पेआउट किया जिन्हें इस आयात ने कभी नहीं देखा, उन्हें बैंक और भुगतान आयात (Bank & payment imports) में बताए गए अनुसार बुक किया जाता है।
प्रत्येक पेआउट Difference to imported payments दिखाता है: पेआउट ने क्या स्थानांतरित किया माइनस Stripe बैंक खाता उन्हीं शुल्कों और रिफंड के लिए क्या रखता है। शून्य का अर्थ है कि पेआउट Stripe खाते को साफ़ करता है। अंतर वाली पंक्ति, या Stripe खाते पर किसी गतिविधि के साथ जो अभी भी अनपोस्टेड है, की Lines to check में गणना की जाती है। भुगतान निर्यात प्रति चार्ज केवल कुल रिफंड रखता है, इसलिए एक चार्ज की सभी रिफंड पंक्तियों की उस कुल के मुकाबले एक साथ तुलना की जाती है।
यदि भुगतान फ़ाइल आयात होने से पहले किसी पेआउट को पोस्ट किया गया था, तो आयात उस पेआउट के शुल्कों, शुल्कों और रिफंड को छोड़ देता है और चेतावनियों में इसका नाम देता है।
8. इसके बाद कहाँ देखना है
- Bank → Transactions - प्रत्येक आयातित गतिविधि; मिलान किए गए चालान या जर्नल प्रविष्टि से लिंक होते हैं।
- Invoices - नोटों में ऑर्डर संख्या के साथ बनाए गए चालान और क्रेडिट नोट।
- Partners - बनाए गए ग्राहक।
- Ledger → Journal - शुल्कों, भुगतानों और चालानों के लिए पोस्टिंग।
बिलिंग
10 MB और 50,000 गतिविधियों तक की फ़ाइलें। प्रत्येक 10 आयातित गतिविधियाँ एक एपीआई अनुरोध के रूप में गिनी जाती हैं।