पेमेंट लेन-देन की अवधि

जानें कि कारोबारी या कंपनियां, पेमेंट ऐप्लिकेशन को कैसे इंटिग्रेट करती हैं और Payment Request API की मदद से पेमेंट कैसे किया जाता है.

Web Payments API, पेमेंट की ऐसी सुविधाएं हैं जिन्हें पहली बार ब्राउज़र में पहले से मौजूद सुविधाओं के तौर पर शामिल किया गया है. वेब पेमेंट की मदद से, कारोबारी या कंपनी के लिए पेमेंट ऐप्लिकेशन के साथ इंटिग्रेट करना आसान हो जाता है. साथ ही, ग्राहक को बेहतर और ज़्यादा सुरक्षित अनुभव मिलता है.

वेब पेमेंट का इस्तेमाल करने के फ़ायदों के बारे में ज़्यादा जानने के लिए, वेब पेमेंट की मदद से पेमेंट ऐप्लिकेशन को बेहतर बनाना लेख पढ़ें.

इस लेख में, कारोबारी या कंपनी की वेबसाइट पर पेमेंट करने का तरीका बताया गया है. साथ ही, पेमेंट ऐप्लिकेशन के इंटिग्रेशन के काम करने का तरीका बताया गया है.

इस प्रोसेस में छह चरण शामिल हैं:

  1. कारोबारी या कंपनी, पेमेंट का लेन-देन शुरू करती है.
  2. कारोबारी या कंपनी, पेमेंट बटन दिखाती है.
  3. ग्राहक, पेमेंट बटन दबाता है.

    चीज़ की दुकान की वेबसाइट का डायग्राम, जिसमें BobPay (पेमेंट ऐप्लिकेशन) बटन है.

  4. ब्राउज़र, पेमेंट ऐप्लिकेशन को लॉन्च करता है.

    चीज़ शॉप की वेबसाइट का डायग्राम, जिसमें BobPay ऐप्लिकेशन को एक मॉडल में लॉन्च किया गया है. मोडल में, शिपिंग के विकल्प और कुल कीमत दिखाई गई है.

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

    एक डायग्राम, जिसमें ग्राहक को BobPay ऐप्लिकेशन के मॉडल में शिपिंग का कोई दूसरा विकल्प चुनते हुए दिखाया गया है. दूसरा डायग्राम, जिसमें व्यापारी/कंपनी BobPay में दिखाई गई कुल लागत को अपडेट कर रही है.

  6. खरीदार की ओर से खरीदारी की पुष्टि करने के बाद, कारोबारी या कंपनी पेमेंट की पुष्टि करती है और लेन-देन पूरा करती है.

    इस डायग्राम में, ग्राहक को

पहला चरण: कारोबारी या कंपनी, पेमेंट के लेन-देन की प्रोसेस शुरू करती है

जब कोई ग्राहक खरीदारी करने का फ़ैसला लेता है, तो कारोबारी या कंपनी PaymentRequest ऑब्जेक्ट बनाकर पेमेंट की प्रोसेस शुरू करती है. इस ऑब्जेक्ट में, लेन-देन के बारे में अहम जानकारी शामिल होती है:

  • पेमेंट के स्वीकार किए जाने वाले तरीके और लेन-देन को प्रोसेस करने के लिए उनका डेटा.
  • जानकारी, जैसे कि कुल कीमत (ज़रूरी है) और आइटम के बारे में जानकारी.
  • ऐसे विकल्प जिनमें कारोबारी या कंपनियां, शिपिंग की जानकारी का अनुरोध कर सकती हैं. जैसे, शिपिंग का पता और शिपिंग का विकल्प.
  • कारोबारी, बिलिंग पता, पेमेंट करने वाले व्यक्ति का नाम, ईमेल, और फ़ोन नंबर भी मांग सकते हैं.
  • कारोबारी या कंपनियां, PaymentRequest में शिपिंग टाइप (shipping, delivery या pickup) भी शामिल कर सकती हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. पेमेंट ऐप्लिकेशन, इसका इस्तेमाल करके अपने यूज़र इंटरफ़ेस (यूआई) में सही लेबल दिखा सकता है.
