মার্চেন্টরা কীভাবে পেমেন্ট অ্যাপ ইন্টিগ্রেট করেন এবং পেমেন্ট ট্রানজ্যাকশন কীভাবে কাজ করে তা জানুন Payment Request API-এর মাধ্যমে।
ওয়েব পেমেন্ট API হল ব্রাউজারে প্রথমবার তৈরি করা ডেডিকেটেড পেমেন্ট ফিচার। ওয়েব পেমেন্টের মাধ্যমে, পেমেন্ট অ্যাপের সাথে মার্চেন্ট ইন্টিগ্রেশন আরও সহজ হয়ে যায় এবং গ্রাহকের অভিজ্ঞতা স্ট্রিমলাইনড ও আরও সুরক্ষিত হয়।
ওয়েব পেমেন্ট ব্যবহার করার সুবিধা সম্পর্কে আরও জানতে ওয়েব পেমেন্টের মাধ্যমে পেমেন্ট অ্যাপকে আরও শক্তিশালী করা নিবন্ধটি দেখুন।
এই নিবন্ধটি আপনাকে মার্চেন্ট ওয়েবসাইটে পেমেন্ট ট্রানজ্যাকশন সম্পর্কে বিস্তারিত তথ্য প্রদান করে এবং পেমেন্ট অ্যাপ ইন্টিগ্রেশন কীভাবে কাজ করে তা বুঝতে সাহায্য করে।
এই প্রসেসে ৬টি ধাপ রয়েছে:
- মার্চেন্ট পেমেন্ট ট্রানজ্যাকশন শুরু করে।
- মার্চেন্ট একটি পেমেন্ট বোতাম দেখায়।
গ্রাহক পেমেন্ট বোতাম প্রেস করেন।
ব্রাউজার পেমেন্ট অ্যাপ চালু করে।
গ্রাহক কোনও বিবরণ পরিবর্তন করলে (যেমন শিপিং বিকল্প বা তার ঠিকানা), মার্চেন্ট ট্রানজ্যাকশনের বিবরণ আপডেট করে পরিবর্তনটি দেখায়।
গ্রাহক কেনাকাটা কনফার্ম করার পরে, মার্চেন্ট পেমেন্ট যাচাই করেন এবং ট্রানজ্যাকশন সম্পূর্ণ করেন।
ধাপ ১: মার্চেন্ট পেমেন্ট ট্রানজ্যাকশন শুরু করেন
গ্রাহক কেনাকাটা করার সিদ্ধান্ত নিলে, মার্চেন্ট
PaymentRequest
অবজেক্ট তৈরি করে পেমেন্ট ট্রানজ্যাকশন শুরু করেন। এই অবজেক্টে ট্রানজ্যাকশন সম্পর্কিত গুরুত্বপূর্ণ তথ্য থাকে:
- ট্রানজ্যাকশন প্রসেস করার জন্য গ্রহণযোগ্য পেমেন্ট পদ্ধতি এবং সেটির ডেটা।
- মোট দাম (প্রয়োজনীয়) এবং আইটেম সম্পর্কিত তথ্যের মতো বিবরণ।
- এমন বিকল্প যেখানে মার্চেন্ট শিপিং সংক্রান্ত তথ্য যেমন শিপিং অ্যাড্রেস ও শিপিং বিকল্পের জন্য অনুরোধ করতে পারেন।
- এছাড়াও, মার্চেন্ট বিলিং ঠিকানা, পেমেন্টকারীর নাম, ইমেল ও ফোন নম্বর অনুরোধ করতে পারেন।
- এছাড়াও, মার্চেন্টরা
PaymentRequest-এ ঐচ্ছিক শিপিংয়ের ধরন (shipping,deliveryবাpickup) যোগ করতে পারেন। পেমেন্ট অ্যাপ সেটিকে ইঙ্গিত হিসেবে ব্যবহার করে তার UI-তে সঠিক লেবেল দেখাতে পারে।
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()
মেথড কল করেন যা সাথে সাথে পেমেন্ট UI
লঞ্চ করে।
চূড়ান্ত মোট দাম ডাইনামিকভাবে সেট করা হলে (যেমন, সার্ভার থেকে পাওয়া), মোট দাম না জানা পর্যন্ত মার্চেন্ট পেমেন্ট UI লঞ্চ করা পিছিয়ে দিতে পারেন।
পেমেন্ট UI লঞ্চ করার প্রসেস পিছিয়ে দেওয়া হচ্ছে
চূড়ান্ত মোট দাম নির্ধারণ না হওয়া পর্যন্ত পেমেন্ট UI স্থগিত রাখার ডেমো দেখুন।
পেমেন্ট UI স্থগিত করতে, মার্চেন্ট 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()-এর জন্য আর্গুমেন্ট হিসেবে কোনও প্রমিস উল্লেখ করা না থাকলে, ব্রাউজার অবিলম্বে পেমেন্ট UI লঞ্চ করবে।
ধাপ ৪: ব্রাউজার পেমেন্ট অ্যাপ চালু করে
ব্রাউজারটি প্ল্যাটফর্ম-নির্দিষ্ট বা ওয়েব-ভিত্তিক পেমেন্ট অ্যাপ চালু করতে পারে। (আপনি Chrome কীভাবে নির্ধারণ করে যে কোন পেমেন্ট অ্যাপ চালু করতে হবে সেই সম্পর্কে আরও জানতে পারেন।)
পেমেন্ট অ্যাপ কীভাবে তৈরি করা হবে তা বেশিরভাগ ক্ষেত্রে ডেভেলপার ঠিক করেন, তবে মার্চেন্টের থেকে এবং মার্চেন্টের কাছে পাঠানো ইভেন্ট এবং সেইসব ইভেন্টের সাথে পাঠানো ডেটার স্ট্রাকচার স্ট্যান্ডার্ডাইজ করা হয়।
পেমেন্ট অ্যাপ চালু হলে, এটি ট্রানজ্যাকশন
তথ্য
পায় যা ধাপ ১-এ PaymentRequest অবজেক্টে পাস করা হয়, এতে নিম্নলিখিতগুলি অন্তর্ভুক্ত থাকে:
- পেমেন্ট পদ্ধতি সংক্রান্ত ডেটা
- মোট দাম
- পেমেন্টের বিকল্প
পেমেন্ট অ্যাপটি তার UI লেবেল করার জন্য ট্রানজ্যাকশনের তথ্য ব্যবহার করে।
ধাপ ৫: গ্রাহকের অ্যাকশনের উপর নির্ভর করে একজন মার্চেন্ট কীভাবে ট্রানজ্যাকশনের বিবরণ আপডেট করতে পারেন
গ্রাহকের কাছে পেমেন্ট অ্যাপে পেমেন্ট পদ্ধতি ও শিপিং বিকল্পের মতো ট্রানজ্যাকশনের বিবরণ পরিবর্তন করার বিকল্প থাকে। গ্রাহক পরিবর্তন করলে, মার্চেন্ট পরিবর্তন সংক্রান্ত ইভেন্ট পান এবং ট্রানজ্যাকশনের বিবরণ আপডেট করেন।
একজন মার্চেন্ট চার ধরনের ইভেন্ট পেতে পারেন:
- পেমেন্ট পদ্ধতি পরিবর্তন সংক্রান্ত ইভেন্ট
- শিপিং অ্যাড্রেস পরিবর্তন সংক্রান্ত ইভেন্ট
- শিপিং সংক্রান্ত বিকল্প পরিবর্তন করার ইভেন্ট
- মার্চেন্ট যাচাইকরণ ইভেন্ট
পেমেন্ট পদ্ধতি পরিবর্তন সংক্রান্ত ইভেন্ট
একটি পেমেন্ট অ্যাপ একাধিক পেমেন্ট পদ্ধতি সাপোর্ট করতে পারে এবং গ্রাহকের পছন্দের উপর নির্ভর করে মার্চেন্ট বিশেষ ছাড় অফার করতে পারে। এই ধরনের পরিস্থিতি সামাল দিতে, পেমেন্ট পদ্ধতি পরিবর্তন সংক্রান্ত ইভেন্ট মার্চেন্টকে নতুন পেমেন্ট পদ্ধতি সম্পর্কে জানাতে পারে, যাতে তারা ছাড় সহ মোট দাম আপডেট করে পেমেন্ট অ্যাপে ফেরত পাঠাতে পারে।
request.addEventListener('paymentmethodchange', e => {
e.updateWith({
// Add discount etc.
});
});
শিপিং অ্যাড্রেস পরিবর্তন সংক্রান্ত ইভেন্ট
পেমেন্ট অ্যাপ গ্রাহকের শিপিং অ্যাড্রেস প্রদান করতে পারে। এটি গ্রাহকদের জন্য সুবিধাজনক কারণ তাদের কোনও ফর্মে ম্যানুয়ালি কোনও বিবরণ লিখতে হয় না এবং তারা একাধিক ভিন্ন মার্চেন্ট ওয়েবসাইটের পরিবর্তে তাদের পছন্দের পেমেন্ট অ্যাপে তাদের শিপিং ঠিকানা স্টোর করতে পারে।
ট্রানজ্যাকশন শুরু হওয়ার পরে কোনও গ্রাহক পেমেন্ট অ্যাপে তার শিপিং অ্যাড্রেস আপডেট করলে, মার্চেন্টকে একটি 'shippingaddresschange' ইভেন্ট পাঠানো
হবে। এই ইভেন্ট মার্চেন্টকে নতুন ঠিকানার উপর ভিত্তি করে শিপিংয়ের খরচ নির্ধারণ করতে,
মোট দাম আপডেট করতে এবং পেমেন্ট অ্যাপে তা ফেরত পাঠাতে সাহায্য করে।
request.addEventListener('shippingaddresschange', e => {
e.updateWith({
// Update the details
});
});
মার্চেন্ট যদি আপডেট করা ঠিকানায় শিপিং করতে না পারেন, তাহলে পেমেন্ট অ্যাপে ফেরত পাঠানো ট্রানজ্যাকশনের বিবরণে একটি ত্রুটি প্যারামিটার যোগ করে তিনি একটি ত্রুটি মেসেজ প্রদান করতে পারেন।
শিপিং সংক্রান্ত বিকল্প পরিবর্তন করার ইভেন্ট
একজন মার্চেন্ট গ্রাহককে একাধিক শিপিং বিকল্প অফার করতে পারেন এবং সেই পছন্দটি পেমেন্ট অ্যাপে প্রতিনিধি হিসেবে পাঠাতে পারেন। শিপিং বিকল্পগুলি দাম এবং পরিষেবার নামের একটি তালিকা হিসাবে দেখানো হয় যেখান থেকে গ্রাহক বেছে নিতে পারেন। যেমন:
- স্ট্যান্ডার্ড শিপিং - ফ্রি
- এক্সপ্রেস শিপিং - ৫ মার্কিন ডলার
কোনও গ্রাহক পেমেন্ট অ্যাপে শিপিং সংক্রান্ত বিকল্প আপডেট করলে, মার্চেন্টকে একটি
'shippingoptionchange' ইভেন্ট পাঠানো হবে। তারপর মার্চেন্ট শিপিং কস্ট নির্ধারণ করতে, মোট দাম আপডেট করতে এবং পেমেন্ট অ্যাপে তা ফেরত পাঠাতে পারবেন।
request.addEventListener('shippingoptionchange', e => {
e.updateWith({
// Update the details
});
});
এছাড়াও, মার্চেন্ট গ্রাহকের শিপিং অ্যাড্রেসের উপর ভিত্তি করে শিপিংয়ের বিকল্প ডাইনামিকভাবে পরিবর্তন করতে পারেন। কোনও মার্চেন্ট যখন দেশীয় ও আন্তর্জাতিক গ্রাহকদের জন্য শিপিংয়ের আলাদা আলাদা বিকল্প অফার করতে চান, তখন এটি কাজে লাগে।
মার্চেন্ট যাচাইকরণ ইভেন্ট
অতিরিক্ত নিরাপত্তার জন্য, পেমেন্ট অ্যাপ পেমেন্ট ফ্লোতে এগিয়ে যাওয়ার আগে মার্চেন্ট যাচাইকরণ করতে পারে। যাচাইকরণ মেকানিজমের ডিজাইন পেমেন্ট অ্যাপের উপর নির্ভর করে, তবে মার্চেন্ট যাচাইকরণ ইভেন্ট মার্চেন্টকে সেই URL সম্পর্কে জানায় যা তারা নিজেদের যাচাই করতে ব্যবহার করতে পারে।
request.addEventListener('merchantvalidation', e => {
e.updateWith({
// Use `e.validateURL` to validate
});
});
ধাপ ৬: মার্চেন্ট পেমেন্ট যাচাই করে ট্রানজ্যাকশন সম্পূর্ণ করেন
গ্রাহক পেমেন্ট সফলভাবে অনুমোদন করলে, show() পদ্ধতি
একটি প্রমিস রিটার্ন করে যা
PaymentResponse-এ সমাধান করে।
PaymentResponse অবজেক্টে নিম্নলিখিত তথ্য অন্তর্ভুক্ত থাকে:
- পেমেন্ট ফলাফলের বিবরণ
- শিপিং অ্যাড্রেস
- শিপিং সংক্রান্ত বিকল্প
- যোগাযোগের তথ্য
এই মুহূর্তে, ব্রাউজার UI এখনও একটি লোডিং ইন্ডিকেটর দেখাতে পারে যার অর্থ হল ট্রানজ্যাকশন এখনও সম্পূর্ণ হয়নি।
পেমেন্ট সম্পূর্ণ না হওয়া বা কোনও সমস্যার কারণে পেমেন্ট অ্যাপ বন্ধ হয়ে গেলে,
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();
পরবর্তী ধাপ
- পেমেন্ট পদ্ধতি সেট-আপ করা বিভাগে পেমেন্ট পদ্ধতি শনাক্তকারী কীভাবে বিস্তারিতভাবে ঘোষণা করতে হয় তা জানুন।
- Android পেমেন্ট অ্যাপ ডেভেলপার গাইড থেকে প্ল্যাটফর্ম-নির্দিষ্ট পেমেন্ট অ্যাপ কীভাবে তৈরি করতে হয় তা জানুন।
- ওয়েব-ভিত্তিক পেমেন্ট অ্যাপ ডেভেলপারদের গাইড থেকে ওয়েব-ভিত্তিক পেমেন্ট অ্যাপ কীভাবে তৈরি করতে হয় তা জানুন।