Chrome 62
PaymentDetailsModifier अब उपलब्ध है
पेमेंट के अनुरोध में, कुछ मामलों में आपको छूट या अतिरिक्त शुल्क देना पड़ सकता है. यह इस बात पर निर्भर करता है कि ग्राहक ने पेमेंट का कौनसा तरीका चुना है.
PaymentDetailsModifier का इस्तेमाल करके, ऐसा किया जा सकता है.
PaymentRequest कंस्ट्रक्टर के दूसरे आर्ग्युमेंट में modifiers प्रॉपर्टी जोड़ें. साथ ही, PaymentDetailsModifier ऑब्जेक्ट की एक कलेक्शन जोड़ें. यह ऑब्जेक्ट, डिक्लेरेटिव नियमों का कलेक्शन होता है. इसमें बताया जाता है कि ग्राहक के चुने गए पेमेंट के तरीके के आधार पर, डिसप्ले आइटम और कुल रकम में कैसे बदलाव किया जाना चाहिए.
नीचे दिए गए उदाहरण में बताया गया है कि क्रेडिट कार्ड से पेमेंट करने पर, उपयोगकर्ता से तीन डॉलर की प्रोसेसिंग फ़ीस लेने का एलान कैसे किया जाता है.
let methods = [{
supportedMethods: 'basic-card',
data: {
supportedNetworks: ['visa', 'mastercard']
supportedTypes: ['credit', 'debit']
}
}];
let details = {
displayItems: [{
label: 'T-shirt',
amount: { currency: 'USD', value: '68.00' }
}],
total: {
label: 'Total price',
amount: { currency: 'USD', value: '68.00' }
},
modifiers: [{
supportedMethods: 'basic-card',
data: {
supportedTypes: ['credit']
},
additionalDisplayItems: [{
label: 'Processing fee',
amount: { currency: 'USD', value: '3.00' }
}],
total: {
label: 'Credit card price',
amount: {currency: ‘USD’, value: ‘71.00’}}
}]
};
let options = {};
let request = new PaymentRequest(methods, details, options);
पेमेंट के अनुरोध की असल शीट पर, क्रेडिट कार्ड से पेमेंट करने का विकल्प चुनते ही, उपयोगकर्ता को "प्रोसेसिंग फ़ीस" नाम का एक और आइटम दिखेगा.इसमें 3 डॉलर का शुल्क और कुल कीमत 71 डॉलर दिखेगी.
PaymentDetailsModifier में ये पैरामीटर शामिल होते हैं:
| प्रॉपर्टी का नाम | |
|---|---|
supportedMethods | यह बताएं कि पेमेंट का कौनसा तरीका इस नियम को लागू करता है. |
additionalDisplayItems |
डिस्प्ले किए जाने वाले ऐसे अन्य आइटम जिनमें आपको छूट या अतिरिक्त शुल्क जोड़ना है. |
total | additionalDisplayItems को जोड़ने के बाद कुल कीमत. |
data | basic-card पेमेंट के लिए, इसका इस्तेमाल supportedTypes के साथ खास तरह के कार्ड फ़िल्टर करने के लिए किया जाएगा. इस पैरामीटर का इस्तेमाल, पेमेंट के तरीके (पेमेंट ऐप्लिकेशन) पर निर्भर करता है. पेमेंट के हर तरीके के लिए उपलब्ध दस्तावेज़ देखें. |
शिपिंग के विकल्प होने पर, चीज़ें थोड़ी मुश्किल हो जाती हैं, क्योंकि modifiers'
कुल कीमत स्टैटिक नहीं हो सकती और इसमें डाइनैमिक बदलाव की ज़रूरत होती है.
ऐसा करने के लिए, आपको modifiers प्रॉपर्टी के additionalDisplayItems और total में बदलाव करना होगा. ऐसा shippingaddresschange और shippingoptionchange इवेंट पर करना होगा. ठीक वैसे ही जैसे PaymentDetails ऑब्जेक्ट की displayItems प्रॉपर्टी के लिए किया जाता है.
supportedMethods प्रॉपर्टी अब स्ट्रिंग लेती है
PaymentMethodData ऑब्जेक्ट (PaymentRequest कंस्ट्रक्टर का पहला आर्ग्युमेंट) में supportedMethods प्रॉपर्टी, स्ट्रिंग का एक कलेक्शन लेती है. इससे पेमेंट के तरीके का पता चलता है. अब यह आर्ग्युमेंट के तौर पर एक स्ट्रिंग लेता है.
ध्यान दें कि अरे देने की सुविधा फ़िलहाल काम करती रहेगी.
पुराना - फ़िलहाल, यह काम करता है.
var methodData = [{ supportedMethods: ['basic-card'], data: { supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb', 'diners', 'discover', 'mir', 'unionpay'] } }, { supportedMethods: ['https://bobpay.xyz'] }];
नया - नया तरीका.
var methodData = [{ supportedMethods: 'basic-card', data: { supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb', 'diners', 'discover', 'mir', 'unionpay'] } }, { supportedMethods: 'https://bobpay.xyz' }];
Chrome 61
बेसिक कार्ड में supportedTypes उपलब्ध है
जब supportedMethods की वैल्यू 'basic-card' हो, तो अब supportedTypes की वैल्यू दी जा सकती है. इससे यह पता चलता है कि 'credit', 'debit', और 'prepaid' में से किस तरह के कार्ड इस्तेमाल किए जा सकते हैं.
var methodData = [{
supportedMethods: 'basic-card',
data: {
supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
'diners', 'discover', 'mir', 'unionpay']
supportedTypes: ['credit', 'debit', 'prepaid']
}
}];
अपने पेमेंट गेटवे से कार्ड के टाइप की दोबारा जांच ज़रूर करें. ऐसा इसलिए, क्योंकि यह फ़िल्टरिंग, कार्ड के सोर्स के आधार पर शायद ठीक से काम न करे.
Chrome 57
PaymentRequest अब iframe में उपलब्ध है
अब iframe एलिमेंट में allowpaymentrequest एट्रिब्यूट जोड़कर, iframe से Payment Request API को कॉल किया जा सकता है.
<iframe src="/totally/fake/url" allowpaymentrequest></iframe>
PaymentMethodData, "basic-card" के साथ काम करता है
PaymentRequest() कंस्ट्रक्टर का पहला आर्ग्युमेंट, पेमेंट के तरीके के डेटा का कलेक्शन होता है. इस रिलीज़ में, PaymentMethodData फ़ॉर्मैट में बदलाव किया गया है.
पुराना - फ़िलहाल, यह काम करता है.
var methodData = [{ supportedMethods: ['visa', 'mastercard', 'amex', 'jcb'] }]; var request = new PaymentRequest(methodData, details, options);
नया - नया स्ट्रक्चर.
var methodData = [{ supportedMethods: ['basic-card'], data: { supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb', 'diners', 'discover', 'mir', 'unionpay'] } }]; var request = new PaymentRequest(methodData, details, options);
data प्रॉपर्टी का फ़ॉर्मैट, supportedMethods में मौजूद वैल्यू पर निर्भर करता है. साथ ही, यह बेसिक कार्ड की खास जानकारी पर आधारित होता है. ध्यान दें कि स्पेसिफ़िकेशन में supportedTypes शामिल है, जो credit, debit या prepaid को स्वीकार करता है. हालांकि, Chrome 57 इस प्रॉपर्टी को अनदेखा करता है और supoprtedNetworks में मौजूद किसी भी वैल्यू को क्रेडिट कार्ड के तौर पर मानता है.
var methodData = [{
supportedMethods: ['basic-card'],
data: {
supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
'diners', 'discover', 'mir', 'unionpay'],
supportedTypes: ['credit'] <= not available
}
}];
Chrome 56
मंज़ूरी बाकी है
पेमेंट आइटम की जानकारी के तौर पर, डेवलपर pending जोड़ सकते हैं. इससे यह पता चलता है कि कीमत अभी पूरी तरह से तय नहीं की गई है. pending फ़ील्ड में बूलियन वैल्यू डाली जा सकती है.
{
label: "State tax",
amount: { currency: "USD", value : "5.00" },
pending: true
},
इसका इस्तेमाल आम तौर पर, शिपिंग या टैक्स की रकम जैसे लाइन आइटम दिखाने के लिए किया जाता है. ये आइटम, शिपिंग के पते या शिपिंग के विकल्पों के आधार पर तय होते हैं. Chrome, पेमेंट के अनुरोध के लिए यूज़र इंटरफ़ेस (यूआई) में बाकी फ़ील्ड दिखाता है.
requestPayerName
शिपिंग के विकल्प (PaymentRequest के लिए तीसरा आर्ग्युमेंट) के तौर पर, डेवलपर अब requestPayerName जोड़ सकते हैं. इससे, पेमेंट करने वाले व्यक्ति के नाम का अनुरोध, शिपिंग पते की जानकारी से अलग किया जा सकता है.
requestPayerName में बूलियन वैल्यू डाली जा सकती है.
shippingType
शिपिंग के विकल्प (PaymentRequest के लिए तीसरा आर्ग्युमेंट) के तौर पर, डेवलपर अब shippingType जोड़ सकते हैं. इससे, यूज़र इंटरफ़ेस (यूआई) में "शिपिंग" के बजाय "डिलीवरी" या "पिकअप" दिखाने का अनुरोध किया जा सकता है.
shippingType, shipping (डिफ़ॉल्ट), delivery या pickup स्ट्रिंग स्वीकार करता है.
PaymentResponse और PaymentAddress के लिए उपलब्ध सीरियलाइज़र फ़ंक्शन
PaymentResponse ऑब्जेक्ट और PaymentAddress ऑब्जेक्ट को अब JSON-सीरियलाइज़ किया जा सकता है. डेवलपर, toJSON() फ़ंक्शन को कॉल करके, किसी स्ट्रिंग को JSON ऑब्जेक्ट में बदल सकते हैं. साथ ही, मुश्किल toDict() फ़ंक्शन बनाने से बच सकते हैं.
request.show().then(response => {
let res = response.toJSON();
});
canMakePayment
एपीआई की उपलब्धता के अलावा, Payment Request API को शुरू करने से पहले यह देखा जा सकता है कि उपयोगकर्ता के पास पेमेंट का कोई चालू तरीका है या नहीं. याद रखें कि यह ज़रूरी नहीं है, क्योंकि उपयोगकर्ता अब भी पेमेंट यूज़र इंटरफ़ेस (यूआई) पर पेमेंट का नया तरीका जोड़ सकते हैं.
let request = new PaymentRequest(methods, details, options);
if (request.canMakePayment) {
request.canMakePayment().then(result => {
if (result) {
// Payment methods are available.
} else {
// Payment methods are not available, but users can still add
// a new payment method in Payment UI.
}
}).catch(error => {
// Unable to determine.
});
}