Coinbase Commerce का विकल्प: Crypto Merchant बनाम Coinbase Commerce (2026)

मैं Coinbase Commerce से Crypto Merchant पर कैसे माइग्रेट करूँ?

आपका Commerce इंटीग्रेशन चार्ज बनाता था और वेबहुक पाता था। Crypto Merchant के साथ आप हर ऑर्डर के लिए एक इनवॉइस बनाते हैं, ग्राहक को उसके चेकआउट पेज पर भेजते हैं, और साइन किए गए वेबहुक संभालते हैं। नीचे दिए गए स्टेप हर काम को हमारे API से जोड़ते हैं; हर फ़ील्ड API रेफ़रेंस में है।

किसकी जगह क्या

1. चार्ज की जगह इनवॉइस बनाएँ

पोर्टल में डेवलपर के अंतर्गत एक API की बनाएँ (लाइव की cm_live_ से शुरू होती हैं) और उसे अपने सर्वर पर रखें। आपका अकाउंट पहले लाइव होना चाहिए: जब तक सेटअप पूरा नहीं होता, API merchant_not_live कोड के साथ 403 लौटाता है। फिर, जहाँ भी आपका कोड चार्ज बनाता था, वहाँ इनवॉइस बनाएँ। राशि कम से कम 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_ से शुरू होता है। हर इवेंट CM-Signature हेडर वाला एक POST होता है: t= सेकंड में एक Unix टाइमस्टैम्प, फिर v1= टाइमस्टैम्प, एक डॉट (.) और रॉ बॉडी का hex 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 दिखाता है कि अभी आपके पास क्या है।