LakiPay Integration Overview

Simple, Developer-Friendly Payment Integration

LakiPay empowers businesses to accept digital payments securely via a simple, developer-friendly API. Connect payments, track transactions, and manage checkout events—all in one place.

LakiPay Payment Flow

Understand every stage of the payment process, from creation to webhook notifications.

Create Payment

Backend sends POST /api/v2/payment/direct

Customer Receives Request

Customer gets payment prompt on their device (e.g. mobile)

Payment Status

Transaction moves to SUCCESS, FAILED, PENDING, or CANCELLED

Receive Webhook

LakiPay sends DEPOSIT or WITHDRAWAL events with status

Create Payment

Backend sends POST /api/v2/payment/direct

Customer Receives Request

Customer gets payment prompt on their device (e.g. mobile)

Payment Status

Transaction moves to SUCCESS, FAILED, PENDING, or CANCELLED

Receive Webhook

LakiPay sends DEPOSIT or WITHDRAWAL events with status

Create Payment

Start with a simple API request

Initiate a payment by sending a POST request to the API endpoint. The payment remains active for 15 minutes, giving customers enough time to complete their transaction.

Endpoint

POST /api/v2/payment/direct

API RequestExample

// Create a direct payment (docs: Direct Payments API)
POST https://api.lakipay.co/api/v2/payment/direct
X-API-Key: your-publickey:your-secretkey
Content-Type: application/json

{
  "amount": 100.00,
  "currency": "ETB",
  "phone_number": "251911234567",
  "medium": "MPESA",
  "description": "Order #12345",
  "reference": "ORDER-12345",
  "callback_url": "https://yoursite.com/webhook"
}

// Response
{
  "status": "SUCCESS",
  "message": "Payment initiated successfully",
  "data": {
    "transaction_id": "TXN-123456789",
    "reference": "ORDER-12345",
    "amount": 100.00,
    "currency": "ETB",
    "status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Handling Expired Payments

Set up a webhook listener to detect and respond to expired payments

When a payment expires, LakiPay sends a webhook notification to your server. Handle these events to notify customers or restart payments.

Webhook HandlerNode.js

// Verify RSA-2048 signature first (see docs/webhooks)
app.post('/webhooks/lakipay', (req, res) => {
  const { event, transaction_id, reference, status } = req.body;
  
  if (event === 'DEPOSIT') {
    if (status === 'SUCCESS') {
      // Payment completed – fulfill order, update DB
    } else if (status === 'FAILED' || status === 'CANCELLED') {
      // Handle failure or cancellation
    }
  } else if (event === 'WITHDRAWAL') {
    // Handle withdrawal status updates
  }
  
  res.status(200).send('OK');
});

Webhook Events

DEPOSIT
Triggered when a payment is received or its status changes
WITHDRAWAL
Triggered when a withdrawal is processed or its status changes
Status values
SUCCESS, FAILED, PENDING, CANCELLED — verify RSA-2048 signature (see docs)