Bolt.new AI and Adyen integration: Step-by-Step Guide 2025

You integrate Bolt.new with Adyen the same way you integrate any full‑stack app with Adyen: you write server-side code (Node.js inside the Bolt.new workspace) that talks to Adyen’s REST API using Adyen’s official Node SDK, store the API credentials as environment variables, and expose endpoints your frontend can call to create payment sessions or handle webhooks. Bolt.new doesn’t have a special Adyen integration button — you build it just like a normal full‑stack integration inside its sandbox environment.

 

What Integration Actually Means Here

 

Inside Bolt.new, you can spin up a simple Node/Express backend and a browser-based frontend. The backend will:

• Use your Adyen API Key or Client Key stored as environment variables.
• Call Adyen’s Checkout API via their official Node SDK.
• Expose a route like /api/create-payment that your frontend calls.
• Receive webhooks from Adyen inside the Bolt sandbox (if the sandbox URL is publicly reachable).

This is exactly how any real integration works outside Bolt.new too; Bolt just gives you a browser workspace to develop and test it.

 

Step-by-Step: Integrating Adyen in Bolt.new

 

The steps below assume you’re using the Bolt.new default Node/Express workspace.

• Create environment variables inside Bolt.new’s environment panel:

  <ul>
    <li>ADYEN_API_KEY</li>
    <li>ADYEN_MERCHANT_ACCOUNT</li>
    <li>ADYEN_CLIENT_KEY</li>
  </ul>
  

• Install the official Adyen Node.js SDK (real package, real name):

npm install @adyen/api-library

• Set up a backend route to create a payment session using Adyen’s Checkout API.

// server.js (or your express server file)

import express from "express";
import { Client, CheckoutAPI } from "@adyen/api-library";

const app = express();
app.use(express.json());

// Adyen client setup
const client = new Client({
  apiKey: process.env.ADYEN_API_KEY,    // stored in Bolt env vars
  environment: "TEST"                   // or "LIVE"
});

const checkout = new CheckoutAPI(client);

// Create payments endpoint
app.post("/api/create-payment", async (req, res) => {
  try {
    const response = await checkout.payments({
      amount: { currency: "EUR", value: 1000 },   // €10.00
      merchantAccount: process.env.ADYEN_MERCHANT_ACCOUNT,
      reference: "bolt-payment-test",
      returnUrl: "https://your-bolt-url/return"   // your workspace URL
    });

    res.json(response);
  } catch (err) {
    console.error(err);
    res.status(500).json({ error: "Adyen error" });
  }
});

app.listen(3000, () => console.log("Server running"));

• Call this endpoint from your Bolt.new frontend (React, vanilla JS, etc.) to start a payment.

// frontend example
async function startPayment() {
  const res = await fetch("/api/create-payment", {
    method: "POST",
    headers: { "Content-Type": "application/json" }
  });

  const data = await res.json();
  console.log("Adyen response:", data);
}

• Configure Adyen webhooks (optional but required for real payments):

  <ul>
    <li>In the Adyen Dashboard, add your Bolt.new public URL + <i>/api/webhooks/adyen</i>.</li>
    <li>Verify HMAC signatures (Adyen provides the HMAC key). Bolt.new can receive them as long as the workspace is publicly reachable.</li>
  </ul>
  

// simple webhook receiver
app.post("/api/webhooks/adyen", (req, res) => {
  // verify HMAC here – Adyen docs show the exact method
  console.log("Webhook received:", req.body);
  res.status(200).send("[accepted]");
});

 

The Key Concepts (Explained Simply)

 

• SDK: A pre-built library that knows how to talk to Adyen's API.
• Environment variables: Secure storage for secrets inside Bolt.new so you never hardcode API keys.
• Checkout API: The Adyen endpoint you call to create or handle payments.
• Client Key: Public-facing Adyen key used only in the frontend.
• API Key: Secret key used only on the backend to create payments.
• Webhooks: Messages from Adyen to your server when the payment status changes.

 

Hardening for Production (Outside Bolt)

 

• Move environment variables to your real environment manager (AWS, Vercel, Docker, etc.).
• Lock webhooks with HMAC verification.
• Use HTTPS everywhere.
• Set Adyen environment to LIVE and rotate API keys.

This is the full, correct, real-world way to integrate Bolt.new-based apps with Adyen.