TypeScript SDK

npm install @sohopay/sdk

import { SohoPay } from "@sohopay/sdk";

const sohopay = new SohoPay({
  apiKey: process.env.SOHOPAY_API_KEY, // sk_test_... or sk_live_...
  environment: "sandbox", // "sandbox" (default) | "mainnet"
});

import { SohoPay } from "@sohopay/sdk";

const sohopay = new SohoPay({ apiKey: process.env.SOHOPAY_API_KEY });

// 1. Create an agent with a credit line
const agent = await sohopay.agents.create({
  merchantId: "mch_sandbox_demo",
  name: "my-first-agent",
  creditLimit: "50.00",
  dailyLimit: "10.00",
  operatorAcknowledgment: true,
});

// 2. Create an order (expires after 10 minutes)
const order = await sohopay.orders.create({
  merchantId: "mch_sandbox_demo",
  agentId: agent.agentId,
  amount: "1.00",
});

// 3. Submit the payment (sandbox auto-signs)
const payment = await sohopay.payments.submit({
  orderId: order.orderId,
  agentId: agent.agentId,
  signature: "sandbox_auto",
});

console.log(payment.paymentId, payment.status);

import express from "express";

const app = express();
app.post("/webhooks/sohopay", express.raw({ type: "application/json" }), (req, res) => {
  const event = sohopay.webhooks.verify({
    payload: req.body,
    signature: req.header("Sohopay-Signature"),
    timestamp: req.header("Sohopay-Timestamp"),
    secret: process.env.SOHOPAY_WEBHOOK_SECRET,
  });

  if (event.type === "payment.settled") {
    console.log("Settled:", event.data.paymentId, event.data.settlementTx);
  }
  res.sendStatus(200); // respond fast; do heavy work async
});

import { SohoPay, SohoPayError } from "@sohopay/sdk";

try {
  await sohopay.payments.submit({ orderId, agentId, signature });
} catch (err) {
  if (err instanceof SohoPayError) {
    switch (err.code) {
      case "INSUFFICIENT_CREDIT":
        // 402 — top up vault collateral or lower the order amount
        break;
      case "ORDER_EXPIRED":
        // 400 — orders live 10 minutes; recreate and resubmit
        break;
      default:
        console.error(err.status, err.code, err.requestId);
    }
  } else {
    throw err;
  }
}