क्लाइंट का रेफ़रंस

com.google.android.gms.wallet documentation में, Google Pay API के कई वर्शन के लिए लाइब्रेरी का पूरा दस्तावेज़ मौजूद है. यहां Google Pay API के सबसे नए वर्शन के लिए, सबसे ज़्यादा इस्तेमाल किए जाने वाले ऑब्जेक्ट और तरीकों की खास जानकारी दी गई है: वर्शन 2.0

Wallet

टेस्ट या प्रोडक्शन एनवायरमेंट के लिए, PaymentsClient जनरेट करें.

उदाहरण

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

Google Pay API के साथ इंटरैक्ट करने वाला क्लाइंट.

isReadyToPay(IsReadyToPayRequest)

isReadyToPay(IsReadyToPayRequest) तरीके का इस्तेमाल करके यह पता लगाया जा सकता है कि कोई उपयोगकर्ता, Google Pay API से पेमेंट का तरीका वापस ला सकता है या नहीं.

अगर डिवाइस पर Google Pay काम करता है और उपयोगकर्ता ने पेमेंट का कोई तरीका पहले से सेव किया है या वह कोई तरीका जोड़ सकता है, तो IsReadyToPay दिखाता है true. यह पता लगाने के लिए कि उपयोगकर्ता ने Google Pay में पेमेंट का कोई तरीका पहले से सेव किया है या नहीं, IsReadyToPayRequest.existingPaymentMethodRequired को true पर सेट करें.

loadPaymentData(PaymentDataRequest)

Google Pay की पेमेंट शीट दिखाएं. इससे पेमेंट का तरीका चुना जा सकता है. साथ ही, ज़रूरत के हिसाब से पैरामीटर कॉन्फ़िगर किए जा सकते हैं.

IsReadyToPayRequest

IsReadyToPayRequest Java ऑब्जेक्ट बनाएं, जिसका इस्तेमाल PaymentsClient.isReadyToPay() के साथ किया जा सकता है.

fromJson(java.lang.String)

JSON फ़ॉर्मैट वाली स्ट्रिंग से IsReadyToPayRequest Java ऑब्जेक्ट बनाएं. JSON फ़ॉर्मैट वाली स्ट्रिंग के अनुमानित स्ट्रक्चर के लिए, IsReadyToPayRequest ऑब्जेक्ट रेफ़रंस देखें.

PaymentDataRequest

PaymentDataRequest Java ऑब्जेक्ट बनाएं, जिसका इस्तेमाल PaymentsClient.loadPaymentData के साथ किया जा सके.

fromJson(java.lang.String)

JSON फ़ॉर्मैट वाली स्ट्रिंग से PaymentDataRequest Java ऑब्जेक्ट बनाएं. JSON फ़ॉर्मैट वाली स्ट्रिंग के लिए, PaymentDataRequest ऑब्जेक्ट रेफ़रंस देखें.

PaymentData

अपने ऐप्लिकेशन में इस्तेमाल करने के लिए, Google Pay API के JSON फ़ॉर्मैट वाले जवाब को मैनेज करें.

toJson()

Google Pay API के जवाब को JSON फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाओ. JSON ऑब्जेक्ट के स्ट्रक्चर के बारे में ज़्यादा जानने के लिए, PaymentData ऑब्जेक्ट रेफ़रंस देखें.

PayButton

public void initialize(ButtonOption buttonOptions)

सुविधाजनक तरीके का इस्तेमाल, Google Pay के पेमेंट बटन को शुरू करने के लिए किया जाता है. इस बटन को Google Pay की नई ब्रैंडिंग के हिसाब से स्टाइल किया जाता है.

तर्क

नाम	ब्यौरा
buttonOptions	यह एक ऐसा ऑब्जेक्ट है जो Google Pay पेमेंट बटन को कॉन्फ़िगर करता है. कॉन्फ़िगर की जा सकने वाली प्रॉपर्टी के लिए, ButtonOptions देखें.

उदाहरण: कस्टम कॉन्फ़िगरेशन के साथ पेमेंट बटन को शुरू करें:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

