भुगतान

भुगतान मॉड्यूल गेम के अंदर की वस्तुओं के खरीदारी भुगतान और पूर्ण खरीद भुगतान के संबंधित कार्य प्रदान करता है। JOGOS_SDK परिचय पृष्ठ में अपने गेम इंजन से संबंधित भाग को पढ़ने के बाद, निम्नलिखित तरीके से संबंधित कार्यों का उपयोग कर सकते हैं:

window.JOGOS_SDK.payment;

ऐप इंटरनल खरीदारी

चरण 1: सामान ID बनाएं

• डेवलपर डैशबोर्ड के Information / Purchase पृष्ठ पर सामान बनाएं।
• ध्यान दें कि एक ही गेम के तहत सामान ID दोहराई नहीं जा सकती।

चरण 2: ऑर्डर आरंभ करें

• जब खिलाड़ी को गेम के अंदर की वस्तु खरीदने की जरूरत होती है, तो सामान खरीदारी बटन पर इस इंटरफेस को कॉल करके Jogos भुगतान विंडो खोल सकते हैं。
• डेवलपर को सामान Id पास करने की जरूरत होती है, भुगतान विंडो सफलतापूर्वक खोलने के बाद ऑर्डर नंबर लौटाया जाता है, डेवलपर बाद में इस ऑर्डर नंबर का उपयोग करके इस ऑर्डर के संबंधित जानकारी की जांच कर सकते हैं।
• goodsId वही सामान ID है जिसे आपने डेवलपर डैशबोर्ड में बनाया है।

// सफलतापूर्वक ऑर्डर नंबर लौटाता है
let orderNo = await window.JOGOS_SDK.payment.buyGoods(goodsId: string);

चरण 3: उपयोगकर्ता का भुगतान करने का इंतजार करें

क्लाइंट द्वारा ऑर्डर भुगतान पूर्ण सूचना का सबस्क्राइब करना

खिलाड़ी द्वारा ऑर्डर आरंभ करने से लेकर वास्तविक भुगतान सफल होने तक काफी समय लग सकता है, डेवलपर इस इंटरफेस को कॉल करके खिलाड़ी के भुगतान सफलता संदेश का सबस्क्राइब कर सकते हैं। जब खिलाड़ी का भुगतान सफल होता है, तो प्लेटफॉर्म सबस्क्राइब किए गए कॉलबैक के माध्यम से डेवलपर को स्वचालित रूप से सूचित करेगा कि ऑर्डर भुगतान पूर्ण हो चुका है और ऑर्डर की नवीनतम जानकारी लौटाएगा।

window.JOGOS_SDK.payment.subscribeOrderPaid(callbackFn: (order: PaymentOrder) => void);

चरण 4: डिलीवरी करें, और प्लेटफॉर्म को सूचित करें कि ऑर्डर डिलीवरी हो चुका है

क्लाइंट द्वारा डिलीवरी का प्रबंधन (स्टैंडअलोन गेम)

डेवलपर को जब खिलाड़ी का भुगतान सफल होने की जानकारी मिलती है, तो स्वचालित रूप से रिवार्ड देने का प्रबंधन करें और इस इंटरफेस को कॉल करके प्लेटफॉर्म को सूचित करें कि डिलीवरी हो चुकी है।

सचेतना

• आपका गेम（यदि कोई गेम सर्वर नहीं है） के लिए सुझाव है कि क्लाइंट पर उपयोगकर्ता का भुगतान सुनकर, इस इंटरफेस को कॉल करके Jogos प्लेटफॉर्म को सूचित करें कि आपने इस उपयोगकर्ता को डिलीवरी कर दी है।
• इंटरफेस से लौटाए गए परिणाम के अनुसार, आप गेम में रिवार्ड देने का प्रबंधन करें या अन्य अपवादों के वर्णन का संकेत दें।
• सुझाव है कि डिलीवरी के बाद, क्लाउड स्टोरेज सिस्टम के आर्काइव सिंक्रोनाइजेशन इंटरफेस को कॉल करें, खिलाड़ी के डेटा को सहेजें।

