Bridge Your Business to Africa's Pulse

import requests
from uuid import uuid4

url = "https://pay.spotnet.co.ke/api/v1/payment-requests"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": str(uuid4()),
    "Content-Type": "application/json",
    "Accept": "application/json",
}

payload = {
    "type": "stk_push",
    "amount": "1250",
    "currency": "KES",
    "phone": "+2547XXXXXXXX",
    "reference": "INV-2026-0001",
    "description": "Payment for services",
    "callback_url": "https://yourapp.com/callback-link",
    "meta": {
        "order_id": "ord_456",
        "customer_id": "cust_123",
    },
}

response = requests.post(
    url,
    json=payload,
    headers=headers,
    timeout=30,
)

print(response.status_code)
print(response.json())

const axios = require('axios');
const { v4: uuidv4 } = require('uuid');

const url = 'https://pay.spotnet.co.ke/api/v1/payment-requests';

const headers = {
  Authorization: 'Bearer YOUR_API_KEY',
  'Idempotency-Key': uuidv4(),
  'Content-Type': 'application/json',
  Accept: 'application/json',
};

const payload = {
  type: 'stk_push',
  amount: '1250',
  currency: 'KES',
  phone: '+2547XXXXXXXX',
  reference: 'INV-2026-0001',
  description: 'Payment for services',
  callback_url: 'https://yourapp.com/callback-link',
  meta: {
    order_id: 'ord_456',
    customer_id: 'cust_123',
  },
};

async function createPayment() {
  try {
    const response = await axios.post(
      url,
      payload,
      { headers, timeout: 30000 }
    );

    console.log(response.status);
    console.log(response.data);
  } catch (error) {
    console.error(error.response?.data || error.message);
  }
}

createPayment();

<?php

$url = 'https://pay.spotnet.co.ke/api/v1/payment-requests';

$payload = [
    'type' => 'stk_push',
    'amount' => '1250',
    'currency' => 'KES',
    'phone' => '+2547XXXXXXXX',
    'reference' => 'INV-2026-0001',
    'description' => 'Payment for services',
    'callback_url' => 'https://yourapp.com/callback-link',
    'meta' => [
        'order_id' => 'ord_456',
        'customer_id' => 'cust_123',
    ],
];

$headers = [
    'Authorization: Bearer YOUR_API_KEY',
    'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    'Content-Type: application/json',
    'Accept: application/json',
];

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);

$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
}

curl_close($ch);

echo 'HTTP ' . $status . PHP_EOL;
echo $response;