USDC চেকআউট ইন্টিগ্রেশন
চেকআউটে USDC পেমেন্ট ইন্টিগ্রেট করার একটি বাস্তবভিত্তিক ইঞ্জিনিয়ারিং গাইড: API প্যাটার্ন, নেটওয়ার্ক বাছাই, ওয়েবহুক আইডেমপোটেন্সি, এবং প্রোডাকশনে আপনি যেসব ব্যর্থতার মুখোমুখি হবেন।
সংক্ষেপে
একটি USDC চেকআউট ইন্টিগ্রেশন পরিচিত একটি প্যাটার্ন অনুসরণ করে: আপনার সার্ভারে একটি পেমেন্ট ইনটেন্ট তৈরি করুন (পরিমাণ, মুদ্রা, নেটওয়ার্ক পছন্দ), আপনার অ্যাকুয়ারারের কাছ থেকে একটি হোস্টেড চেকআউট URL বা উইজেট কনফিগ নিন, ক্রেতাকে তাঁর ওয়ালেটে পেমেন্ট করতে দিন, এবং নিশ্চিতকরণের ওয়েবহুকটি আইডেমপোটেন্টভাবে সামলান। সবচেয়ে গুরুত্বপূর্ণ ইঞ্জিনিয়ারিং সিদ্ধান্তগুলো হলো নেটওয়ার্ক নির্বাচন (এক সেন্টেরও কম ফি-র জন্য ডিফল্ট হিসেবে Solana বা Base), ওয়েবহুক আইডেমপোটেন্সি (অর্ডার ID + tx হ্যাশ ব্যবহার করুন), রিফান্ড প্রক্রিয়া (চেকআউটে ওয়ালেট ঠিকানা সংগ্রহ করুন, রিফান্ড API দিন), এবং ওয়ালেটে স্বাক্ষরের ধাপের জন্য মসৃণ UX (মোবাইল ওয়ালেটে ডিপ-লিংক, ডেস্কটপে বিকল্প হিসেবে QR)। সঠিকভাবে করা হলে USDC চেকআউট শুরু থেকে শেষ পর্যন্ত 30 সেকেন্ডের কম সময়ে সম্পন্ন হয় এবং অ্যাকুয়ারারভেদে মার্চেন্টের খরচ হয় 0.3%–1%।
প্রচলিত API কাঠামো
USDC অ্যাকুয়ারিং API-গুলো মোটামুটি Stripe-এর জনপ্রিয় করা পেমেন্ট-ইনটেন্ট প্যাটার্ন অনুসরণ করে। ন্যূনতম পরিসর:
সার্ভার পেমেন্ট ইনটেন্ট তৈরি করে
POST /v1/payments, যার বডিতে থাকেamount,currency(ফিয়াটে কোট করলে USD; স্টেবলকয়েনে কোট করলে USDC),settlement_preference(USDC বনাম ফিয়াট),networks(অনুমোদিত তালিকা),order_id(আপনার আইডেমপোটেন্সি কী),success_url,cancel_url, এবং আপনার নিজস্ব রিকনসিলিয়েশনের জন্য একটিmetadataব্লব।অ্যাকুয়ারার চেকআউট URL বা উইজেট কনফিগ ফেরত দেয়
হোস্টেড চেকআউটের ক্ষেত্রে: একটি URL, যেখানে ক্রেতাকে রিডাইরেক্ট করা হয়। এমবেডেড উইজেটের ক্ষেত্রে: একটি ক্লায়েন্ট-সাইড কনফিগ (পাবলিশেবল কী, ইনটেন্ট ID), যা উইজেটটি লোড করে। উভয় প্রক্রিয়াই ওয়ালেট শনাক্তকরণ, নেটওয়ার্ক নির্বাচন ও কোট প্রদর্শন সামলায়।
ক্রেতা ওয়ালেটে স্বাক্ষর করেন, অন-চেইন ট্রান্সফার সম্প্রচারিত হয়
মোবাইল: MetaMask, Phantom, Trust ইত্যাদিতে ডিপ-লিংক। ডেস্কটপ: WalletConnect QR বা ব্রাউজার-এক্সটেনশন পপআপ। ক্রেতা পরিমাণটি পর্যালোচনা করে স্বাক্ষর করেন।
অ্যাকুয়ারার কনফার্মেশনের জন্য অপেক্ষা করে, ওয়েবহুক পাঠায়
POST your_webhook_url, যার পেলোডে থাকেevent_type: “payment.succeeded”,order_id,amount,tx_hash,network, এবং একটি স্বাক্ষর, যা আপনি অ্যাকুয়ারারের ওয়েবহুক সিক্রেট দিয়ে যাচাই করেন।সার্ভার আইডেমপোটেন্টভাবে অর্ডারটি পরিশোধিত হিসেবে চিহ্নিত করে
ওয়েবহুকের স্বাক্ষর যাচাই করুন, আপনার DB-তে
(order_id, tx_hash)খুঁজে দেখুন, আগে চিহ্নিত না হয়ে থাকলে পরিশোধিত হিসেবে চিহ্নিত করুন, ফুলফিলমেন্ট শুরু করুন।
নেটওয়ার্ক নির্বাচন
কোন কোন নেটওয়ার্ক গ্রহণ করবেন, সেই সিদ্ধান্তটি UX ও খরচের মধ্যে একটি ভারসাম্যের প্রশ্ন:
- Solana: এক সেন্টেরও কম নেটওয়ার্ক ফি, এক সেকেন্ডেরও কম সময়ে কনফার্মেশন। ছোট AOV-এর জন্য সেরা ডিফল্ট।
- Base: কয়েক সেন্ট নেটওয়ার্ক ফি, কয়েক সেকেন্ডে কনফার্মেশন। শক্তিশালী ওয়ালেট সমর্থন; ক্রিপ্টো-নেটিভ ব্যবহারকারীদের জন্য ভালো ডিফল্ট।
- Polygon, Arbitrum: Base-এর মতোই ফি ও গতি। যোগ করা যেতে পারে, তবে একেবারে আবশ্যক নয়।
- Ethereum মেইননেট: গ্যাসের ওপর নির্ভর করে $1–$8+ নেটওয়ার্ক ফি। ছোট অর্ডারে ক্রেতাদের জন্য কষ্টকর। উচ্চ AOV-এর (>$500) জন্য বা বিকল্প হিসেবে গ্রহণ করুন।
- Tron: আপনি যদি এশিয়া/আফ্রিকার USDT প্রবাহকে লক্ষ্য করেন, তবে USDC-এর পাশাপাশি USDT-TRON সমর্থন করার কথা বিবেচনা করা যেতে পারে।
ওয়েবহুক আইডেমপোটেন্সি
ওয়েবহুক পুনরায় পাঠানো হয়। আপনার হ্যান্ডলারকে অবশ্যই আইডেমপোটেন্ট হতে হবে। প্রচলিত প্যাটার্ন:
- আপনার অ্যাকুয়ারারের সিক্রেট দিয়ে HMAC-SHA256 ব্যবহার করে ওয়েবহুকের স্বাক্ষর যাচাই করুন।
- পেলোড থেকে
(order_id, tx_hash)বের করুন। - আপনার
processed_paymentsটেবিলে সেই জোড়াটি খুঁজে দেখুন। - পাওয়া গেলে: আর কিছু না করে 200 OK ফেরত দিন।
- না পাওয়া গেলে: সারিটি যোগ করুন (জোড়াটির ওপর একটি UNIQUE কনস্ট্রেইন্টসহ), তারপর আপনার প্রধান অর্ডার টেবিলে অর্ডারটি পরিশোধিত হিসেবে চিহ্নিত করুন, তারপর ফুলফিলমেন্ট শুরু করুন।
- ধাপ 5-কে একটি একক DB ট্রানজ্যাকশনে মুড়ে দিন, যাতে মাঝপথে ক্র্যাশ হলে দুবার ফুলফিলমেন্ট না হয়।
বেশিরভাগ অ্যাকুয়ারিং ওয়েবহুকে একটি ডেলিভারি ID থাকে; ডিবাগিংয়ের জন্য এটি লগ করুন, কিন্তু আইডেমপোটেন্সি কী হিসেবে এর ওপর নির্ভর করবেন না। নেটওয়ার্ক কনফার্মেশন ও অ্যাকুয়ারারের পুনঃপ্রচেষ্টা থেকে ডুপ্লিকেট payment.succeeded ইভেন্ট তৈরি হতে পারে, যাদের ডেলিভারি ID ভিন্ন কিন্তু tx_hash একই; আপনার ডিডুপ্লিকেশন হতে হবে অন-চেইন পরিচয়ের ভিত্তিতে, ডেলিভারির ভিত্তিতে নয়।
রিফান্ড প্রক্রিয়া
দুটি প্যাটার্নই প্রধান:
- প্রেরকের কাছে রিফান্ড: ক্রেতা মূলত যে ঠিকানা থেকে পেমেন্ট করেছিলেন, অ্যাকুয়ারার সেই ঠিকানায় USDC ফেরত পাঠায়। সবচেয়ে পরিচ্ছন্ন UX; এটি কাজ করে কারণ অন-চেইন পেমেন্ট রেকর্ডে উৎস ঠিকানাটি থাকে।
- নির্দিষ্ট ঠিকানায় রিফান্ড: ক্রেতা একটি রিফান্ড গন্তব্য নির্দিষ্ট করেন (তিনি কোনো এক্সচেঞ্জ বা হট ওয়ালেট থেকে পেমেন্ট করে থাকলে এটি উৎস ঠিকানা থেকে ভিন্ন হতে পারে)। বেশিরভাগ অ্যাকুয়ারার
destination_address-সহ একটিPOST /v1/refunds-এর মাধ্যমে এটি সমর্থন করে।
রিফান্ডের অংশের নেটওয়ার্ক ফি মার্চেন্ট পরিশোধ করেন। পূর্ণ ও আংশিক উভয় রিফান্ডই সমর্থিত। রিফান্ডে মূল পেমেন্টের মতোই অন-চেইন কনফার্মেশনের সময় লাগে।
প্রোডাকশনে ব্যর্থতার ধরন
- স্বাক্ষরের পর ক্রেতা চলে যান। অন-চেইন ট্রান্সফার সম্প্রচারিত হয়েছে, কিন্তু ওয়েবহুক পাঠানোর আগেই তিনি ট্যাব বন্ধ করে দেন। অ্যাকুয়ারার তবুও অন-চেইন পর্যবেক্ষণের মাধ্যমে পেমেন্টটি শনাক্ত ও নিশ্চিত করে; আপনার ফুলফিলমেন্ট চলে ওয়েবহুক থেকে, রিডাইরেক্ট থেকে নয়।
- ক্রেতা ভুল পরিমাণ পরিশোধ করেন। বেশিরভাগ অ্যাকুয়ারার অন-চেইন শনাক্তকরণের সময়েই অমিল পরিমাণ প্রত্যাখ্যান করে। কেউ কেউ আনুমানিক মিল (একটি সহনসীমার মধ্যে) গ্রহণ করে এবং অমিলটি ওয়েবহুকে জানায়।
- ক্রেতা ভুল নেটওয়ার্কে পেমেন্ট করেন। তিনি Ethereum-এ স্বাক্ষর করলেন অথচ আপনি শুধু Solana গ্রহণ করেন, এমন হলে পেমেন্টটি আপনার অ্যাকুয়ারারের পর্যবেক্ষণের সম্পূর্ণ বাইরে থেকে যায়। বেশিরভাগ প্রদানকারী একটি পুনরুদ্ধার প্রক্রিয়ার মাধ্যমে তহবিল ফেরত দেয়; কেউ কেউ তা হারিয়ে ফেলে। চেকআউটে নেটওয়ার্ক নির্বাচন স্পষ্ট করে দিন।
- ক্রেতা এক্সচেঞ্জের ঠিকানা থেকে পেমেন্ট করেন। উৎস ঠিকানায় পাঠানো রিফান্ড ফেরত আসতে পারে বা ভুল অ্যাকাউন্টে পৌঁছাতে পারে। যেসব পণ্যে রিফান্ডের সম্ভাবনা আছে, সেগুলোর ক্ষেত্রে চেকআউটে স্পষ্টভাবে একটি রিফান্ড গন্তব্য ঠিকানা সংগ্রহ করুন।
- স্টেবলকয়েন ডিপেগ। বিরল, কিন্তু বাস্তব। কোট ও অন-চেইন সেটেলমেন্টের মধ্যকার সংক্ষিপ্ত সময়ে USDC উল্লেখযোগ্যভাবে ডিপেগ হলে, চুক্তি অনুযায়ী মার্চেন্ট বা অ্যাকুয়ারার পার্থক্যটি বহন করে।
DPT Acquiring দিয়ে USDC চেকআউট যোগ করুন
প্রতি লেনদেনে 0.3% থেকে। USDC বা ফিয়াটে একই দিনে সেটেলমেন্ট। হোস্টেড চেকআউট URL বা এমবেড করা যায় এমন উইজেট। SDK ও ওয়েবহুক ডকুমেন্টেশন merchant.dpt.xyz-এ।