const request = new PaymentRequest([{
  supportedMethods: 'https://bobpay.xyz/pay',
  data: {
    transactionId: '****'
  }
}], {
  displayItems: [{
    label: 'Anvil L/S Crew Neck - Grey M x1',
    amount: { currency: 'USD', value: '22.15' }
  }],
  total: {
    label: 'Total due',
    amount: { currency: 'USD', value : '22.15' }
  }
}, {
  requestShipping: true,
  requestBillingAddress: true,
  requestPayerEmail: true,
  requestPayerPhone: true,
  requestPayerName: true,
  shippingType: 'delivery'
});
लेन-देन आईडी शामिल करना

कुछ पेमेंट हैंडलर, कारोबारी या कंपनी से लेन-देन आईडी देने के लिए कह सकते हैं. यह आईडी, लेन-देन की जानकारी के तौर पर पहले ही जारी किया जा चुका होता है. आम तौर पर, इंटिग्रेशन में कारोबारी या कंपनी और पेमेंट हैंडलर के सर्वर के बीच कम्यूनिकेशन शामिल होता है, ताकि कुल कीमत को रिज़र्व किया जा सके. इससे, नुकसान पहुंचाने वाले ग्राहकों को कीमत में हेर-फेर करने और व्यापारी/कंपनी/कारोबारी को धोखा देने से रोका जा सकता है. इसके लिए, लेन-देन के आखिर में पुष्टि की जाती है.

व्यापारी/कंपनी, PaymentMethodData ऑब्जेक्ट की data प्रॉपर्टी के हिस्से के तौर पर, लेन-देन आईडी पास कर सकती है.

लेन-देन की जानकारी मिलने के बाद, ब्राउज़र PaymentRequest में बताए गए पेमेंट ऐप्लिकेशन को खोजने की प्रोसेस शुरू करता है. यह प्रोसेस, पेमेंट के तरीके के आइडेंटिफ़ायर के आधार पर की जाती है. इससे ब्राउज़र को यह तय करने में मदद मिलती है कि कारोबारी या कंपनी के लेन-देन के लिए तैयार होते ही, कौनसा पेमेंट ऐप्लिकेशन लॉन्च करना है.

पेमेंट के तरीके की खोज की प्रोसेस के बारे में ज़्यादा जानने के लिए, पेमेंट का तरीका सेट अप करना लेख पढ़ें.

दूसरा चरण: कारोबारी या कंपनी, पेमेंट बटन दिखाती है

कारोबारी या कंपनियां, पेमेंट के कई तरीके उपलब्ध करा सकती हैं. हालांकि, उन्हें पेमेंट के लिए सिर्फ़ उन तरीकों के बटन दिखाने चाहिए जिनका इस्तेमाल ग्राहक वाकई कर सकता है. पेमेंट बटन दिखाना, लेकिन उसका इस्तेमाल न कर पाना, उपयोगकर्ता को खराब अनुभव देता है. अगर किसी कारोबारी या कंपनी को लगता है कि PaymentRequest ऑब्जेक्ट में बताया गया पेमेंट का तरीका खरीदार के लिए काम नहीं करेगा, तो वह कोई दूसरा विकल्प उपलब्ध करा सकती है या उस बटन को पूरी तरह से छिपा सकती है.

PaymentRequest इंस्टेंस का इस्तेमाल करके, कारोबारी या कंपनी यह पता लगा सकती है कि ग्राहक के पास पेमेंट ऐप्लिकेशन उपलब्ध है या नहीं.

क्या ग्राहक के पास पेमेंट ऐप्लिकेशन उपलब्ध है?

