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

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

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

fromJson(java.lang.String)

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

PaymentDataRequest

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

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

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

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

createPaymentDataCallbacks()

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

BasePaymentDataCallbacks

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

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

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

तर्क

नमस्ते
नाम टाइप ब्यौरा
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)

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

तर्क

नाम टाइप ब्यौरा
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 रिस्पॉन्स ऑब्जेक्ट रेफ़रंस देखें.