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);