सुविधा शुल्क के हिसाब से, पेमेंट बटन दिखने की सुविधा सेट की जाती है.

तर्क

नाम	ब्यौरा
View	View.VISIBLE पेमेंट बटन को दिखने के लिए सेट करता है (डिफ़ॉल्ट). View.GONE से, उपयोगकर्ताओं को बटन नहीं दिखता.

उदाहरण:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

इस तरीके को तब कॉल किया जाता है, जब उपयोगकर्ता Google Pay के पेमेंट बटन पर क्लिक करता है.

तर्क

नाम	ब्यौरा
listener	यह इवेंट लिसनर कॉलबैक, Google Pay पेमेंट बटन पर क्लिक इवेंट डिलीवर होने पर कॉल करता है.

BasePaymentDataCallbacksService

यह एक बुनियादी सेवा क्लास है. इसमें Google Play services से शुरू किए गए पेमेंट डेटा के कॉलबैक होस्ट किए जाते हैं. ये कॉलबैक, PaymentsClient.loadPaymentData(PaymentDataRequest) फ़्लो के दौरान किए जाते हैं.

इस सेवा को अपने ऐप्लिकेशन में बढ़ाएं और इसे AndroidManifest.xml में com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE अनुमति के साथ घोषित करें. साथ ही, com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS के लिए इंटेंट फ़िल्टर जोड़ें.

createPaymentDataCallbacks()

यह फ़ंक्शन, BasePaymentDataCallbacks को लागू करने का तरीका दिखाता है. इसका इस्तेमाल, इनकमिंग कॉलबैक इवेंट को मैनेज करने के लिए किया जाता है. इसे हर कॉलबैक इवेंट के लिए एक बार कॉल किया जाता है.

ध्यान दें: createPaymentDataCallbacks() कॉल पर, BasePaymentDataCallbacks के नए इंस्टेंस को बनाया जाना चाहिए. स्थायी स्थिति को सीधे तौर पर सेवा क्लास में सेव न करें, क्योंकि Android OS, सेवा प्रोसेस को कॉल के बीच में बंद कर सकता है. इसके बजाय, getLastSavedState() और withUpdatedSavedState() का इस्तेमाल करें.

BasePaymentDataCallbacks

यह एक ऐब्स्ट्रैक्ट बेस क्लास है. इसमें पेमेंट के डेटा के लिए कॉलबैक हैंडलर होते हैं. इन्हें कारोबारी या कंपनी लागू करती है, ताकि डाइनैमिक तरीके से कीमत अपडेट करने और पेमेंट की अनुमति देने की सुविधा काम कर सके.

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

यह तरीका, पेमेंट शीट में पेमेंट के डेटा में हुए बदलावों को मैनेज करता है. जैसे, शिपिंग पता और शिपिंग के विकल्प.

ध्यान दें: onPaymentDataChanged कॉलबैक का इस्तेमाल करने के लिए, onPaymentAuthorized कॉलबैक को भी सेट करना ज़रूरी है. आपको 30 सेकंड के अंदर, onCompleteListener.complete(...) . अगर कॉलबैक पूरा नहीं होता है . इस समयसीमा के अंदर, अनुरोध का समय खत्म हो जाता है. साथ ही, Google Pay शीट पर उपयोगकर्ता को CALLBACK_TIMED_OUT गड़बड़ी का मैसेज दिखता है.

तर्क

नाम	टाइप	ब्यौरा
intermediatePaymentData	IntermediatePaymentData	यह एक ऐसा ऑब्जेक्ट है जिसमें पेमेंट शीट में चुना गया पता और शिपिंग का विकल्प शामिल होता है. ज़्यादा जानकारी के लिए, IntermediatePaymentData देखें.
onCompleteListener	OnCompleteListener<PaymentDataRequestUpdate>	अपडेट किए गए लेन-देन की जानकारी, शिपिंग के विकल्पों, और पेमेंट के डेटा से जुड़ी गड़बड़ियों को ठीक करने के लिए लिसनर. complete() को PaymentDataRequestUpdate इंस्टेंस पास करें.