PaymentRequest का canMakePayment() तरीका, true दिखाता है. ऐसा तब होता है, जब ग्राहक के डिवाइस पर पेमेंट ऐप्लिकेशन उपलब्ध हो. "उपलब्ध" का मतलब है कि पेमेंट के तरीके के साथ काम करने वाला पेमेंट ऐप्लिकेशन मिल गया है और प्लैटफ़ॉर्म के हिसाब से पेमेंट ऐप्लिकेशन इंस्टॉल किया गया है या वेब पर आधारित पेमेंट ऐप्लिकेशन रजिस्टर होने के लिए तैयार है.

const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
  // Fallback to other means of payment or hide the button.
}

तीसरा चरण: ग्राहक, पेमेंट बटन दबाता है

जब ग्राहक पेमेंट बटन दबाता है, तो कारोबारी या कंपनी PaymentRequest इंस्टेंस के show() तरीके को कॉल करती है. इससे पेमेंट यूज़र इंटरफ़ेस (यूआई) तुरंत लॉन्च हो जाता है.

अगर कुल कीमत डाइनैमिक तौर पर सेट की जाती है (उदाहरण के लिए, सर्वर से ली जाती है), तो कारोबारी या कंपनी, पेमेंट यूज़र इंटरफ़ेस (यूआई) को तब तक लॉन्च नहीं कर सकती, जब तक कुल कीमत की जानकारी न मिल जाए.

पेमेंट यूज़र इंटरफ़ेस (यूआई) को लॉन्च करने में देरी करना

कुल कीमत तय होने तक, पेमेंट यूज़र इंटरफ़ेस (यूआई) को टालने का डेमो देखें.

पेमेंट यूज़र इंटरफ़ेस (यूआई) को बाद में दिखाने के लिए, कारोबारी या कंपनी show() तरीके को प्रॉमिस पास करती है. ब्राउज़र तब तक लोड होने का इंडिकेटर दिखाएगा, जब तक प्रॉमिस रिज़ॉल्व नहीं हो जाता और लेन-देन शुरू होने के लिए तैयार नहीं हो जाता.

const getTotalAmount = async () => {
  // Fetch the total amount from the server, etc.
};

try {
  const result = await request.show(getTotalAmount());
  // Process the result…
} catch(e) {
  handleError(e);
}

अगर show() के लिए आर्ग्युमेंट के तौर पर कोई प्रॉमिस नहीं दिया गया है, तो ब्राउज़र तुरंत पेमेंट यूज़र इंटरफ़ेस (यूआई) लॉन्च कर देगा.

चौथा चरण: ब्राउज़र, पेमेंट ऐप्लिकेशन को लॉन्च करता है

ब्राउज़र, किसी खास प्लैटफ़ॉर्म या वेब पर आधारित पेमेंट ऐप्लिकेशन को लॉन्च कर सकता है. इस बारे में ज़्यादा जानने के लिए, Chrome यह कैसे तय करता है कि कौनसा पेमेंट ऐप्लिकेशन लॉन्च करना है लेख पढ़ें.

पेमेंट ऐप्लिकेशन को कैसे बनाया जाता है, यह ज़्यादातर डेवलपर पर निर्भर करता है. हालांकि, कारोबारी या कंपनी से और उसे भेजे जाने वाले इवेंट के साथ-साथ, उन इवेंट के साथ पास किए गए डेटा का स्ट्रक्चर स्टैंडर्ड होता है.

पेमेंट ऐप्लिकेशन लॉन्च होने पर, उसे पहले चरण में PaymentRequest ऑब्जेक्ट को पास की गई लेन-देन की जानकारी मिलती है. इसमें यह जानकारी शामिल होती है:

  • पेमेंट के तरीके का डेटा
  • कुल किराया
  • पेमेंट के विकल्प

पेमेंट ऐप्लिकेशन, लेन-देन की जानकारी का इस्तेमाल करके अपने यूज़र इंटरफ़ेस (यूआई) को लेबल करता है.

पांचवां चरण: ग्राहक की कार्रवाइयों के आधार पर, कारोबारी या कंपनी लेन-देन की जानकारी कैसे अपडेट कर सकती है

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

