ব্যবহারের ক্ষেত্র

প্লাগইন ছাড়াই অনলাইন স্টোরে ক্রিপ্টো পেমেন্ট নিন

একটি অনলাইন স্টোর Crypto Merchant দিয়ে ক্রিপ্টো নেয় REST API-এর মাধ্যমে প্রতি অর্ডারে একটি ইনভয়েস তৈরি করে এবং গ্রাহককে ইনভয়েসের হোস্ট করা চেকআউট পেজে পাঠিয়ে। গ্রাহক একটি কয়েন বেছে নেন, সেই ইনভয়েসের জন্য লক করা রেটে সঠিক পরিমাণ পেমেন্ট করেন, এবং সাইন করা invoice.paid ওয়েবহুক পৌঁছালে আপনার সার্ভার অর্ডার শিপ করে। ফি প্রতি পরিশোধিত ইনভয়েসে 1%। কোনো WooCommerce, Shopify বা Magento প্লাগইন নেই: ইন্টিগ্রেশন হলো একটি API কল ও একটি ওয়েবহুক এন্ডপয়েন্ট।

আপডেট 6 নভেম্বর, 2026

এই পেজের সবকিছু বর্ণনা করে Crypto Merchant আজ কীভাবে কাজ করে, যেমনটি API রেফারেন্স, চেকআউট ডকুমেন্টেশন ও মূল্য পেজে বলা আছে। এখানে কোনো কিছুই অন্য গেটওয়ে সম্পর্কে কোনো দাবি নয়।

এক নজরে

বিষয়	কীভাবে কাজ করে
গ্রাহক কীভাবে পেমেন্ট করেন	একটি হোস্ট করা ইনভয়েস পেজে: আপনি যেগুলো নেন তার মধ্য থেকে তিনি একটি কয়েন ও নেটওয়ার্ক বেছে নেন, সঠিক পরিমাণ ও সেই ইনভয়েসের জন্য তৈরি একটি ডিপোজিট ঠিকানা দেখেন, QR কোড ও কাউন্টডাউনসহ।
আপনি কী বানান	গ্রাহক ক্রিপ্টো বেছে নিলে একটি `POST /invoices` কল, এবং ওয়েবহুকের জন্য একটি HTTPS এন্ডপয়েন্ট। HTTPS রিকোয়েস্ট করতে পারে এমন যেকোনো ভাষা বা ফ্রেমওয়ার্ক।
কখন শিপ করবেন	`invoice.paid` ইভেন্টে, পেমেন্ট তার কনফার্মেশন পাওয়ার পর। কখনোই `invoice.confirming`-এ নয়।
ভুল পরিমাণ	আপনার ছাড়ের সীমার মধ্যে কম পড়া পেমেন্ট পরিশোধিত বলে গণ্য হয়। তার বেশি ঘাটতিতে ইনভয়েস `underpaid` হয়: গ্রাহক বাকিটা পাঠাতে পারেন বা যা পাঠিয়েছেন তা ফেরত নিতে পারেন। বেশি পেমেন্টও পরিশোধিত বলে গণ্য হয়, আর অতিরিক্তটা গ্রাহকের জন্য রাখা থাকে।
মূল্যের মুদ্রা	ডিফল্টে মার্কিন ডলার, অথবা EUR, GBP, TRY বা BRL-এর মতো অন্য কোনো সমর্থিত মুদ্রা; গ্রাহক কয়েন বেছে নেওয়ার সময় লাইভ দাম থেকে কয়েনের পরিমাণ হিসাব করা হয়।
প্লাগইন	নেই। নিচের ফ্লো API কল করতে পারে এমন যেকোনো কার্ট বা কাস্টম চেকআউটের সঙ্গে কাজ করে।

ধাপে ধাপে কীভাবে কাজ করে?

গ্রাহক “ক্রিপ্টোতে পেমেন্ট” বেছে নেওয়ার মুহূর্ত থেকে অর্ডার আপনার গুদাম ছাড়া পর্যন্ত:

