Lynk API

https://www.lynkinfra.com/api/v1

curl -X POST https://www.lynkinfra.com/api/v1/sms \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": "0241234567", "message": "Hello from my app"}'

Authorization: Bearer <your key>

{ "error": "Insufficient wallet balance" }

{ "error": { "message": "…", "type": "invalid_request_error", "code": "model_not_found" } }

{ "status": false, "message": "…", "code": "VALIDATION_ERROR" }

curl -X POST https://www.lynkinfra.com/api/v1/sms \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": ["0241234567", "0201234567"], "message": "Your order is on its way!", "sender": "MYSHOP"}'

{
  "id": "cm…",
  "status": "SENT",
  "sender": "MYSHOP",
  "recipients": 2,
  "parts": 1,
  "unitsUsed": 2,
  "rejected": 0,
  "invalidNumbers": []
}

curl -X POST https://www.lynkinfra.com/api/v1/email \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": "ama@example.com", "subject": "Your receipt", "body": "Thanks for your order!"}'

{ "id": "cm…", "status": "SENT", "unitsUsed": 1 }

{ "id": "cm…", "status": "SENT", "costCents": 12 }

curl -X POST https://www.lynkinfra.com/api/v1/ai \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Write a short SMS announcing our weekend sale"}'

{
  "id": "cm…",
  "completion": "Weekend sale! 20% off everything…",
  "model": "…",
  "usage": { "inputTokens": 18, "outputTokens": 42 },
  "charged": { "amountCents": 1 },
  "privacy": { "protectedCount": 0 }
}

import OpenAI from "openai";

const lynk = new OpenAI({ apiKey: process.env.LYNK_API_KEY, baseURL: "https://www.lynkinfra.com/api/v1" });

const reply = await lynk.chat.completions.create({
  model: "lynk-auto",
  messages: [
    { role: "system", content: "You write friendly SMS for a bakery." },
    { role: "user", content: "Announce fresh bread at 7am." },
  ],
});
console.log(reply.choices[0].message.content);

from openai import OpenAI

lynk = OpenAI(api_key="lynk_your_key", base_url="https://www.lynkinfra.com/api/v1")
reply = lynk.chat.completions.create(
    model="lynk-auto",
    messages=[{"role": "user", "content": "Announce fresh bread at 7am."}],
)
print(reply.choices[0].message.content)

curl -X POST https://www.lynkinfra.com/api/v1/images/generations \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A bright photo of fresh bread on a wooden table", "size": "1024x1024"}'

{
  "created": 1790000000,
  "data": [{ "b64_json": "iVBORw0KGgo…" }],
  "output_format": "png",
  "lynk": { "image_id": "cm…", "charged_cents": 5 }
}

curl -X POST https://www.lynkinfra.com/api/v1/pay/payments \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042" \
  -d '{
    "amount": 10000,
    "channel": "MOBILE_MONEY",
    "email": "customer@example.com",
    "fee_bearer": "customer",
    "callback_url": "https://yourshop.com/orders/1042/paid"
  }'

{
  "status": true,
  "message": "Payment initialized",
  "data": {
    "reference": "LNK-3F9A1C2B7D4E",
    "authorization_url": "https://…",
    "amount": 10304,
    "fee": 304,
    "net_amount": 10000,
    "fee_bearer": "customer"
  }
}

curl https://www.lynkinfra.com/api/v1/pay/payments/LNK-3F9A1C2B7D4E \
  -H "Authorization: Bearer sk_live_your_key"

{
  "status": "success",
  "reference": "LNK-3F9A1C2B7D4E",
  "amount": 10304,
  "fee": 304,
  "net_amount": 10000,
  "fee_bearer": "customer",
  "currency": "GHS",
  "refunded_amount": 0,
  "refundable_amount": 10000
}

curl -X POST https://www.lynkinfra.com/api/v1/pay/payments/LNK-3F9A1C2B7D4E/refund \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"amount": 5000, "reason": "Booking cancelled"}'

{
  "status": true,
  "message": "Refund started",
  "data": { "id": "cm…", "reference": "LNK-3F9A1C2B7D4E", "amount": 5000, "currency": "GHS", "status": "pending" }
}

{
  "event": "payment.success",
  "data": {
    "reference": "LNK-3F9A1C2B7D4E",
    "amount": 10304,
    "fee": 304,
    "net_amount": 10000,
    "fee_bearer": "customer",
    "currency": "GHS",
    "status": "success",
    "customer": { "email": "customer@example.com" }
  }
}

import crypto from "node:crypto";
import express from "express";

const app = express();
const seen = new Set(); // use your database in production

app.post("/webhooks/lynk", express.raw({ type: "application/json" }), (req, res) => {
  const expected = crypto.createHmac("sha256", process.env.LYNK_WEBHOOK_SECRET).update(req.body).digest("hex");
  const given = req.get("X-Lynk-Signature") ?? "";
  if (given.length !== expected.length || !crypto.timingSafeEqual(Buffer.from(given), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const delivery = req.get("X-Lynk-Delivery");
  if (!seen.has(delivery)) {
    seen.add(delivery);
    const { event, data } = JSON.parse(req.body.toString());
    if (event === "payment.success") {
      // Mark the order with data.reference as paid.
    }
  }
  res.sendStatus(200);
});

<?php
$body = file_get_contents("php://input");
$expected = hash_hmac("sha256", $body, getenv("LYNK_WEBHOOK_SECRET"));
if (!hash_equals($expected, $_SERVER["HTTP_X_LYNK_SIGNATURE"] ?? "")) {
  http_response_code(401);
  exit;
}
$payload = json_decode($body, true);
if ($payload["event"] === "payment.success") {
  // Mark the order with $payload["data"]["reference"] as paid.
}
http_response_code(200);

curl -X POST https://www.lynkinfra.com/api/v1/products/imports \
  -H "Authorization: Bearer lynk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"user": {"id": "tenant-42", "name": "Glow Mart"}, "screen": true, "variants": true,
       "details": [{"key": "name", "label": "Product Name", "required": true},
                   {"key": "sellingPrice", "label": "Selling Price", "kind": "money"},
                   {"key": "costPrice", "label": "Cost Price", "kind": "money"},
                   {"key": "quantityOnHand", "label": "Stock", "kind": "number"},
                   {"key": "categoryName", "label": "Category"}],
       "lists": {"categories": ["Drinks", "Provisions"], "shops": [{"id": "s1", "name": "Osu"}]}}'

{
  "id": "cm…", "status": "waiting",
  "screen_url": "https://www.lynkinfra.com/import/…", "screen_expires_at": "…",
  "user": { "id": "tenant-42", "credit_cents": 2000 },
  "message": "Send me your products: a spreadsheet, a PDF price list…",
  "questions": [], "products": [], "cost_cents": 0, "currency": "GHS"
}

{
  "event": "import.finished",
  "import_id": "cm…", "user": { "id": "tenant-42" }, "shop_id": "s1",
  "products": [
    { "row": "r1", "action": "add", "values": { "name": "Polo shirt", "sellingPrice": 50, "quantityOnHand": 5 },
      "choices": [ { "attributes": { "colour": "Red", "size": "XL" }, "values": { "sellingPrice": 50, "quantityOnHand": 3 } },
                   { "attributes": { "colour": "Blue", "size": "M" }, "values": { "sellingPrice": 50, "quantityOnHand": 2 } } ] }
  ],
  "left_out": [ { "row": "r7", "name": "Sugar 1kg", "why": "Already in your products" } ],
  "cost_cents": 110, "currency": "GHS"
}