M-Pesa SDKs and libraries for paylod

npm install @paylod/node

# Nothing to install — any HTTP client works.
export PAYLOD_API_KEY=mp_test_YOUR_API_KEY

The PHP SDK is not on Packagist yet, so there is no composer command to run.
Call the HTTP API directly in the meantime — switch to the cURL tab.

The Python SDK is not on PyPI yet, so there is no pip command to run.
Call the HTTP API directly in the meantime — switch to the cURL tab.

The Java SDK is not on Maven Central yet, so there is no coordinate to depend on.
Call the HTTP API directly in the meantime — switch to the cURL tab.

The Kotlin SDK is not on Maven Central yet, so there is no coordinate to depend on.
Call the HTTP API directly in the meantime — switch to the cURL tab.

import { Paylod } from "@paylod/node";

export const paylod = new Paylod(process.env.PAYLOD_API_KEY!);

# The "client" is a bearer token on every request.
export PAYLOD_API_KEY=mp_test_YOUR_API_KEY

use Paylod\Paylod;

$paylod = new Paylod(getenv('PAYLOD_API_KEY'));

import os
from paylod import Paylod

paylod = Paylod(os.environ["PAYLOD_API_KEY"])

import dev.paylod.Paylod;

Paylod paylod = new Paylod(System.getenv("PAYLOD_API_KEY"));

import dev.paylod.Paylod

val paylod = Paylod(System.getenv("PAYLOD_API_KEY"))

const outcome = await paylod.collectAndWait({
  amount: 100,
  phone: "0712345678",
  idempotencyKey: attempt.id,   // one key per payment attempt — a double-click cannot charge twice
});

if (outcome.paid) fulfil(outcome.receipt);
else console.log(outcome.message);

curl -X POST https://paylod.dev/functions/v1/collect \
  -H "Authorization: Bearer mp_test_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: att_9f2c1b40" \
  -d '{ "amount": 100, "phone": "254712345678" }'
# → 202 { "paymentId": "...", "status": "pending" } — then poll GET /status/:id

$outcome = $paylod->collectAndWait([
    'amount' => 100,
    'phone' => '0712345678',
    'idempotencyKey' => $attempt->id,   // one key per payment attempt
]);

if ($outcome->paid) {
    fulfil($outcome->receipt);
} else {
    echo $outcome->message;
}

outcome = paylod.collect_and_wait(
    amount=100,
    phone="0712345678",
    idempotency_key=attempt.id,   # one key per payment attempt
)

if outcome.paid:
    fulfil(outcome.receipt)
else:
    print(outcome.message)

PaymentOutcome outcome = paylod.collectAndWait(
    CollectParams.builder("0712345678", 100)
        .idempotencyKey(attempt.id())   // one key per payment attempt
        .build());

if (outcome.isPaid()) {
    fulfil(outcome.getReceipt());
} else {
    System.out.println(outcome.getMessage());
}

val outcome = paylod.collectAndWait(
    amount = 100,
    phone = "0712345678",
    idempotencyKey = attempt.id,   // one key per payment attempt
)

if (outcome.paid) fulfil(outcome.receipt)
else println(outcome.message)

const outcome = await paylod.check(paymentId);
outcome.status;   // "pending" | "succeeded" | "cancelled" | "failed"
outcome.message;  // renderable, already decoded

curl https://paylod.dev/functions/v1/status/e69e5c00-8a01-44ed-b003-48e2e86a7c9e \
  -H "Authorization: Bearer mp_live_YOUR_API_KEY"
# → 200 { "id": "...", "status": "success", "mpesaReceipt": "UG1F3A1U7J", ... }

$outcome = $paylod->check($paymentId);
$outcome->status;   // "pending" | "succeeded" | "cancelled" | "failed"
$outcome->message;  // renderable, already decoded

outcome = paylod.check(payment_id)
outcome.status   # "pending" | "succeeded" | "cancelled" | "failed"
outcome.message  # renderable, already decoded

PaymentOutcome outcome = paylod.check(paymentId);
outcome.getStatus();   // "pending" | "succeeded" | "cancelled" | "failed"
outcome.getMessage();  // renderable, already decoded

val outcome = paylod.check(paymentId)
outcome.status    // "pending" | "succeeded" | "cancelled" | "failed"
outcome.message   // renderable, already decoded

const event = paylod.verifyWebhook({
  payload: rawBody,
  signature: headers["x-webhook-signature"],
  secret: process.env.PAYLOD_WEBHOOK_SECRET,
});

$event = $paylod->verifyWebhook(
    payload: $rawBody,
    signature: $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'],
    secret: getenv('PAYLOD_WEBHOOK_SECRET'),
);

event = paylod.verify_webhook(
    payload=raw_body,
    signature=request.headers["x-webhook-signature"],
    secret=os.environ["PAYLOD_WEBHOOK_SECRET"],
)

WebhookEvent event = paylod.verifyWebhook(
    rawBody,
    request.getHeader("x-webhook-signature"),
    System.getenv("PAYLOD_WEBHOOK_SECRET"));

val event = paylod.verifyWebhook(
    payload = rawBody,
    signature = request.header("x-webhook-signature"),
    secret = System.getenv("PAYLOD_WEBHOOK_SECRET"),
)

const err = paylod.decodeError(1032);
// err.title, err.cause, err.fix, err.category, err.retryable, err.customerMessage

$err = $paylod->decodeError(1032);
// $err->title, $err->cause, $err->fix, $err->category, $err->retryable, $err->customerMessage

err = paylod.decode_error(1032)
# err.title, err.cause, err.fix, err.category, err.retryable, err.customer_message

DecodedError err = paylod.decodeError(1032);
// err.getTitle(), err.getCause(), err.getFix(), err.getCategory(), err.isRetryable(), err.getCustomerMessage()

val err = paylod.decodeError(1032)
// err.title, err.cause, err.fix, err.category, err.retryable, err.customerMessage