Payd Node SDKPayments across Africa, simplified.

Collect via M-Pesa, cards, and mobile money. Send payouts to 23+ countries. All from a single, type-safe Node.js SDK.

Get Started

API Reference

View on GitHub

📱

M-Pesa STK Push

Trigger M-Pesa STK push prompts on customer phones. Collect payments in Kenya with a single method call.

💳

Card Payments

Accept Visa and Mastercard via hosted checkout. Get a secure URL and redirect your customer — done.

🌍

Pan-African Coverage

Collect and send money across 23+ African countries via mobile money and bank transfer. Nigeria, Uganda, Ghana, Tanzania, South Africa, and more.

💸

Payouts & Transfers

Send money to M-Pesa users, bank accounts, Paybill/Till merchants, or other Payd accounts instantly.

🔧

Type-Safe & Zero Dependencies

Full TypeScript types for every request and response. Zero runtime dependencies — just the Node.js runtime.

🛡️

Built-in Validation

Client-side validation catches bad phone numbers, out-of-range amounts, and missing fields before the request leaves your server.

Quick Example

typescript

import { PaydClient } from "payd-node-sdk";

const payd = new PaydClient({
  apiUsername: process.env.PAYD_API_USERNAME!,
  apiPassword: process.env.PAYD_API_PASSWORD!,
});

// Collect KES 500 via M-Pesa
const result = await payd.collections.mpesa({
  username: "my_payd_user",
  amount: 500,
  phoneNumber: "0700000000",
  narration: "Order #1234",
  callbackUrl: "https://my-server.com/webhook",
});

console.log(result.transactionReference); // "9BD103350408eR"

Supported Countries

Region	Countries
East Africa	Kenya, Uganda, Tanzania, Rwanda, Ethiopia
West Africa	Nigeria, Ghana, Senegal, Cameroon, Ivory Coast, Benin, Guinea, Mali, Burkina Faso, Togo, Niger
Southern Africa	South Africa, Zambia, Malawi, Mozambique
Central Africa	DRC, Congo Republic