SMOO Pay API

Authorization: Bearer sk_live_xxxxx

curl https://smoopay.app/api/v1/charges \
  -H "Authorization: Bearer sk_live_your_api_key_here"

{
  "event": "charge.completed",
  "data": {
    "id": "cLr8x3kWpN2mYvBq",
    "status": "COMPLETED",
    "amount": 150.00,
    "currency": "MZN",
    "provider": "MPESA",
    "transaction_id": "tx_7f3a9c1e",
    "metadata": { "user_id": "abc123" }
  },
  "timestamp": "2025-06-15T10:30:05.000Z"
}

const crypto = require("crypto");

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Express example
app.post("/webhooks/smoo", express.raw({ type: "application/json" }), (req, res) => {
  const signature = req.headers["x-smoo-signature"];
  if (!verifyWebhook(req.body, signature, process.env.SMOO_WEBHOOK_SECRET)) {
    return res.status(401).send("Invalid signature");
  }

  const { event, data } = JSON.parse(req.body);

  switch (event) {
    case "charge.completed":
      // Fulfil the order
      console.log("Payment completed:", data.id);
      break;
    case "charge.failed":
      // Notify your customer
      console.log("Payment failed:", data.id, data.failure_reason);
      break;
  }

  res.status(200).send("OK");
});

<!-- On the page that links to your SMOO checkout -->
<script>
  (function () {
    var src = new URLSearchParams(window.location.search);
    var keep = ["utm_source","utm_medium","utm_campaign","utm_content","utm_term","fbclid","gclid"];
    document.querySelectorAll('a[href*="smoopay.app"]').forEach(function (a) {
      try {
        var u = new URL(a.href);
        keep.forEach(function (k) {
          var v = src.get(k);
          if (v && !u.searchParams.get(k)) u.searchParams.set(k, v);
        });
        a.href = u.toString();
      } catch (_) {}
    });
  })();
</script>

function goToCheckout(slug) {
  var dest = new URL("https://smoopay.app/pay/" + slug);
  var src = new URLSearchParams(window.location.search);
  ["utm_source","utm_medium","utm_campaign","utm_content","utm_term","fbclid","gclid"]
    .forEach(function (k) {
      var v = src.get(k);
      if (v) dest.searchParams.set(k, v);
    });
  window.location = dest.toString();
}

Facebook / Instagram:
https://smoopay.app/pay/SEVEN?utm_source=facebook&utm_medium=paid&utm_campaign=summer-2026

Google Ads:
https://smoopay.app/pay/SEVEN?utm_source=google&utm_medium=cpc&utm_campaign=brand

Email / WhatsApp:
https://smoopay.app/pay/SEVEN?utm_source=email&utm_medium=newsletter&utm_campaign=launch

{
  "error": "amount is required and must be a positive number"
}

const SMOO_API_KEY = "sk_live_your_api_key";
const BASE_URL = "https://smoopay.app/api/v1";

// Create a direct M-Pesa charge
async function createDirectCharge() {
  const res = await fetch(BASE_URL + "/charges", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + SMOO_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: 350.0,
      title: "Monthly subscription",
      customer_phone: "851234567",
      provider: "MPESA",
      callback_url: "https://your-server.com/webhooks/smoo",
      metadata: { customer_id: "cust_42" },
    }),
  });
  return res.json();
}

// Create a checkout URL (customer picks provider)
async function createCheckout() {
  const res = await fetch(BASE_URL + "/charges", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + SMOO_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: 1200.0,
      title: "E-commerce order #1042",
      redirect_url: "https://your-store.com/order/1042/thank-you",
      callback_url: "https://your-server.com/webhooks/smoo",
    }),
  });
  const charge = await res.json();
  // Redirect your customer to charge.checkout_url
  return charge;
}

// Get charge details
async function getCharge(chargeId) {
  const res = await fetch(BASE_URL + "/charges/" + chargeId, {
    headers: { Authorization: "Bearer " + SMOO_API_KEY },
  });
  return res.json();
}

// List completed charges
async function listCompletedCharges() {
  const res = await fetch(BASE_URL + "/charges?status=COMPLETED&limit=20", {
    headers: { Authorization: "Bearer " + SMOO_API_KEY },
  });
  return res.json();
}

// Cancel a pending charge
async function cancelCharge(chargeId) {
  const res = await fetch(BASE_URL + "/charges/" + chargeId + "/cancel", {
    method: "POST",
    headers: { Authorization: "Bearer " + SMOO_API_KEY },
  });
  return res.json();
}