This migration guide helps you replace CryptoMus's volume-discount fee model and form-style API with Payvra's flat 0.5% fee and a typed REST contract.

1// CryptoMus
2const body = {
3  amount: "49.99",
4  currency: "USD",
5  order_id: "order_123",
6  url_callback: "https://yoursite.com/webhooks/cryptomus",
7};
8
9const sign = crypto
10  .createHash("md5")
11  .update(Buffer.from(JSON.stringify(body)).toString("base64") + API_KEY)
12  .digest("hex");
13
14const response = await fetch("https://api.cryptomus.com/v1/payment", {
15  method: "POST",
16  headers: {
17    merchant: MERCHANT_ID,
18    sign,
19    "Content-Type": "application/json",
20  },
21  body: JSON.stringify(body),
22});
23
24const { result } = await response.json();
25// Redirect to: result.url

1// Payvra
2import Payvra from "payvra";
3
4const payvraSecretKey = process.env.PAYVRA_SECRET_KEY;
5if (!payvraSecretKey) {
6  throw new Error("Set PAYVRA_SECRET_KEY before running this example.");
7}
8
9const payvra = new Payvra(payvraSecretKey);
10
11const payment = await payvra.payments.create({
12  amount: "49.99",
13  currency: "USDC",
14  metadata: { orderId: "order_123" },
15});
16
17// Redirect to: payment.checkoutUrl

1// CryptoMus webhook handler
2app.post("/webhooks/cryptomus", (req, res) => {
3  const { sign, ...payload } = req.body;
4  const expected = crypto
5    .createHash("md5")
6    .update(Buffer.from(JSON.stringify(payload)).toString("base64") + API_KEY)
7    .digest("hex");
8
9  if (sign !== expected) {
10    return res.status(401).send("Invalid");
11  }
12
13  if (payload.status === "paid") {
14    // Mark order paid, payload.order_id
15  }
16
17  res.sendStatus(200);
18});

1// Payvra webhook handler
2app.post("/webhooks", (req, res) => {
3  const signature = req.headers["webhook-signature"];
4  const timestamp = req.headers["webhook-timestamp"];
5  const webhookId = req.headers["webhook-id"];
6
7  const signedContent = `${webhookId}.${timestamp}.${req.rawBody}`;
8  const expected = crypto
9    .createHmac("sha256", WEBHOOK_SECRET)
10    .update(signedContent)
11    .digest("base64");
12
13  if (signature !== `v1,${expected}`) {
14    return res.status(401).send("Invalid");
15  }
16
17  const { type, data } = req.body;
18  if (type === "payment.completed") {
19    // Mark order paid, data.metadata.orderId
20  }
21
22  res.sendStatus(200);
23});