1
চেকআউটে ইনভয়েস তৈরি করুন
গ্রাহক ক্রিপ্টো বেছে নিলে আপনার সার্ভার POST /invoices কল করে অর্ডারের মোট, আপনার order_id, গ্রাহকের ইমেইল, আপনার ধন্যবাদ পেজে ফেরার redirect_url এবং ফিরে পেতে চাওয়া যেকোনো metadata দিয়ে। উত্তরে আসে checkout_url সহ ইনভয়েসটি।
2
গ্রাহককে ইনভয়েস পেজে পাঠান
checkout_url-এ রিডাইরেক্ট করুন। পেজটি আপনার নেওয়া কয়েনগুলো দেখায়; গ্রাহক একটি বেছে নিলে সেই কয়েনে পরিমাণ লাইভ দাম থেকে হিসাব করে লক করা হয়, এবং এই ইনভয়েসের জন্য তৈরি একটি ডিপোজিট ঠিকানা QR কোডসহ দেখানো হয়। ইনভয়েস আপনার ঠিক করা সময় পর্যন্ত খোলা থাকে, ডিফল্টে 30 মিনিট।
3
সাইন করা ওয়েবহুক গ্রহণ করুন
পেমেন্ট অন-চেইনে দেখা গেলে আপনার এন্ডপয়েন্ট invoice.confirming পায়, আর পর্যাপ্ত কনফার্মেশন হলে invoice.paid। CM-Signature হেডার যাচাই করুন, ইভেন্ট সেভ করুন, 10 সেকেন্ডের মধ্যে 2xx দিয়ে উত্তর দিন, তারপর আপনার সেভ করা কপি থেকে অর্ডার রিলিজ করুন। ইভেন্ট দুবার আসতে পারে: একবারই শিপ করতে ইভেন্টের id ব্যবহার করুন।
4
তিনটি বিশেষ ক্ষেত্র সামলান
invoice.expired: সময়মতো কোনো পেমেন্ট আসেনি, তাই নতুন একটি ইনভয়েস দিন। invoice.underpaid: গ্রাহক বাকিটা একই ঠিকানায় পাঠাতে পারেন বা ইনভয়েস পেজ থেকে রিফান্ড নিতে পারেন। বেশি পেমেন্টের ইনভয়েস তবুও পরিশোধিত; অতিরিক্তটা গ্রাহকের জন্য রাখা থাকে, যা তিনি ইনভয়েস পেজ থেকে তুলে নিতে পারেন।
5
পেআউট নিন
কনফার্ম হওয়া পেমেন্ট 1% বাদ দিয়ে আপনার ব্যালেন্সে জমা হয় এবং আপনার ব্যবসার পুল ওয়ালেটে সুইপ হয়। যেকোনো সময় আপনার নিজস্ব ঠিকানায় পেআউট করুন, প্রতিটি কয়েন যেমন আছে তেমন বা সবকিছু একটি হোল্ডিং কয়েনে সোয়াপ করে।

যে একটি API কল লাগে

চেকআউটে ইনভয়েস তৈরি করুন

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

খরচ কত?

প্রতিটি পরিশোধিত ইনভয়েসের 1%, পেমেন্ট আপনার ব্যালেন্সে জমা হওয়ার সময় কাটা হয়। কোনো সেটআপ ফি নেই, কোনো মাসিক ফি নেই, লাইভ হতেও কোনো পেমেন্ট লাগে না; মেয়াদোত্তীর্ণ ও বাতিল ইনভয়েসে কোনো খরচ নেই। কয়েন সরানোর (সুইপ, সোয়াপ ও পেআউট) জন্য একটি গ্যাস ফি লাগে, যা আপনি গ্যাস ব্যালেন্স যোগ করলে সেখান থেকে, না করলে সরানো কয়েন থেকে নেওয়া হয়। গ্রাহকরাও প্রতিটি ইনভয়েসে একটি গ্যাস ফি দেন: এটি তাঁদের পাঠানো পরিমাণের সঙ্গে যোগ হয়, চেকআউটে দেখানো হয় এবং কখনো 5 US$-এর বেশি হয় না। সোয়াপের রেটে 1% সার্ভিস মার্জিন অন্তর্ভুক্ত। সব খরচ এক টেবিলে আছে মূল্য পেজে।

এখানে Crypto Merchant যা করে না

কোনো শপ প্লাগইন নেই। কোনো WooCommerce, Shopify, Magento, PrestaShop বা OpenCart মডিউল নেই। API কল আপনি নিজে যোগ করেন, অথবা আপনার চেকআউট পেজ ও পেমেন্ট লিংক শেয়ার করেন।
কোনো স্বয়ংক্রিয় রিফান্ড নেই, API-তেও কোনো রিফান্ড কল নেই। কনফার্ম হওয়া ক্রিপ্টো পেমেন্ট চূড়ান্ত, তাই রিফান্ড মানে একটি নতুন ট্রান্সফার। পণ্য ফেরতের ক্ষেত্রে একজন অ্যাডমিন পোর্টালে পরিশোধিত পেমেন্ট থেকে একটি প্রাইভেট রিফান্ড লিংক তৈরি করেন; গ্রাহক নিজের ঠিকানা লেখেন, নেটওয়ার্ক ফি রিফান্ড থেকে কাটা হয় এবং 1% ফি ফেরত দেওয়া হয় না।
কাস্টোডিয়াল, শুধু ক্রিপ্টো। আপনি পেআউট করা পর্যন্ত Crypto Merchant কি ধরে রাখে, এবং পেআউট যায় আপনার নিজস্ব ওয়ালেট ঠিকানায়, কোনো ব্যাংক অ্যাকাউন্টে নয়।