किसी कारोबारी या कंपनी को चार तरह के इवेंट मिल सकते हैं:

  • पेमेंट का तरीका बदलने से जुड़ा इवेंट
  • शिपिंग पता बदलने वाला इवेंट
  • शिपिंग का विकल्प बदलने वाला इवेंट
  • कारोबारी या कंपनी की पुष्टि करने वाला इवेंट

पेमेंट का तरीका बदलने से जुड़ा इवेंट

पेमेंट ऐप्लिकेशन में, पेमेंट के कई तरीके इस्तेमाल किए जा सकते हैं. साथ ही, कारोबारी या कंपनी, ग्राहक के चुने गए पेमेंट के तरीके के हिसाब से खास छूट दे सकती है. इस तरह के मामले को मैनेज करने के लिए, पेमेंट का तरीका बदलने वाला इवेंट, कारोबारी या कंपनी को पेमेंट के नए तरीके की जानकारी दे सकता है. इससे कारोबारी या कंपनी, छूट के साथ कुल कीमत को अपडेट कर सकती है और उसे पेमेंट ऐप्लिकेशन पर वापस भेज सकती है.

request.addEventListener('paymentmethodchange', e => {
  e.updateWith({
    // Add discount etc.
  });
});

शिपिंग पता बदलने वाला इवेंट

पेमेंट ऐप्लिकेशन, खरीदार का शिपिंग पता भी उपलब्ध करा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. यह ग्राहकों के लिए सुविधाजनक है, क्योंकि उन्हें किसी फ़ॉर्म में मैन्युअल तरीके से कोई जानकारी नहीं डालनी पड़ती. साथ ही, वे अपने शिपिंग पते को अलग-अलग कारोबारी या कंपनी की वेबसाइटों के बजाय, अपने पसंदीदा पेमेंट ऐप्लिकेशन में सेव कर सकते हैं.

अगर कोई ग्राहक लेन-देन शुरू होने के बाद, पेमेंट ऐप्लिकेशन में अपना शिपिंग पता अपडेट करता है, तो कारोबारी या कंपनी को 'shippingaddresschange' इवेंट भेजा जाएगा. इस इवेंट की मदद से, कारोबारी या कंपनी नए पते के आधार पर शिपिंग के लिए खरीदार से लिया जाने वाला शुल्क तय कर सकती है. साथ ही, कुल कीमत को अपडेट करके, उसे पेमेंट ऐप्लिकेशन को वापस भेज सकती है.

request.addEventListener('shippingaddresschange', e => {
  e.updateWith({
    // Update the details
  });
});

अगर कारोबारी या कंपनी, अपडेट किए गए पते पर शिपिंग नहीं कर सकती, तो वह गड़बड़ी का मैसेज दिखा सकती है. इसके लिए, उसे पेमेंट ऐप्लिकेशन को भेजे गए लेन-देन की जानकारी में, गड़बड़ी का पैरामीटर जोड़ना होगा.

शिपिंग का विकल्प बदलने वाला इवेंट

व्यापारी/कंपनी/कारोबारी, खरीदार को शिपिंग के कई विकल्प दे सकती है. साथ ही, वह पेमेंट ऐप्लिकेशन को यह विकल्प चुनने की अनुमति दे सकती है. शिपिंग के विकल्प, कीमतों और सेवा के नामों की सूची के तौर पर दिखाए जाते हैं. खरीदार इनमें से कोई भी विकल्प चुन सकता है. उदाहरण के लिए:

  • स्टैंडर्ड शिपिंग - मुफ़्त
  • एक्सप्रेस शिपिंग - 500 रुपये

जब कोई खरीदार किसी पेमेंट ऐप्लिकेशन में शिपिंग के विकल्प को अपडेट करता है, तो कारोबारी या कंपनी को 'shippingoptionchange' इवेंट भेजा जाएगा. इसके बाद, कारोबारी या कंपनी, शिपिंग के लिए खरीदार से लिया जाने वाला शुल्क तय कर सकती है, कुल कीमत अपडेट कर सकती है, और उसे पेमेंट ऐप्लिकेशन पर वापस भेज सकती है.

