Coinbase Commerce-এর বিকল্প: Crypto Merchant বনাম Coinbase Commerce (2026)

কীভাবে Coinbase Commerce থেকে Crypto Merchant-এ মাইগ্রেট করব?

আপনার Commerce ইন্টিগ্রেশন চার্জ তৈরি করত এবং ওয়েবহুক পেত। Crypto Merchant-এ আপনি প্রতিটি অর্ডারের জন্য একটি ইনভয়েস তৈরি করেন, গ্রাহককে তার চেকআউট পেজে পাঠান, এবং সাইন করা ওয়েবহুক সামলান। নিচের ধাপগুলোতে প্রতিটি কাজকে আমাদের API-র সাথে মিলিয়ে দেখানো হয়েছে; প্রতিটি ফিল্ড আছে API রেফারেন্সে।

কোনটির বদলে কী

1. চার্জের বদলে একটি ইনভয়েস তৈরি করুন

পোর্টালে ডেভেলপার অংশে একটি API কি তৈরি করুন (লাইভ কি শুরু হয় cm_live_ দিয়ে) এবং সেটি আপনার সার্ভারে রাখুন। আগে আপনার অ্যাকাউন্ট লাইভ হতে হবে: সেটআপ শেষ না হওয়া পর্যন্ত API 403 ফেরত দেয়, সাথে কোড merchant_not_live। তারপর আপনার কোড যেখানে চার্জ তৈরি করত, সেখানে একটি ইনভয়েস তৈরি করুন। পরিমাণের মূল্য অন্তত 0.50 মার্কিন ডলার হতে হবে।

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "49.90",
    "currency": "USD",
    "order_id": "1042",
    "redirect_url": "https://yourstore.example/orders/1042",
    "metadata": { "cart_id": "c_8812" }
  }'

{
  "id": "inv_…",
  "object": "invoice",
  "status": "open",
  "amount": "49.9",
  "currency": "USD",
  "amount_usd": "49.9",
  "order_id": "1042",
  "metadata": { "cart_id": "c_8812" },
  "coin": null,
  "pay_address": null,
  "pay_amount": null,
  "checkout_url": "https://cryptomerchant.online/pay/i/inv_…",
  "redirect_url": "https://yourstore.example/orders/1042",
  "expires_at": "2026-10-30T10:30:00.000Z",
  …
}

201 স্ট্যাটাসসহ রেসপন্সটিই ইনভয়েস অবজেক্ট। এর id আপনার অর্ডারের সাথে সেভ করুন। এর স্ট্যাটাস শুরু হয় open হিসেবে।

2. গ্রাহকদের চেকআউট URL-এ পাঠান

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

Commerce চলত Ethereum, Polygon ও Base-এ, আর Crypto Merchant তিনটিতেই USDC নেয়। কয়েন বেছে নেওয়ার ধাপ বাদ দিতে coin পাঠান, যেমন USDC.BASE: তখন pay_address ও pay_amount পূরণ করা অবস্থায় ফেরত আসে, তাই পেমেন্টের বিবরণ আপনি নিজেই দেখাতে পারেন।

// orders: your own data layer
app.post("/orders/:id/pay", async (req, res) => {
  const order = await orders.find(req.params.id);

  const r = await fetch("https://cryptomerchant.online/api/v1/invoices", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.CM_SECRET_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: order.total, // for example "49.90"
      currency: "USD",
      order_id: order.id,
      redirect_url: `https://yourstore.example/orders/${order.id}`,
    }),
  });
  if (!r.ok) {
    const { error } = await r.json();
    throw new Error(`${error.code}: ${error.message}`);
  }

  const invoice = await r.json();
  await orders.update(order.id, { invoiceId: invoice.id });
  res.redirect(303, invoice.checkout_url);
});

3. ওয়েবহুক সিগনেচার যাচাই করুন

ডেভেলপার অংশে আপনার এন্ডপয়েন্টের HTTPS ঠিকানা যোগ করুন। প্রতিটি এন্ডপয়েন্ট নিজস্ব সাইনিং সিক্রেট পায়, যা শুরু হয় whsec_ দিয়ে। প্রতিটি ইভেন্ট একটি POST, যাতে একটি CM-Signature হেডার থাকে: t= সেকেন্ডে একটি Unix টাইমস্ট্যাম্প, তারপর v1= টাইমস্ট্যাম্প, একটি ফুল স্টপ (.) ও র বডির হেক্স HMAC-SHA256, যা আপনার এন্ডপয়েন্ট সিক্রেটকে কি হিসেবে ব্যবহার করে তৈরি।

JSON পার্স করার আগে র বডির ওপর এটি হিসাব করুন, কনস্ট্যান্ট টাইমে তুলনা করুন, এবং পাঁচ মিনিটের বেশি পুরোনো টাইমস্ট্যাম্প প্রত্যাখ্যান করুন। 10 সেকেন্ডের মধ্যে একটি 2xx স্ট্যাটাস দিয়ে উত্তর দিন; অন্য যেকোনো উত্তর হলে প্রায় দুই দিন ধরে আটবার পর্যন্ত পুনরায় চেষ্টা করা হয়।

