मुख्य सामग्री पर जाएँ
SimVoro
आपका खाता लोड हो रहा है…
SimVoro

API इंटीग्रेशन

उपलब्ध

API इंटीग्रेशन

क्या आप अपने ऐप या बुकिंग प्रोसेस में eSIM बेचने की योजना बना रहे हैं? हमें बताएँ कि आपको क्या चाहिए।

API ऐक्सेस का अनुरोध करें

बिक्री टीम द्वारा एक्सेस सक्रिय किए जाने के बाद स्वीकृत पार्टनर API इस्तेमाल कर सकते हैं। पार्टनर डैशबोर्ड में केवल पढ़ने वाली या ऑर्डर की अनुमति वाली कुंजी बनाएं। सभी खरीदारी आपके प्रीपेड USD वॉलेट से होती हैं।

API शुरू करने की मार्गदर्शिका

खाता स्वीकृत होने के बाद बिक्री टीम मूल्य तय करती है और API एक्सेस सक्रिय करती है। पार्टनर डैशबोर्ड में कुंजी बनाएं। केवल पढ़ने वाली कुंजियां ऑर्डर नहीं कर सकतीं। आपके खाते पर खरीदारी भी सक्रिय होनी चाहिए।

https://simvoro.com/api/partner/v1

हर अनुरोध में सर्वर की ओर से bearer कुंजी भेजें। कुंजी ब्राउज़र कोड या URL में न डालें। पार्टनर डैशबोर्ड से कुंजियां रद्द की जा सकती हैं।

Authorization: Bearer YOUR_API_KEY
विधिएंडपॉइंटपरिणाम
GET/products?destination=japanआपके निर्धारित USD मूल्य और उत्पाद ID। गंतव्य slug से फ़िल्टर करें और पृष्ठों के लिए cursor इस्तेमाल करें।
GET/balanceवॉलेट बैलेंस, आरक्षित राशि और उपलब्ध USD।
GET/transactionsवॉलेट लेनदेन और nextCursor।
GET/ordersपार्टनर ऑर्डर सारांश और nextCursor (हर पृष्ठ पर 50)।
POST/ordersराशि आरक्षित करें और एक eSIM ऑर्डर करें। ऑर्डर की अनुमति वाली कुंजी आवश्यक है।
GET/orders/{orderId}ऑर्डर स्थिति, आखिरी बार सिंक हुआ डेटा उपयोग और डिलीवरी के बाद इंस्टॉलेशन जानकारी।

ऑर्डर बनाएं

Idempotency-Key में UUID भेजें। समय सीमा समाप्त होने या कनेक्शन विफल होने पर वही UUID दोबारा इस्तेमाल करें। ग्राहक द्वारा पुष्टि किया गया मूल्य भेजें और पुष्टि करें कि प्राप्तकर्ता का डिवाइस eSIM समर्थित तथा कैरियर-अनलॉक है। लाइव मूल्य बदलने पर 409 PRICE_CHANGED मिलता है। यह लाइव API है; स्वीकृत खरीदारी में वॉलेट की वास्तविक राशि इस्तेमाल होती है।

POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559

{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}

201 प्रतिक्रिया में orderId और esim होते हैं; esim.status और esim.failure जांचें। हर 10 सेकंड पर ऑर्डर की स्थिति देखें। राशि पहले आरक्षित होती है और डिलीवरी सत्यापित होने पर काटी जाती है। दोबारा अनुरोध करने पर विफल ऑर्डर भी वापस मिल सकता है। आपूर्तिकर्ता का परिणाम अनिश्चित होने पर मूल ऑर्डर का मिलान होने तक राशि आरक्षित रहती है। इंस्टॉलेशन जानकारी निजी है और केवल सत्यापित डिलीवरी के बाद दिखाई देती है।

राशियां USD की दशमलव स्ट्रिंग होती हैं। सूचियां items और nextCursor लौटाती हैं; nextCursor के null होने तक जारी रखें। सीमाएं: हर कुंजी पर प्रति मिनट 120 अनुरोध और हर उपयोगकर्ता पर प्रति मिनट 10 खरीदारी प्रयास। 429 पर Retry-After का पालन करें। आम त्रुटियां: 401 अमान्य कुंजी, 403 अनुमति नहीं, 402 अपर्याप्त राशि, 404 ऑर्डर उपलब्ध नहीं, 409 मूल्य या idempotency टकराव, 503 सेवा उपलब्ध नहीं। दूसरी खरीदारी से पहले मूल ऑर्डर देखें।

अपने अनुरोध में क्या बताएँ

  • आपका प्लैटफ़ॉर्म और आपके ग्राहक कौन हैं
  • आपका अनुमानित मासिक वॉल्यूम
  • वे गंतव्य, जो आप ऑफ़र करना चाहते हैं
  • आपके सिस्टम को क्या-क्या करना होगा, जैसे eSIM ऑर्डर करना और उसका QR कोड आपके ग्राहक को दिखाना

पार्टनर बनें

आवेदन भेजें। हमारी टीम उसके बारे में आपसे संपर्क करेगी।

पार्टनर खाते के लिए आवेदन करें

ज़्यादा

भाषा

खाता

आपका खाता लोड हो रहा है…