await window.JOGOS_SDK.payment.deliverGoods(orderNo: string);

"गेम सर्वर" द्वारा एक्सेस करने का तरीका:

सर्वर एक्सेस से संबंधित API के लिए, कृपया देखें：सर्वर एक्सेस इंटरफेस पृष्ठ।

अन्य इंटरफेस

भुगतान को पूरा करने का सुझाव

• क्लाइंट उपयोगकर्ता के भुगतान सफलता की सूचना का सबस्क्राइब करता है(subscribeOrderPaid)， नेटवर्क आदि विभिन्न अनियंत्रित कारकों के कारण, क्लाइंट को 100% सूचना प्राप्त होने की गारंटी नहीं है। हमारा सुझाव है कि आप ऑर्डर प्राप्त करने वाले इंटरफेस के माध्यम से इस ऑर्डर की नवीनतम भुगतान स्थिति प्राप्त कर सकते हैं।
• कुछ स्टैंडअलोन गेम में आर्काइव को हटाने का कार्य प्रदान किया जा सकता है, तो उपयोगकर्ता ने पहले भुगतान करके प्राप्त किए गए रिवार्ड को फिर से देना है या नहीं, यह आपका निर्णय होगा। डेवलपर ऑर्डर सूची की जांच करने वाले इंटरफेस को कॉल करके खिलाड़ी के सभी ऑर्डर प्राप्त कर सकते हैं और रिवार्ड फिर से दे सकते हैं।
• ऑर्डर की जानकारी प्राप्त करने के बाद, status के माध्यम से निर्णय ले सकते हैं और इस ऑर्डर का प्रबंधन कर सकते हैं।

ऑर्डर की जानकारी

ऑर्डर नंबर के अनुसार ऑर्डर की विस्तृत जानकारी की जांच करें। ऑर्डर की संरचना निम्नलिखित है:

// भुगतान ऑर्डर
export interface PaymentOrder {
  // गेम Id
  gameId: number;
  // गेम का नाम
  gameName: string;
  // उपयोगकर्ता Id
  userId: number;
  // ऑर्डर नंबर
  orderNo: string;
  // सामान Id
  productId: string;
  // सामान का नाम
  productName: string;
  // मुद्रा
  currency: string;
  // देश
  country: string;
  // छूट
  discount: number;
  // Jogos कोइन (इन्टीग्रल) कटौती
  calorcoin: number;
  // भुगतान राशि
  paid: number;
  // भुगतान चैनल
  channel: string;
  // भुगतान प्रकार
  paymentType: string;
  // भुगतान क्रमांक
  paymentNo: string;
  // क्या डिलीवरी हो चुकी है
  deliverGoods: boolean;
  // ऑर्डर स्थिति  pending: भुगतान का इंतजार  fail: भुगतान विफल  cancel: रद्द किया गया  expire: समाप्त हो चुका  success: भुगतान सफल  refunding: रिफंड के प्रक्रिया में  refunded: रिफंड सफल  refund-fail: रिफंड विफल
  status: 'pending' | 'fail' | 'cancel' | 'expire' | 'success' | 'refunding' | 'refunded' | 'refund-fail';
  // ऑर्डर बनाने का समय
  createTime: String;
  //रिफंड क्रमांक
  refundNo: String;
  //रिफंड विवरण
  refundDescription: String;
  //रिफंडआवेदन का समय
  refundTime: String;
  //रिफंड सफल होने का समय
  refundedTime: String;
}

ऑर्डर की जानकारी प्राप्त करें

// सफलतापूर्वक ऑर्डर की जानकारी लौटाता है
let order = await window.JOGOS_SDK.payment.getOrderDetail(orderNo: string);

ऑर्डर सूची प्राप्त करें