request.addEventListener('shippingoptionchange', e => {
  e.updateWith({
    // Update the details
  });
});

कारोबारी या कंपनी, खरीदार के शिपिंग पते के आधार पर, शिपिंग के विकल्पों में डाइनैमिक तरीके से बदलाव कर सकती है. यह तब काम आता है, जब किसी कारोबारी या कंपनी को देश और विदेश के खरीदारों के लिए, शिपिंग के अलग-अलग विकल्प उपलब्ध कराने हों.

कारोबारी या कंपनी की पुष्टि करने वाला इवेंट

पेमेंट ऐप्लिकेशन, पेमेंट की प्रोसेस शुरू करने से पहले कारोबारी या कंपनी की पुष्टि कर सकता है. इससे सुरक्षा को और बेहतर बनाया जा सकता है. पुष्टि करने के तरीके का डिज़ाइन, पेमेंट ऐप्लिकेशन तय करता है. हालांकि, कारोबारी या कंपनी की पुष्टि करने वाले इवेंट से, कारोबारी या कंपनी को उस यूआरएल की जानकारी मिलती है जिसका इस्तेमाल करके वे अपनी पुष्टि कर सकते हैं.

request.addEventListener('merchantvalidation', e => {
  e.updateWith({
    // Use `e.validateURL` to validate
  });
});

छठा चरण: कारोबारी या कंपनी, पेमेंट की पुष्टि करती है और लेन-देन पूरा करती है

जब ग्राहक पेमेंट की अनुमति दे देता है, तो show() तरीका एक प्रॉमिस दिखाता है, जो PaymentResponse में रिज़ॉल्व होता है. PaymentResponse ऑब्जेक्ट में यह जानकारी शामिल होती है:

  • पेमेंट के नतीजे की जानकारी
  • शिपिंग पता
  • शिपिंग का विकल्प
  • संपर्क जानकारी

इस समय, ब्राउज़र के यूज़र इंटरफ़ेस (यूआई) पर अब भी लोड होने की जानकारी देने वाला इंडिकेटर दिख सकता है. इसका मतलब है कि लेन-देन अभी पूरा नहीं हुआ है.

अगर पेमेंट न होने या किसी गड़बड़ी की वजह से पेमेंट ऐप्लिकेशन बंद हो जाता है, तो show() से मिला प्रॉमिस अस्वीकार हो जाता है. साथ ही, ब्राउज़र पेमेंट लेन-देन को बंद कर देता है.

पेमेंट को प्रोसेस करना और उसकी पुष्टि करना

PaymentResponse में मौजूद details, पेमेंट क्रेडेंशियल ऑब्जेक्ट है. इसे पेमेंट ऐप्लिकेशन से वापस किया जाता है. कारोबारी या कंपनी, पेमेंट को प्रोसेस करने या उसकी पुष्टि करने के लिए क्रेडेंशियल का इस्तेमाल कर सकती है. यह ज़रूरी प्रोसेस कैसे काम करती है, यह पेमेंट हैंडलर पर निर्भर करता है.

लेन-देन पूरा करना या फिर से कोशिश करना

पेमेंट पूरा हुआ या नहीं, यह तय करने के बाद कारोबारी या कंपनी इनमें से कोई एक काम कर सकती है:

  • लेन-देन पूरा करने और लोड होने के इंडिकेटर को खारिज करने के लिए, .complete() वाले तरीके को कॉल करें.
  • retry() तरीके को कॉल करके, ग्राहक को फिर से कोशिश करने दें.
async function doPaymentRequest() {
  try {
    const request = new PaymentRequest(methodData, details, options);
    const response = await request.show();
    await validateResponse(response);
  } catch (err) {
    // AbortError, SecurityError
    console.error(err);
  }
}

async function validateResponse(response) {
  try {
    const errors = await checkAllValuesAreGood(response);
    if (errors.length) {
      await response.retry(errors);
      return validateResponse(response);
    }
    await response.complete("success");
  } catch (err) {
    // Something went wrong…
    await response.complete("fail");
  }
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();

अगले चरण