এটি কাদের জন্য?

যে স্টোরগুলো ইতিমধ্যে নিজের চেকআউট চালায় এবং একটি API কল ও একটি ওয়েবহুক যোগ করতে পারে।
যে স্টোরগুলো এমন দেশের গ্রাহকদের কাছে বিক্রি করে যেখানে কার্ড পাওয়া কঠিন বা চার্জব্যাক ক্ষতি করে।
যে স্টোরগুলো ডলারে দাম রাখে এবং USDT বা USDC-তে সেটেল করতে চায়।

সাধারণ জিজ্ঞাসা

Crypto Merchant-এর জন্য কি WooCommerce বা Shopify প্লাগইন আছে?

না। ইন্টিগ্রেশন হলো একটি API কল যা ইনভয়েস তৈরি করে এবং একটি ওয়েবহুক এন্ডপয়েন্ট যা পরিশোধ হলে জানে। প্লাগইন অপরিহার্য হলে, বিকল্প পেজে প্লাগইন থাকা গেটওয়েগুলোর তালিকা আছে।

ক্রিপ্টো পেমেন্ট কনফার্ম হতে কত সময় লাগে?

এটি নেটওয়ার্কের ওপর নির্ভর করে। প্রতিটি নেটওয়ার্কের একটি নির্দিষ্ট সংখ্যক কনফার্মেশন আছে, যা কয়েন ও নেটওয়ার্ক পেজে তালিকাভুক্ত। Tron, Solana, BNB Smart Chain, Polygon, Base ও Arbitrum-এ স্টেবলকয়েন সাধারণত কয়েক মিনিটের মধ্যে কনফার্ম হয়; Bitcoin-এ 2 কনফার্মেশন লাগে, সাধারণত প্রায় 20 মিনিট।

গ্রাহক ভুল পরিমাণ পেমেন্ট করলে কী হয়?

আপনার ছাড়ের সীমার মধ্যে ঘাটতি পরিশোধিত বলে গণ্য হয়। তার বেশি ঘাটতিতে ইনভয়েস কম পেমেন্টের হয়ে যায়, এবং গ্রাহক ইনভয়েস পেজ থেকে বাকিটা পাঠাতে বা যা পাঠিয়েছেন তা ফেরত নিতে পারেন। বেশি পেমেন্টও পরিশোধিত বলে গণ্য হয়, আর অতিরিক্তটা গ্রাহকের তুলে নেওয়ার জন্য রাখা থাকে।

গ্রাহকের কি Crypto Merchant অ্যাকাউন্ট লাগে?

না। গ্রাহকের শুধু এমন একটি ওয়ালেট লাগে যেখানে তিনি যে কয়েনে পেমেন্ট করতে চান সেটি আছে। তিনি ইনভয়েস পেজ খোলেন, কয়েন বেছে নেন এবং দেখানো পরিমাণটি পাঠান।

আমি কি ইউরো বা অন্য মুদ্রায় অর্ডারের দাম রাখতে পারি?

হ্যাঁ। ইনভয়েস ডিফল্টে মার্কিন ডলারে দাম ধরা হয়, এবং মুদ্রার ফিল্ডে EUR, GBP, TRY বা BRL-এর মতো অন্য সমর্থিত মুদ্রা দেওয়া যায়। গ্রাহক কয়েন বেছে নেওয়ার সময় লাইভ দাম থেকে কয়েনের পরিমাণ হিসাব করা হয়।

অন্য ব্যবহারের ক্ষেত্র

সব ব্যবহারের ক্ষেত্র

আজই ক্রিপ্টো পেমেন্ট নেওয়া শুরু করুন

ফ্রি সেটআপ, সাইন আপে কোনো নথি লাগে না, প্রতিটি পরিশোধিত ইনভয়েসে 1%, আর যখন খুশি পেআউট।

আপনার অ্যাকাউন্ট তৈরি করুন ডকুমেন্টেশন পড়ুন