💳 Payment Integration with Stripe

This template helps you:

• Set up Stripe in development and production
• Create a product and payment link
• Handle checkout.session.completed events via webhook
• Generate a license or trigger actions after payment

---

📦 1. Install Required Packages

npm install -S stripe express cors body-parser node-fetch

---

🧪 2. Stripe Setup for Development

✅ Step-by-step:

1. Create a Product & Price (Test mode) 👉 Stripe Test Products Copy the test price ID: price_XXXXX
2. Get your Test API Key 👉 Test API Keys Copy the stripe_key: sk_test_XXXXX
3. Install Stripe CLI 👉 Stripe CLI Docs In your terminal:Copy the webhook secret: whsec_XXXXX
4. Create a Payment Link 👉 Create Payment Link Add metadata → key: product, value: (e.g. pro-plan) Use test cards below to simulate success/failure.

---

💳 Test Card Numbers

Card Type	Number	Result
Success	4242 4242 4242 4242	Payment successful
Insufficient Funds	4000 0000 0000 9995	Payment failed

Expiration: any future date, CVC: 000

👉 Manually trigger event if needed:

stripe trigger checkout.session.completed

---

🚀 3. Stripe Setup for Production

1. Get Production API Key 👉 Live API Keys
2. Create Webhook Endpoint 👉 Webhooks
   1. Leave URL blank until deployment (Znote job will provide it)
   2. Add events:
      1. checkout.session.completed
      2. checkout.session.async_payment_succeeded
      3. checkout.session.async_payment_failed
3. Create Product & Payment Link As in development, add metadata.product field.

---

🔐 4. Credentials File

Create stripe-properties.json with your keys:

{
  "stripe_key": "sk_test_XXXXX",
  "stripe_ws_secret": "whsec_XXXXX",
  "url_domain": "http://localhost:4242",
  "product1_price": "price_XXXXX"
}

const credentials = loadBlock('stripe');
_fs.writeFileSync(`${__dirname}/stripe-properties.json`, credentials);

---

🧠 5. Stripe Webhook Backend

//exec: node

const properties = require("./stripe-properties.json");

const fetch = require('node-fetch');
const stripe = require('stripe')(properties.stripe_key);
const express = require('express');
const cors = require('cors');
const bodyParser = require('body-parser');

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

const YOUR_DOMAIN = properties.url_domain;
const endpointSecret = properties.stripe_ws_secret;

app.get('/', (req, res) => res.sendStatus(200));

app.post('/webhook', bodyParser.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['stripe-signature'];
  const payload = req.body;

  let event;
  try {
    event = stripe.webhooks.constructEvent(payload, sig, endpointSecret);
  } catch (err) {
    return res.status(400).send(`Webhook Error: ${err.message}`);
  }

  const session = event.data.object;
  console.log(`📦 Received event: ${event.type}`);

  if (event.type === 'checkout.session.completed') {
    const product = session.metadata.product;
    const email = session.customer_details.email;

    console.log(`✅ Payment success: ${email} bought ${product}`);
    // TODO: Generate license or deliver product here
  }

  res.sendStatus(200);
});

app.listen(4242, () => console.log('🚀 Stripe backend running on http://localhost:4242'));

---

✅ Next steps:

• Export or deploy this job in Znote
• Replace test credentials with live ones in production
• Handle subscriptions or advanced product logic in the switch(event.type)