import crypto from "node:crypto";
import express from "express";

// CM-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(
    String(header ?? "").split(",").map((p) => p.trim().split("=")),
  );
  if (!parts.t || !parts.v1) return false;
  const expected = crypto
    .createHmac("sha256", secret) // your endpoint secret, whsec_…
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) return false;
  return Math.abs(Date.now() / 1000 - Number(parts.t)) <= 300; // 5 minutes
}

const app = express();

// db, tx.webhookEvents, tx.orders: your own data layer
app.post(
  "/webhooks/crypto-merchant",
  express.raw({ type: "application/json" }), // keep the raw body for the signature
  async (req, res) => {
    const raw = req.body.toString("utf8");
    if (!verify(raw, req.get("CM-Signature"), process.env.CM_WEBHOOK_SECRET)) {
      return res.sendStatus(400);
    }
    const event = JSON.parse(raw);
    const invoice = event.data;

    try {
      await db.transaction(async (tx) => {
        // A unique key on the event id: a repeated delivery is skipped.
        const isNew = await tx.webhookEvents.insertIfAbsent(event.id);
        if (!isNew) return;

        if (event.type === "invoice.paid") {
          await tx.orders.markPaid(invoice.order_id, invoice.id); // one-way: never moves back
        } else if (event.type === "invoice.expired" || event.type === "invoice.cancelled") {
          await tx.orders.cancelIfUnpaid(invoice.order_id);
        }
      });
    } catch {
      return res.sendStatus(500); // not 2xx: Crypto Merchant tries again later
    }
    res.sendStatus(200); // within 10 seconds
  },
);

4. পেমেন্ট স্ট্যাটাস মিলিয়ে নিন

শুধু invoice.paid পেলে অর্ডার পূরণ করুন, এবং বাকি স্ট্যাটাসগুলো নিচের মতো আপনার অর্ডার সিস্টেমের সাথে মিলিয়ে নিন। গ্রাহক একই ঠিকানায় বাকিটা পাঠালে একটি কম পেমেন্টের ইনভয়েসও পরিশোধিত হতে পারে।

5. ডুপ্লিকেট ও ক্রমের বাইরে আসা ওয়েবহুক সামলান

ইভেন্ট একাধিকবার আসতে পারে, এবং সবসময় ক্রম অনুযায়ী নয়। প্রতিটি ইভেন্টের id (যা CM-Event-Id হেডারেও পাঠানো হয়) একটি ইউনিক কি-এর অধীনে সংরক্ষণ করুন, অর্ডার আপডেটের একই ডেটাবেস ট্রানজ্যাকশনে, এবং আগে সংরক্ষণ করা ইভেন্টগুলো এড়িয়ে যান। স্ট্যাটাস পরিবর্তন একমুখী রাখুন, যাতে দেরিতে আসা একটি invoice.confirming কখনো একটি পরিশোধিত অর্ডারকে আগের অবস্থায় ফিরিয়ে না দেয়। মূল্যবান কিছু পাঠানোর আগে, স্ট্যাটাস আবার নিশ্চিত হতে API থেকে ইনভয়েসটি আনুন।

6. হিসাব মেলান

একবারে 100টি করে পরিশোধিত ইনভয়েসের তালিকা নিন, has_more true থাকা পর্যন্ত starting_after অনুসরণ করে, এবং প্রতিটিকে order_id বা metadata দিয়ে একটি অর্ডারের সাথে মেলান।

// Every paid invoice, newest first. Match each one to an order by order_id.
async function paidInvoices() {
  const all = [];
  let after = null;
  do {
    const url = new URL("https://cryptomerchant.online/api/v1/invoices");
    url.searchParams.set("status", "paid");
    url.searchParams.set("limit", "100");
    if (after) url.searchParams.set("starting_after", after);

    const r = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.CM_SECRET_KEY}` },
    });
    const page = await r.json();
    all.push(...page.data);
    after = page.has_more ? page.data[page.data.length - 1].id : null;
  } while (after);
  return all;
}

আপনার ব্যালেন্সে জমা হয় ইনভয়েসের পরিমাণ (অথবা আপনার ছাড়ের সীমার মধ্যে কম পেমেন্ট গ্রহণ করা হলে, সামান্য কম যে পরিমাণ এসেছে) থেকে 1% ফি বাদ দিয়ে, যে কয়েনে পেমেন্ট হয়েছে সেই কয়েনে। অতিরিক্ত পেমেন্ট আপনার কাছে জমা হয় না: Crypto Merchant অতিরিক্ত অংশটি গ্রাহকের জন্য রেখে দেয়, এবং গ্রাহক ইনভয়েস পেজ থেকে তা তুলে নিতে পারেন। পোর্টালের রিপোর্ট পেজ যেকোনো সময়কালের গ্রস, ফি ও নেট CSV হিসেবে দেয়, এবং GET /balances দেখায় আপনার কাছে এখন কী আছে।