This migration guide should turn BitPay's invoice-era contract into a simpler payment flow before you move live volume.

1// BitPay
2const bitpay = new BitPaySDK.Client(
3  "YOUR_CONFIG_PATH",
4  BitPaySDK.Env.Prod
5);
6
7const invoice = await bitpay.CreateInvoice(
8  new BitPaySDK.Models.Invoice(49.99, "USD")
9);
10invoice.setNotificationURL("https://yoursite.com/webhooks");
11invoice.setOrderId("order_123");
12invoice.setRedirectURL("https://yoursite.com/success");
13
14const result = await bitpay.createInvoice(invoice);
15// 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  chain: "solana",
15  metadata: { orderId: "order_123" },
16});
17
18// Redirect to: payment.checkoutUrl

1// BitPay webhook verification
2app.post("/webhooks", (req, res) => {
3  // BitPay does not sign webhooks by default.
4  const isValid = bitpay.verifyNotification(req.body);
5
6  if (!isValid) {
7    return res.status(401).send("Invalid");
8  }
9
10  const { event } = req.body;
11  if (event.name === "invoice_confirmed") {
12    // Mark order paid
13  }
14
15  res.sendStatus(200);
16});

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});