डेवलपर इस इंटरफेस के माध्यम से ऑर्डर की स्थिति के अनुसार अपनी देखभाल वाली ऑर्डर की जानकारी की जांच कर सकते हैं, सफलता के बाद ऑर्डर सूची लौटाई जाती है, ऑर्डर की जानकारी ऑर्डर विस्तार की संरचना के समान है।

// सफलतापूर्वक ऑर्डर सूची लौटाता है
let orderList = await window.JOGOS_SDK.payment.getOrderList(
  status?: 'pending' | 'fail' | 'cancel' | 'expire' | 'success' | 'refunding' | 'refunded',
  pageNo?: number,  // पेज नंबर：डिफ़ॉल्ट 1 है
  pageSize?: number // प्रत्येक पेज में रिकॉर्ड की संख्या：डिफ़ॉल्ट 20 है
);

पूर्ण खरीद प्रणाली वाला गेम

1. डेवलपर डैशबोर्ड में अपने गेम को "Game Pricing"（पूर्ण खरीद प्रकार） के रूप में सेट करें, और अपने गेम की कीमत सेट करें।
2. अपने गेम के लिए दो सबमिट वर्जन बनाएं：ट्रायल वर्जन और ऑफिशियल वर्जन

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

3. ट्रायल वर्जन के गेम के अंदर खरीदारी बटन सेट करें：

• जब खिलाड़ी का ट्रायल समाप्त होता है, उदाहरण के लिए ट्रायल वर्जन में पहले अध्याय के आखिरी स्तर तक पहुंचने के बाद, ऑफिशियल वर्जन को खरीदने की जरूरत होती है, तो "ऑफिशियल वर्जन बेचने वाला" इंटरफेस और खरीदारी बटन डिज़ाइन करें：
• खरीदारी बटन buyOut इंटरफेस को कॉल करके Jogos प्लेटफॉर्म की भुगतान विंडो खोल सकता है, ताकि खिलाड़ी जल्द से जल्द गेम का ऑफिशियल वर्जन खरीद सकें；
• जब उपयोगकर्ता खरीदारी सफलतापूर्वक करता है, तो Jogos प्लेटफॉर्म स्वचालित रूप से ऑफिशियल वर्जन में स्विच कर देगा ताकि खिलाड़ी गेम खेलना जारी रख सकें, डेवलपर को अतिरिक्त प्रबंधन करने की जरूरत नहीं है।
• कृपया ट्रायल वर्जन और ऑफिशियल वर्जन के वर्जन नंबर को समान रखें, Jogos प्लेटफॉर्म उपयोगकर्ता के आर्काइव को ऑफिशियल वर्जन में स्वचालित रूप से स्थानांतरित कर देगा।
• भुगतान सफलता के बाद ऑर्डर नंबर लौटाया जाता है, डेवलपर इस ऑर्डर नंबर के अनुसार इस ऑर्डर के संबंधित जानकारी की जांच कर सकते हैं।

// सफलतापूर्वक ऑर्डर नंबर लौटाता है
let orderNo = await window.JOGOS_SDK.payment.buyOut();

*महत्वपूर्ण सचेतना*

कृपया ध्यान दें, चाहे वह ऑफिशियल वर्जन हो या ट्रायल वर्जन, गेम प्रोजेक्ट के पहले स्टार्ट सीन में इनिशियलाइजेशन अवश्य करना है, और कॉलबैक पूर्ण होने तक इंतजार करना है, उसके बाद ही अपने गेम का पहला कोड लाइन निष्पादित करें；Jogos इनिशियलाइजेशन के समय यह जांच करेगा कि उपयोगकर्ता ने आपका गेम खरीदा है या नहीं, नहीं तो उपयोगकर्ता गेम खेलना जारी नहीं रख सकेगा। यह आपके गेम को उपयोगकर्ताओं द्वारा पाइरेटेड खेले जाने से बचाने का प्रभावी तरीका है।