उदाहरण

override fun onPaymentDataChanged(
    intermediatePaymentData: IntermediatePaymentData,
    onCompleteListener: OnCompleteListener<PaymentDataRequestUpdate>
) {
    val paymentDataRequestUpdateJson = handlePaymentDataChanged(intermediatePaymentData.toJson())
    val update = PaymentDataRequestUpdate.fromJson(paymentDataRequestUpdateJson.toString())
    onCompleteListener.complete(update)
}

onPaymentAuthorized(paymentData, onCompleteListener)

इस तरीके का इस्तेमाल तब किया जाता है, जब पेमेंट शीट में पेमेंट को अनुमति दी जाती है.

ध्यान दें: आपको onCompleteListener.complete(...) से मिले प्रॉमिस को 30 सेकंड के अंदर पूरा करना होगा. अगर कॉलबैक पूरा नहीं होता है . इस समयसीमा के अंदर, अनुरोध का समय खत्म हो जाता है. साथ ही, Google Pay शीट पर उपयोगकर्ता को CALLBACK_TIMED_OUT गड़बड़ी का मैसेज दिखता है.

तर्क

नाम	टाइप	ब्यौरा
paymentData	PaymentData	यह एक ऐसा ऑब्जेक्ट होता है जिसमें खरीदार का अनुरोध किया गया डेटा शामिल होता है. ज़्यादा जानकारी के लिए, PaymentData देखें.
onCompleteListener	OnCompleteListener<PaymentAuthorizationResult>	यह एक लिसनर है, जो अनुमति के नतीजे के साथ हल करता है. complete() को PaymentAuthorizationResult इंस्टेंस पास करें.

उदाहरण

override fun onPaymentAuthorized(
    paymentData: PaymentData,
    onCompleteListener: OnCompleteListener<PaymentAuthorizationResult>
) {
    val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson())
    val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString())
    onCompleteListener.complete(result)
}

IntermediatePaymentData

BasePaymentDataCallbacks.onPaymentDataChanged को पास किए गए इंटरमीडिएट कॉलबैक डेटा को हैंडल करता है.

toJson()

यह फ़ंक्शन, कॉलबैक अनुरोध के डेटा को JSON फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाता है. JSON ऑब्जेक्ट के स्ट्रक्चर के बारे में ज़्यादा जानने के लिए, IntermediatePaymentData ऑब्जेक्ट रेफ़रंस देखें.

getLastSavedState()

यह Bundle दिखाता है. इसमें पिछली कॉलबैक प्रोसेस के दौरान सेव की गई स्थिति होती है.

PaymentDataRequestUpdate

BasePaymentDataCallbacks.onPaymentDataChanged में वापस लाने के लिए, PaymentDataRequestUpdate Java ऑब्जेक्ट बनाएं.

fromJson(java.lang.String)

JSON फ़ॉर्मैट वाली स्ट्रिंग से PaymentDataRequestUpdate Java ऑब्जेक्ट बनाएं. JSON फ़ॉर्मैट वाली स्ट्रिंग के अनुमानित स्ट्रक्चर के लिए, PaymentDataRequestUpdate ऑब्जेक्ट रेफ़रंस देखें.

withUpdatedSavedState(Bundle)

यह अपडेट की गई स्थिति Bundle को अटैच करता है, ताकि कॉलबैक के बीच इसे बनाए रखा जा सके.

PaymentAuthorizationResult

BasePaymentDataCallbacks.onPaymentAuthorized में वापस लाने के लिए, PaymentAuthorizationResult Java ऑब्जेक्ट बनाएं.

fromJson(java.lang.String)

JSON फ़ॉर्मैट वाली स्ट्रिंग से PaymentAuthorizationResult Java ऑब्जेक्ट बनाएं. JSON फ़ॉर्मैट वाली स्ट्रिंग के अनुमानित स्ट्रक्चर के लिए, PaymentAuthorizationResult रिस्पॉन्स ऑब्जेक्ट रेफ़रंस देखें.