गाइड

टैक्स और मुद्रा के डिफ़ॉल्ट के लिए विज़िटर का देश पता करें

नए विज़िटर को कीमत दिखाने से पहले एक लंबी ड्रॉपडाउन से उसका देश चुनने को कहना एक अतिरिक्त कदम है, जिसे एक ठीक-ठाक डिफ़ॉल्ट पूरी तरह हटा सकता है।

देश कोड पाना

विज़िटर के पते के साथ /v1/ip को एक कॉल मानक ISO 3166-1 alpha-2 फ़ॉर्मेट में country_code फ़ील्ड लौटाती है, और ज़्यादातर टैक्स और मुद्रा लुकअप तालिकाएँ पहले से इसी फ़ॉर्मेट को कुंजी के रूप में इस्तेमाल करती हैं।

GET /v1/ip?ip=198.51.100.7
{
  "status": "ok",
  "ip": "198.51.100.7",
  "version": 4,
  "found": true,
  "country": "Germany",
  "country_code": "DE",
  "region": "Berlin",
  "city": "Berlin",
  "postcode": "10115",
  "lat": 52.5200,
  "lon": 13.4050,
  "timezone": "Europe/Berlin",
  "asn": 6789,
  "org": "Example Telecom"
}

देश कोड से टैक्स और मुद्रा तक

country_code को अपनी टैक्स दर तालिका और मुद्रा तालिका से वैसे ही जोड़ें जैसे आप ग्राहक द्वारा हाथ से चुने गए देश को जोड़ते। IP से निकले देश को अंतिम जवाब नहीं, बल्कि डिफ़ॉल्ट मानें, और विज़िटर को इसे बदलने दें, क्योंकि यात्रा कर रहा ग्राहक या VPN के पीछे का ग्राहक हमेशा उस बिलिंग देश से मेल नहीं खाएगा जिसकी उसे असल में ज़रूरत है।

जब लुकअप कोई नतीजा न दे

जिस पते के लिए कोई लोकेशन डेटा दर्ज नहीं है, उसके अनुरोध पर एरर के बजाय found को false पर सेट करके लौटाया जाता है, और इसकी योजना स्पष्ट रूप से बनाना उचित है। ऐसे में फ़ील्ड खाली छोड़ने या खाली country_code को चुपचाप अपनी टैक्स गणना तक पहुँचने देने के बजाय एक समझदारी भरे डिफ़ॉल्ट देश और मुद्रा पर लौटें।

My Geocode खुद कहाँ अलग है

My Geocode की अपनी कीमतें दुनिया भर में सिर्फ़ EUR में चलती हैं, चाहे ग्राहक कहीं से भी बिलिंग कर रहा हो। यह इस बात से अलग मामला है कि आप अपने विज़िटर को क्या दिखाते हैं, जहाँ पहचाने गए देश के अनुसार दिखाई गई मुद्रा को स्थानीय बनाना पूरी तरह उचित है, भले ही आपका अपना बैकएंड सब कुछ एक ही मुद्रा में निपटाता हो, ठीक वैसे ही जैसे हमारा करता है।

एक गलती जिससे बचना चाहिए

किसी विज़िटर को पहचाने गए देश में बिना बदलाव के विकल्प के बाँध देना कभी-कभार गलत डिफ़ॉल्ट देने से बड़ी समस्या है। विदेश के किसी होटल से खरीदारी कर रहा ग्राहक, या किसी ऐसे कॉर्पोरेट VPN के पीछे का ग्राहक जो उसकी असली जगह से अलग देश में निकलता है, देर-सबेर गलत डिफ़ॉल्ट से टकराएगा। पहचाने गए देश को हमेशा ऑर्डर में जड़े गए तय मान के बजाय एक बदला जा सकने वाले फ़ील्ड के रूप में दिखाएँ।

अनुरोध की लागत

हर नए विज़िटर सत्र के लिए एक लुकअप, जो उस सत्र की अवधि तक कैश रहे, समझदारी भरा पैटर्न है। यह हर पेज व्यू के बजाय हर सत्र पर आपके दैनिक कोटा से एक अनुरोध है, जिससे एक व्यस्त साइट भी हर कुंजी के साथ मिलने वाले, या बिना किसी कुंजी के एक पते से उपलब्ध, प्रतिदिन 2,500 मुफ़्त अनुरोधों के अंदर आराम से रहती है।

उसी रिस्पॉन्स में एक timezone फ़ील्ड भी होता है, इसलिए जिस चेकआउट फ़्लो को मुद्रा डिफ़ॉल्ट और ऑर्डर कन्फ़र्मेशन के लिए समझदारी भरा स्थानीय समय डिस्प्ले, दोनों चाहिए, वह दोनों को दो अलग लुकअप के बजाय एक ही कॉल से पा सकता है।

पहले पेज व्यू पर ही मुद्रा डिफ़ॉल्ट सही होने से चेकआउट में बाद में कीमत के अचानक बदलने का झटका नहीं लगता। IPv4 लुकअप दस्तावेज़ में एंडपॉइंट द्वारा लौटाया गया हर फ़ील्ड दिया गया है।